API documentation with executable examples

The rise of component-based software development has created an urgent need for effective application program interface (API) documentation. Experience has shown that it is hard to create precise and readable documentation. Prose documentation can provide a good overview but lacks precision. Formal methods offer precision but the resulting documentation is expensive to develop. Worse, few developers have the skill or inclination to read formal documentation. We present a pragmatic solution to the problem of API documentation. We augment the prose documentation with executable test cases, including expected outputs, and use the prose plus the test cases as the documentation. With appropriate tool support, the test cases are easy to develop and read. Such test cases constitute a completely formal, albeit partial, specification of input/output behavior. Equally important, consistency between code and documentation is demonstrated by running the test cases. This approach provides an attractive bridge between formal and informal documentation. We also present a tool that supports compact and readable test cases; and generation of test drivers and documentation, and illustrate the approach with detailed case studies. (C) 2002 Elsevier Science Inc. All rights reserved.

Local colours for Indonesian National police

As a result of the local autonomy program that commenced in Indonesia in Jan 2001, there is a concern regarding the applicability of the formalized model of security & the possibility of that being replaced by a local community-based security model. This rather informal security model is then promoted to be the only form of security used between societies & the nation. However, this model does not solve the problem because of widespread corruption, collusion, & nepotism, & the many limitations of the Indonesian National Police (Polri), a police department that has a mediocre & generalized level of service. In relation to autonomy, the effort of empowering the police units from the regional police down will bridge the gap between the people's ability to protect themselves & the limitations of those that are sworn to uphold the law. 17 References. Adapted from the source document.

A class B switch-mode assisted linear amplifier

A switch-mode assisted linear amplifier (SMALA) combining a linear (Class B) and a switch-mode (Class D) amplifier is presented. The usual single hysteretic controlled half-bridge current dumping stage is replaced by two parallel buck converter stages, in a parallel voltage controlled topology. These operate independently: one buck converter sources current to assist the upper Class B output device, and a complementary converter sinks current to assist the lower device. This topology lends itself to a novel control approach of a dead-band at low power levels where neither class D amplifier assists, allowing the class B amplifier to supply the load without interference, ensuring high fidelity. A 20 W implementation demonstrates 85% efficiency, with distortion below 0.08% measured across the full audio bandwidth at 15 W. The class D amplifier begins assisting at 2 W, and below this value, the distortion was below 0.03%. Complete circuitry is given, showing the simplicity of the additional class D amplifier and its corresponding control circuitry.

Prevalência e fatores associados à infecção pelo M. tuberculosis entre agentes comunitários de saúde

Introdução: A tuberculose é uma doença milenar e que, ainda hoje, constitui grave problema de saúde pública em todo o mundo. Objetivo: Estimar a prevalência e os fatores associados à infecção latente pelo MTB entre Agentes Comunitários de Saúde atuantes na rede básica de saúde de Municípios prioritários para o controle de TB – Cuiabá/MT, Manaus/AM, Salvador/BA e Vitória/ES. Métodos: Estudo de corte transversal no qual os dados foram coletados através de questionário, composto de questões abertas e fechadas sobre características pessoais; informações a respeito da tuberculose; utilização de medidas preventivas, etc. Aplicou-se prova tuberculínica, com leitura após 48-72h por enfermeiros treinados, considerando como ponte de corte positivo 5 e 10 mm de enduração. A análise múltipla foi feita por meio de regressão logística hierarquica. Foram incluídas no modelo as variáveis que mostraram associação com desfecho com p<0,1. Permaneceram no modelo as variáveis independentes que mantiveram associação com desfecho após ajuste (p<0,05). Este estudo obteve aprovação do Comitê de Ética em Pesquisa com seres humanos do Centro de Ciências da Saúde da Universidade Federal do Espírito Santo, n° de registro CEP-07/2010 e das Secretarias Municipais de Saúde, por meio de uma Carta de Apresentação. Resultados: 322 Agentes Comunitários de Saúde (ACS) aceitaram participar voluntariamente do estudo por meio da assinatura do Termo de Consentimento Livre e Esclarecido. Destes, 10 não compareceram para leitura, sendo estes considerados como perdas, além do que um indivíduo foi excluído pelo fato do teste rápido para HIV ter resultado positivo, perfazendo uma amostra final de 311 participantes. Ainda em relação aos ACS triados, a positividade a Prova Tuberculínica, levando-se em consideração o ponto de corte ao teste de 10 mm e de 5 mm de enduração, foi de 37,30% (IC95%: 0,31-0,42) e de 57,88% (IC95%: 0,52-0,63), respectivamente.Conclusões: Faz-se necessário um programa de realização de Prova Tuberculínica, de rotina, combinado com intervenções para reduzir o risco de transmissão nosocomial, bem como a realização de outros estudos para avaliar a eficácia de novos testes para detecção de tuberculose latente.

Macau in China's relations with the lusophone world

After the transfer of the Portuguese administration to China, Macau kept its role as a bridge between East and West, inspired in the Portuguese settlement 500 years ago. The pragmatism of the Chinese central government, using the Lusophone specificities of this Special Administrative Region, supported the creation of the Forum for Economic and Trade Cooperation between China and the Portuguese-speaking Countries, reviving the statute of the Portuguese language and culture in its own territory.

Motivação e percepção do envolvimento parental na prática desportiva de jovens nadadores

RESUMO: O envolvimento parental no desporto é determinante no processo de formação desportiva dos jovens desportistas. Pelo facto de existirem poucos instrumentos de avaliação neste assunto, a adaptação e validação do Parental Involvement Sport Questionnaire (PISQ) para o idioma Português, tornou-se fundamental para colmatar esta lacuna. Assim, o presente estudo pretende alcançar dois objectivos principais: a) traduzir e adaptar o PISQ ao idioma Português do Brasil e, deste modo, iniciar o processo de validação do referido instrumento; b) analisar a relação entre a percepção dos jovens sobre o envolvimento parental na sua prática de natação e a motivação destes jovens nadadores. Um total de 114 nadadores participaram deste estudo, com idades compreendidas entre os 12 e 20 anos [ M = 14.67; DP = 8.29], para aferir utilizamos a versão Portuguesa do PISQ e do Sport Motivation Scale (SMS). Como principais resultados, a versão portuguesa do PISQ apresentou um Alpha de Cronbach deos comportamentos directivos dos pais mostraram reduzir a motivação intrínsica – saber, a motivação intrínsica pela prática e a motivação extrínsica – introjectada, e aumentar a amotivação dos jovens desportistas. ABSTRACT: The parental involvement in sport is crucial in the process of sports training of young athletes and, because there are few instruments for assessing this issue, the adaptation and validation of the Parental Involvement Sport Questionnaire (PISQ) for the Portuguese language, it became essential to bridge this gap. Thus, this study aims to achieve two main objectives: a) translate and adapt the PISQ to the Portuguese language of Brazil and thus begin the process of validation of that instrument, b) analyze the relationship between the perception of young people about the involvement parental in their practice of swimming, and the motivation of these young swimmers. A total of 114 swimmers participated in this study, aged between 12 and 20 years [M = 14.67, SD = 8.29], we used to measure the Portuguese version of PISQ and the Sport Motivation Scale (SMS). As main results, the Portuguese version of PISQ showed a Cronbach’s Alpha of , directive behaviors of the parents shown to reduce intrinsic and extrinsic motivation, and increase the amotivation of the young athletes.

Repetitive Solid State Pulse Modulator Based on a DC Voltage Multiplier

A newly developed solid-state repetitive high-voltage (HV) pulse modulator topology created from the mature concept of the d.c. voltage multiplier (VM) is described. The proposed circuit is based in a voltage multiplier type circuit, where a number of d.c. capacitors share a common connection with different voltage rating in each one. Hence, besides the standard VM rectifier and coupling diodes, two solid-state on/off switches are used, in each stage, to switch from the typical charging VM mode to a pulse mode with the d.c. capacitors connected in series with the load. Due to the on/off semiconductor configuration, in half-bridge structures, the maximum voltage blocked by each one is the d.c. capacitor voltage in each stage. A 2 kV prototype is described and the results are compared with PSPICE simulations.

Projecto de execução de fundações e estruturas de uma ponte em betão armado pré-esforçado

Este Trabalho refere-se ao Projecto de Execução de Fundações e Estruturas de uma Ponte Rodoviária em betão armado pré-esforçado, realizado no âmbito do Trabalho Final de Mestrado em Engenharia Civil – Especialização em Estruturas, do Instituto Superior de Engenharia de Lisboa. O Projecto de Execução é composto de Peças Escritas e Peças Desenhadas. Nas Peças Escritas estão incluídos: Memória Justificativa e Descritiva; Cálculos Justificativos e Anexos. A ponte é composta por dois tabuleiros paralelos com 10,28m de largura cada um e afastados entre si de 0,10m. A obra é constituída de 8 tramos; os tramos correntes com 31m de comprimento e os tramos extremos com 25 e 20m de comprimento, perfazendo um comprimento total de 231m. A obra foi parcialmente isolada dos sismos pela introdução, em todos os pilares, de aparelhos de apoio de elevado amortecimento sísmico do tipo HDRB (High Damping Rubber Bearings). Encontram-se particularmente discriminadas e detalhadas neste projecto as seguintes situações: - Cálculo do Pré-esforço e respectivas perdas; - Acção das sobrecargas rodoviárias; - Diferença de comportamento da obra na entrada em serviço e no longo prazo; - Análise sísmica e do isolamento sísmico; - Estudo dos efeitos diferidos: retracção e fluência. Tendo as abordagens de cálculo e as verificações de segurança seguido a regulamentação nacional em vigor, nomeadamente RSA e REBAP, foi no entanto feita uma aproximação às regras do “Capacity Design” previstas no EC8, em que se privilegia a actuação do projectista sobre o comportamento da estrutura, procurando uma resposta não linear da mesma, visando garantir que: - A rotura não ocorrerá nos elementos de fundação; - Nos pilares a dissipação de energia se faz através de rótulas plásticas, evitando-se roturas associadas a esforços transversos. A aplicação destas regras neste Projecto demonstrou haver um agravamento substancial na definição dos esforços a que devem resistir alguns dos componentes da estrutura, designadamente os pilares e as fundações, originando soluções de secções de betão e armaduras bem mais exigentes do que aqueles que resultariam da simples verificação de segurança, pela comparação entre esforços actuante e esforços resistentes “secção a secção”, imposta pela actual regulamentação nacional.

Dimensionamento de um passadiço pedonal em estrutura metálica, com fundações em betão armado

A elaboração deste projecto, integrado no âmbito do Trabalho Final de Mestrado, para a obtenção do grau de Mestre em Engenharia Civil, tem como objectivo o dimensionamento de um passadiço pedonal em estrutura metálica, com fundações em betão armado. Este documento inclui quase todos os elementos necessários ao projecto de execução da referida estrutura. Para o dimensionamento do passadiço pedonal procedeu-se à quantificação das acções e posteriormente à verificação da segurança de todos os elementos estruturais tendo por base os critérios e especificações técnicas preconizados nas Normas Europeias relativas ao projecto estrutural (Eurocódigos estruturais). Tratando-se de um passadiço destinado à circulação de peões e cuja estrutura metálica apresenta um certo grau de flexibilidade devido à esbelteza dos elementos estruturais, esta poderá estar sujeita a acções dinâmicas periódicas provocadas pelas pessoas quando percorrem o passadiço, podendo ocasionar certos níveis de vibração que sob o ponto de vista de segurança estrutural serão pouco relevantes, sendo no entanto excessivos do ponto de vista do conforto humano. Foi por isso efectuado um estudo dinâmico, com o objectivo de caracterizar a resposta dinâmica da estrutura quando solicitada a carregamentos de natureza periódica como é o caso da acção do peão, de modo a garantir que a utilização desta estrutura esteja dentro dos parâmetros de conforto aceitáveis. A modelação da estrutura e consequente discretização geral desta, foi feita recorrendo a programa de elementos finitos, SAP2000, versão 14.0.0. O dimensionamento das ligações constitui outros dos aspectos fundamentais no projecto desta estrutura metálica.

Projecto e implementação de um sistema de alimentação para um transformador de alta tensão

Neste trabalho pretende-se estudar, dimensionar e implementar experimentalmente de um sistema de alimentação para transformadores de alta tensão a alta frequência. Este sistema será constituído por dois elementos principais, um rectificador monofásico em ponte totalmente controlado e por um inversor de tensão. Inicialmente realizou-se um estudo sobre as diferentes topologias possíveis para o rectificador considerando diferentes tipos de carga. Realizou-se, também, um estudo sobre o circuito de geração dos impulsos de disparo dos tiristores, executado com base num circuito integrado TCA 785, dimensionou-se os elementos constituintes do circuito de disparo, e de um sistema de controlo da tensão de saída do rectificador. Posteriormente estudou-se o funcionamento do inversor de tensão, definindo-se os modos de operação e dimensionou-se um circuito ressonante tendo em conta os parâmetros construtivos do transformador que se pretende utilizar. Finalmente procedeu-se à implementação prática dos sistemas previamente dimensionados e simulados e à apresentação dos respectivos resultados.

Medição de parâmetros de componentes passivos RLC em ambiente LabVIEW pelo método da desmodulação síncrona ou coerente

A presente dissertação apresenta o desenvolvimento de um medidor de componentes passivos RLC. Este medidor baseia-se num protótipo desenvolvido para possibilitar a medição da impedância de um dispositivo em teste. Tendo uma carta de aquisição de sinal como interface, o protótipo comunica com um computador que controla todo o processo de medição desde a aquisição e processamento de sinais ao cálculo e visualização dos parâmetros. A topologia de medição implementada é a da ponte auto-balanceada e no processamento recorre-se ao método da desmodulação síncrona ou coerente. A sua viabilidade é suportada por um estudo teórico prévio, pela discussão das opções tomadas no projecto e pelos resultados obtidos através do algoritmo desenvolvido utilizando o software LabVIEW de programação gráfica.

Concessão Douro Litoral A32/IC2: passagens inferiores pré-fabricadas no sistema arco "Techspan" e muros ala de suporte de terras no sistema "Terra Armada": ponte sobre o rio Antuã: aplicação da tecnologia "Freyssinet"

O presente relatório visa apresentar o trabalho desenvolvido pelo estagiário na empresa Freyssinet – Terra Armada, S.A. (FTA). O relatório traduz o acompanhamento do estagiário na construção e aplicação da tecnologia Terra Armada em duas passagens inferiores, bem como o acompanhamento dos trabalhos efectuados pela empresa FTA no que diz respeito à aplicação da tecnologia Freyssinet na ponte sobre o rio Antuã, estando ambas as obras abordadas inseridas no Lote 8 – “A32/IC2 Oliveira de Azeméis/IP1 (S. Lourenço) trecho 2 e 3 – a cargo da empresa Alves Ribeiro S.A.. Com a construção dos trechos 2 e 3 da A32 surgiu a necessidade de se restabelecerem algumas ligações, o que fez com que após estudadas as soluções passíveis de serem utilizadas, se tivesse optado pela construção de túneis a céu aberto na execução dos restabelecimentos. Descreve-se neste documento a metodologia utilizada e as tecnologias patenteadas pela empresa Terra Armada, sendo estas compostas pelos Arcos “Techspan” e muros de ala executados com recurso à tecnologia “Terra Armada”. Em relação à ponte sobre o rio Antuã inserida no trecho 2 da empreitada de construção da A32, foi construída com recurso a cimbre auto-lançável e betonada in situ, havendo a necessidade de aplicação de tecnologias patenteadas pela Freyssinet no que diz respeito às actividades de pré-esforço, aparelhos de apoio nas ligações entre o tabuleiro e os pilares e juntas de dilatação na ligação do tabuleiro aos encontros. Apresentam-se os procedimentos de montagem e aplicação das tecnologias anteriormente referidas. No presente relatório estão descritos e explicados detalhadamente os trabalhos executados pela FTA, nomeadamente a aplicação da tecnologia “Terra Armada” no que diz respeito à construção das passagens inferiores, e a aplicação da tecnologia “Freyssinet” aplicada aquando da construção da ponte sobre o rio Antuã.

Projecto de execução da passagem superior 9A, na concessão Douro Litoral na A32/IC2 - Oliveira de Azeméis/IP1 (S. Lourenço)

O presente trabalho teve como principal objectivo a aplicação dos conceitos adquiridos nas unidades curriculares da licenciatura e do mestrado. Nesse sentido tomou-se a opção da realização de um projecto de execução de uma obra de arte para o trabalho final de mestrado, realizado num conceituado gabinete de projecto de pontes e viadutos, com vista à obtenção do grau de mestre. O projecto refere-se a uma obra de arte que se insere num nó rodoviário de ligação entre duas auto-estradas que, dados os seus condicionamentos de perfil, quer longitudinal quer transversal, e implantação no local, pode ser considerada uma obra de arte especial. O processo de análise foi feito com recurso ao programa de cálculo automático SAP2000®, tendo em conta os regulamentos nacionais aplicáveis a estruturas de pontes e os Eurocódigos em fase de implementação em Portugal. O projecto de execução, objecto deste trabalho, foi realizado em função de uma metodologia de construção simples, que é o recurso à utilização, por fases, de cimbres apoiados no solo. A optimização das fases de construção é um factor condicionante na análise e concepção da obra de arte deste projecto, pelo que se procura obter uma relação optimizada entre o rendimento de construção e o funcionamento estrutural da obra de arte, de forma a garantir a segurança da estrutura e o conforto dos utilizadores a longo prazo.

Análise comparativa dos modelos regulamentares de previsão da retracção do betão

A adequada previsão do comportamento diferido do betão, designadamente da retracção, é essencial no projecto de uma obra de grandes dimensões, permitindo conceber, dimensionar e adoptar as disposições construtivas para um comportamento estrutural que satisfaça os requisitos de segurança, utilização e durabilidade. O actual momento é marcado por uma transição em termos da regulamentação de estruturas, com a eminente substituição da regulamentação nacional por regulamentação europeia. No caso das estruturas de betão, o Regulamento de Estruturas de Betão Armado e Pré-Esforçado (REBAP), em vigor desde 1983, será substituído pelo Eurocódigo 2. Paralelamente, a Federation International du Betón publicou o Model Code 2010 (MC2010), um documento que certamente terá forte influência na evolução da regulamentação das estruturas de betão. Neste contexto, o presente trabalho tem como objectivo estabelecer uma comparação entre os diferentes modelos de previsão da retracção incluídos nos documentos normativos referidos, identificando as principais diferenças e semelhanças entre eles e quantificando a influência dos diferentes factores considerados na sua formulação, de forma a avaliar o impacto que a introdução destes modelos de previsão irá ter no projecto de estruturas de betão. Com o propósito de aferir a forma como estes modelos reflectem a realidade do fenómeno em estudo, procedeu-se à aplicação destes modelos de previsão ao betão de duas obras cujo comportamento estrutural é observado pelo LNEC, concretamente a ponte Miguel Torga, sobre o rio Douro, na Régua, e a ponte sobre o rio Angueira, no distrito de Bragança. Em ambas as obras tinha sido efectuada a caracterização in situ da retracção, tendo-se comparado os valores experimentais assim obtidos com os valores provenientes da aplicação dos modelos de previsão considerados neste trabalho. Finalmente são apresentadas algumas conclusões obtidas com o trabalho desenvolvido nesta dissertação, bem como algumas sugestões para desenvolvimentos futuros.

Power Electronics Didactic Modules for Direct Current Machine Control

Several didactic modules for an electric machinery laboratory are presented. The modules are dedicated for DC machinery control and get their characteristic curves. The didactic modules have a front panel with power and signal connectors and can be configurable for any DC motor type. The three-phase bridge inverter proposed is one of the most popular topologies and is commercially available in power package modules. The control techniques and power drives were designed to satisfy static and dynamic performance of DC machines. Each power section is internally self-protected against misconnections and short-circuits. Isolated output signals of current and voltage measurements are also provided, adding versatility for use either in didactic or research applications. The implementation of such modules allowed experimental confirmation of the expected performance.