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.

A comparison of the cycling performance of cyclists and triathletes

The aim of this study was to compare the cycling performance of cyclists and triathletes. Each week for 3 weeks, and on different days, 25 highly trained male cyclists and 18 highly trained male triathletes performed: (1) an incremental exercise test on a cycle ergometer for the determination of peak oxygen consumption ((V) over dot O-2peak), peak power output and the first and second ventilatory thresholds, followed 15 min later by a sprint to volitional fatigue at 150% of peak power output; (2) a cycle to exhaustion test at the (V) over dot O-2peak power output; and (3) a 40-km cycle time-trial. There were no differences in (V) over dot O-2peak, peak power output, time to volitional fatigue at 150% of peak power output or time to exhaustion at (V) over dot O-2peak power output between the two groups. However, the cyclists had a significantly faster time to complete the 40-km time-trial (56:18 +/- 2:31 min:s; mean +/- s) than the triathletes (58:57 +/- 3:06 min:s; P < 0.01), which could be partially explained (r = 0.34-0.51; P < 0.05) by a significantly higher first (3.32 +/- 0.36 vs 3.08 +/- 0.36 l . min(-1)) and second ventilatory threshold (4.05 +/- 0.36 vs 3.81 +/- 0.29 l . min(-1); both P < 0.05) in the cyclists compared with the triathletes. In conclusion, cyclists may be able to perform better than triathletes in cycling time-trial events because they have higher first and second ventilatory thresholds.

Reproducibility of a laboratory-based 40-km cycle time-trial on a stationary wind-trainer in highly trained cyclists

The purpose of the present study was to examine the reproducibility of laboratory-based 40-km cycle time-trial performance on a stationary wind-trainer. Each week, for three consecutive weeks, and on different days, forty-three highly trained male cyclists ((x) over bar +/- SD; age = 25 +/- 6 y; mass = 75 +/- 7 kg; peak oxygen uptake [(V) over dot O-2 peak] = 64.8 +/- 5.2 ml x kg(-1) x min(-1)) performed: 1) a (V) over dot O-2 peak test, and 2) a 40-km time-trial on their own racing bicycle mounted to a stationary wind-trainer (Cateye - Cyclosimulator). Data from all tests were compared using a one-way analysis of variance. Performance on the second and third 40-km time-trials were highly related (r = 0.96; p < 0.001), not significantly different (57:21 +/- 2:57 vs. 57:12 +/- 3:14 min:s), and displayed a low coefficient of variation (CV) = 0.9 +/- 0.7%. Although the first 40-km time-trial (58:43 +/- 3:17min:s) was not significantly different from the second and third tests (p = 0.06), inclusion of the first test in the assessment of reliability increased within-subject CV to 3.0 +/- 2.9%. 40-km time-trial speed (km x h(-1)) was significantly (p < 0.001) related to peak power output (W; r = 0.75), (V) over dot O-2 peak (1 x min(-1); r = 0.53), and the second ventilatory turnpoint (1 x min(-1); r = 0.68) measured during the progressive exercise tests. These data demonstrate that the assessment of 40-km cycle time-trial performance in well-trained endurance cyclists on a stationary wind-trainer is reproducible, provided the athletes perform a familiarization trial.

Physiological responses to repeated bouts of high-intensity ultraendurance cycling - a field study case report

The present study aimed to 1) examine the relationship between laboratory-based measures and high-intensity ultraendurance (HIU) performance during an intermittent 24-h relay ultraendurance mountain bike race (similar to20 min cycling, similar to60min recovery), and 2) examine physiological and performance based changes throughout the HIU event. Prior to the HIU event, four highly-trained male cyclists (age = 24.0 +/- 2.1 yr; mass = 75.0 +/- 2.7 kg; (V)over dot O-2peak = 70 +/- 3 ml.kg(-1).min(-1)) performed 1) a progressive exercise test to determine peak Volume of oxygen uptake ((V)over dot O-2peak), peak power output (PPO), and ventilatory threshold (T-vent), 2) time-to-fatigue tests at 100% (TF100) and 150% of PPO (TF150), and 3) a laboratory simulated 40-km time trial (TT40). Blood lactate (Lac(-)), haematocrit and haemoglobin were measured at 6-h intervals throughout the HIU event, while heart rate (HR) was recorded continuously. Intermittent HIU performance, performance HR, recovery HR, and Lac declined (P < 0.05), while plasma volume expanded (P < 0.05) during the HIU event. TF100 was related to the decline in lap time (r = -0.96; P < 0.05), and a trend (P = 0.081) was found between TF150 and average intermittent HIU speed (r = 0.92). However, other measures (V)over dot O-2peak, PPO, T-vent, and TT40) were not related to HIU performance. Measures of high-intensity endurance performance (TF100, TF150) were better predictors of intermittent HIU performance than traditional laboratory-based measures of aerobic capacity.

Reliability of electromyographic and torque measures during isometric axial rotation exertions of the trunk

Objective: The aim of the present study was to investigate the between-days reliability of electromyographic (EMG) measurement of 6 bilateral trunk muscles and also the torque output in 3 planes during isometric right and left axial rotation at different exertion levels. Methods: Ten healthy subjects performed isometric right and left axial rotation at 100, 70, 50 and 30% maximum voluntary contractions in two testing sessions at least 7 days apart. EMG amplitude and frequency analyses of the recorded surface EMG signals were performed for rectus abdominis, external oblique, internal oblique, latissimus dorsi, iliocostalis lumborum and multifidus bilaterally. The primary torque in the transverse plane and the coupling torques in sagittal and coronal planes were measured. Results: For both EMG amplitude and frequency values, good (intraclass correlation coefficient, ICC = 0.75-0.89) to excellent (ICC greater than or equal to 0.90) reliability was found in the 6 trunk muscles at different exertion levels during axial rotation. The reliability of both maximal isometric axial rotation torque and coupling torques in sagittal and coronal planes were found to be excellent (ICC greater than or equal to 0.93). Conclusions: Good to excellent reliability of EMG measures of trunk muscles and torque measurements during isometric axial rotation was demonstrated. This provides further confidence of using EMG and triaxial torque assessment as outcome measures in rehabilitation and in the evaluation of the human performance in the work place. (C) 2003 International Federation of Clinical Neurophysiology. Published by Elsevier Ireland Ltd. All rights reserved.

An approach to verifying and debugging simulation models governed by ordinary differential equations: Part 1. Methodology for residual generation

For dynamic simulations to be credible, verification of the computer code must be an integral part of the modelling process. This two-part paper describes a novel approach to verification through program testing and debugging. In Part 1, a methodology is presented for detecting and isolating coding errors using back-to-back testing. Residuals are generated by comparing the output of two independent implementations, in response to identical inputs. The key feature of the methodology is that a specially modified observer is created using one of the implementations, so as to impose an error-dependent structure on these residuals. Each error can be associated with a fixed and known subspace, permitting errors to be isolated to specific equations in the code. It is shown that the geometric properties extend to multiple errors in either one of the two implementations. Copyright (C) 2003 John Wiley Sons, Ltd.

SPAnDX: a process-based population dynamics model to explore management and climate change impacts on an invasive alien plant, Acacia nilotica

This paper describes a process-based metapopulation dynamics and phenology model of prickly acacia, Acacia nilotica, an invasive alien species in Australia. The model, SPAnDX, describes the interactions between riparian and upland sub-populations of A. nilotica within livestock paddocks, including the effects of extrinsic factors such as temperature, soil moisture availability and atmospheric concentrations of carbon dioxide. The model includes the effects of management events such as changing the livestock species or stocking rate, applying fire, and herbicide application. The predicted population behaviour of A. nilotica was sensitive to climate. Using 35 years daily weather datasets for five representative sites spanning the range of conditions that A. nilotica is found in Australia, the model predicted biomass levels that closely accord with expected values at each site. SPAnDX can be used as a decision-support tool in integrated weed management, and to explore the sensitivity of cultural management practices to climate change throughout the range of A. nilotica. The cohort-based DYMEX modelling package used to build and run SPAnDX provided several advantages over more traditional population modelling approaches (e.g. an appropriate specific formalism (discrete time, cohort-based, process-oriented), user-friendly graphical environment, extensible library of reusable components, and useful and flexible input/output support framework). (C) 2003 Published by Elsevier Science B.V.

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.

Quantum theory of the far-off-resonance continuous-wave Raman laser: Heisenberg-Langevin approach

We present the quantum theory of the far-off-resonance continuous-wave Raman laser using the Heisenberg-Langevin approach. We show that the simplified quantum Langevin equations for this system are mathematically identical to those of the nondegenerate optical parametric oscillator in the time domain with the following associations: pump pump, Stokes signal, and Raman coherence idler. We derive analytical results for both the steady-state behavior and the time-dependent noise spectra, using standard linearization procedures. In the semiclassical limit, these results match with previous purely semiclassical treatments, which yield excellent agreement with experimental observations. The analytical time-dependent results predict perfect photon statistics conversion from the pump to the Stokes and nonclassical behavior under certain operational conditions.

Tailoring teleportation to the quantum alphabet

We introduce a refinement of the standard continuous variable teleportation measurement and displacement strategies. This refinement makes use of prior knowledge about the target state and the partial information carried by the classical channel when entanglement is nonmaximal. This gives an improvement in the output quality of the protocol. The strategies we introduce could be used in current continuous variable teleportation experiments.

Effects of mercury on the arterial blood pressure of anesthetized rats

The available data suggests that hypotension caused by Hg2+ administration may be produced by a reduction of cardiac contractility or by cholinergic mechanisms. The hemodynamic effects of an intravenous injection of HgCl2 (5 mg/kg) were studied in anesthetized rats (N = 12) by monitoring left and right ventricular (LV and RV) systolic and diastolic pressures for 120 min. After HgCl2 administration the LV systolic pressure decreased only after 40 min (99 ± 3.3 to 85 ± 8.8 mmHg at 80 min). However, RV systolic pressure increased, initially slowly but faster after 30 min (25 ± 1.8 to 42 ± 1.6 mmHg at 80 min). Both right and left diastolic pressures increased after HgCl2 treatment, suggesting the development of diastolic ventricular dysfunction. Since HgCl2 could be increasing pulmonary vascular resistance, isolated lungs (N = 10) were perfused for 80 min with Krebs solution (continuous flow of 10 ml/min) containing or not 5 µM HgCl2. A continuous increase in pulmonary vascular resistance was observed, suggesting the direct effect of Hg2+ on the pulmonary vessels (12 ± 0.4 to 29 ± 3.2 mmHg at 30 min). To examine the interactions of Hg2+ and changes in cholinergic activity we analyzed the effects of acetylcholine (Ach) on mean arterial blood pressure (ABP) in anesthetized rats (N = 9) before and after Hg2+ treatment (5 mg/kg). Using the same amount and route used to study the hemodynamic effects we also examined the effects of Hg2+ administration on heart and plasma cholinesterase activity (N = 10). The in vivo hypotensive response to Ach (0.035 to 10.5 µg) was reduced after Hg2+ treatment. Cholinesterase activity (µM h-1 mg protein-1) increased in heart and plasma (32 and 65%, respectively) after Hg2+ treatment. In conclusion, the reduction in ABP produced by Hg2+ is not dependent on a putative increase in cholinergic activity. HgCl2 mainly affects cardiac function. The increased pulmonary vascular resistance and cardiac failure due to diastolic dysfunction of both ventricles are factors that might contribute to the reduction of cardiac output and the fall in arterial pressure.

Dos clássicos aos hereges : Keynes e a economia de seu tempo

O artigo trata da posição teórica de Keynes relativamente à economia clássica e à abordagem denominada herética. A primeira seção resgata os traços distintivos das escolas clássica e neoclássica segundo a demarcação proposta por Keynes, bem como as críticas por ele dirigidas às principais teses defendidas por essas linhagens teóricas. A seguir, retoma-se a sua avaliação dos argumentos subconsumistas, indicando-se os seus pontos de convergência e distanciamento dessa visão econômica. Na continuação, apresentam-se as interpretações neoclássicas ao problema da demanda, comentando-se a relação da obra de Keynes com a tradição marshalliana. A última seção avalia a teoria neoclássica do produto real sob condições cíclicas e introduz a versão de Keynes para o equilíbrio agregado definido pelas propensões a gastar e a investir, além de indicar o componente de fragilidade da leitura marshalliana de sua estrutura teórica. Por fim, comenta-se a contribuição de Keynes ao conhecimento econômico da época perante a escola clássica e os hereges.

Efeitos da política fiscal sobre a dinâmica macroeconômica : dinâmica da dívida pública brasileira e seus efeitos no período recente

Este trabalho trata do tema da Política Fiscal, e mais especificamente, dos seus efeitos sobre a dinâmica macroeconômica. O trabalho analisa a dinâmica da dívida pública brasileira e seus efeitos no período recente. O objetivo geral do trabalho foi verificar se a dívida pública tem efeito enriquecedor, se ao se endividar existe crescimento real do produto da economia. O presente trabalho discute o debate acerca da questão da dívida pública, apresenta as diferentes visões sobre os efeitos da política fiscal na dinâmica macroeconômica, verifica qual tem sido o resultado encontrado por diferentes autores para a economia brasileira e analisar o caso brasileiro (pós-real).

Mecanismos de governança corporativa na pequena empresa familiar

Esta dissertação tem como objetivo descrever e analisar como o fenômeno da governança corporativa articula mecanismos de gestão e impacta na dinâmica de uma pequena organização familiar. Para isso, utilizou-se as perspectivas de Fan (2001) e Silva Junior (2006), que tratam da governança corporativa, e de Chandler (1994), para empresas familiares. Através de abordagem qualitativa com ênfase em um estudo de caso, uma triangulação de dados foi realizada, utilizando a entrevista semiestruturada, observação assistemática ou livre e pesquisa de documentos, e a análise dos dados foi realizada por análise de conteúdo. Verificou-se a presença do fenômeno da governança por intermédio da identificação dos fatores de diferenciação, resultando na implantação de mecanismos de governança ao longo do ciclo de vida da organização familiar, o que possibilitou mudanças em seu controle, no seu processo sucessório e na sua profissionalização. Quanto ao controle, foram verificados que os mecanismos de “manutenção do status quo”, “aconselhamento profissional”, “sinergia de interesses”, “regulamentação financeira da sociedade”, “atribuições e responsabilidades”, “alinhamento de interesses do negócio” e “proteção do empreendimento familiar” possibilitaram a modificação e manutenção do controle da empresa com os sócios. Quanto ao eixo da profissionalização, foi verificado que os mecanismos de “regulamentação financeira da sociedade”, “atribuições e responsabilidades”, “alinhamento de interesses do negócio”, “proteção do empreendimento familiar” e “atenção aos interesses dos stakeholders” foram responsáveis por prover as modificações neste quesito e indicar que a empresa caminha no sentido de se profissionalizar. Quanto ao processo sucessório, verificou-se que a terceira geração não tem interesse na empresa, o que podem resultar na contratação de um profissional externo para gerir a mesma, respeitando a questão dos valores familiares e a cultura organizacional ou conduzir à sucessão recursiva. Aparentemente, observou-se que a segunda questão foi mais evidente, visto que a saída do último irmão do negócio culmina com a venda da empresa familiar, gerando duas alternativas: a compra da empresa por um grupo de sócios ou outra empresa não familiar, o que resultaria na “morte” da empresa enquanto empresa familiar; ou a sua compra por outra família ou empresa familiar, preservando sua classificação inicial.

Inércia da taxa de juros : teoria e evidência para a economia brasileira (2005-2013)

No âmbito da condução da política monetária, as funções de reação estimadas em estudos empíricos, tanto para a economia brasileira como para outras economias, têm mostrado uma boa aderência aos dados. Porém, os estudos mostram que o poder explicativo das estimativas aumenta consideravelmente quando se inclui um componente de suavização da taxa de juros, representado pela taxa de juros defasada. Segundo Clarida, et. al. (1998) o coeficiente da taxa de juros defasada (situado ente 0,0 e 1,0) representaria o grau de inércia da política monetária, e quanto maior esse coeficiente, menor e mais lenta é a resposta da taxa de juros ao conjunto de informações relevantes. Por outro lado, a literatura empírica internacional mostra que esse componente assume um peso expressivo nas funções de reação, o que revela que os BCs ajustam o instrumento de modo lento e parcimonioso. No entanto, o caso brasileiro é de particular interesse porque os trabalhos mais recentes têm evidenciado uma elevação no componente inercial, o que sugere que o BCB vem aumentando o grau de suavização da taxa de juros nos últimos anos. Nesse contexto, mais do que estimar uma função de reação forward looking para captar o comportamento global médio do Banco Central do Brasil no período de Janeiro de 2005 a Maio de 2013, o trabalho se propôs a procurar respostas para uma possível relação de causalidade dinâmica entre a trajetória do coeficiente de inércia e as variáveis macroeconômicas relevantes, usando como método a aplicação do filtro de Kalman para extrair a trajetória do coeficiente de inércia e a estimação de um modelo de Vetores Autorregressivos (VAR) que incluirá a trajetória do coeficiente de inércia e as variáveis macroeconômicas relevantes. De modo geral, pelas regressões e pelo filtro de Kalman, os resultados mostraram um coeficiente de inércia extremamente elevado em todo o período analisado, e coeficientes de resposta global muito pequenos, inconsistentes com o que é esperado pela teoria. Pelo método VAR, o resultado de maior interesse foi o de que choques positivos na variável de inércia foram responsáveis por desvios persistentes no hiato do produto e, consequentemente, sobre os desvios de inflação e de expectativas de inflação em relação à meta central.