Diff for /imach096d/doc/imach.htm between versions 1.6 and 1.7

version 1.6, 2002/03/06 18:56:09 version 1.7, 2002/03/10 15:54:47
Line 1 Line 1
   <!-- $Id$ --!>
 <html>  <html>
   
 <head>  <head>
Line 29  color="#00006A">INED</font></a><font col Line 30  color="#00006A">INED</font></a><font col
 href="http://euroreves.ined.fr"><font color="#00006A">EUROREVES</font></a></h3>  href="http://euroreves.ined.fr"><font color="#00006A">EUROREVES</font></a></h3>
   
 <p align="center"><font color="#00006A" size="4"><strong>Version  <p align="center"><font color="#00006A" size="4"><strong>Version
 0.7, February 2002</strong></font></p>  0.71a, March 2002</strong></font></p>
   
 <hr size="3" color="#EC5E5E">  <hr size="3" color="#EC5E5E">
   
Line 58  color="#00006A">) </font></h4> Line 59  color="#00006A">) </font></h4>
   
 <ul>  <ul>
     <li><a href="#intro">Introduction</a> </li>      <li><a href="#intro">Introduction</a> </li>
     <li>The detailed statistical model (<a href="docmath.pdf">PDF  
         version</a>),(<a href="docmath.ps">ps version</a>) </li>  
     <li><a href="#data">On what kind of data can it be used?</a></li>      <li><a href="#data">On what kind of data can it be used?</a></li>
     <li><a href="#datafile">The data file</a> </li>      <li><a href="#datafile">The data file</a> </li>
     <li><a href="#biaspar">The parameter file</a> </li>      <li><a href="#biaspar">The parameter file</a> </li>
Line 80  monitor. In low mortality countries, the Line 79  monitor. In low mortality countries, the
 mortality declines, the increase in DFLE is not proportionate to  mortality declines, the increase in DFLE is not proportionate to
 the increase in total Life expectancy. This case is called the <em>Expansion  the increase in total Life expectancy. This case is called the <em>Expansion
 of morbidity</em>. Most of the data collected today, in  of morbidity</em>. Most of the data collected today, in
 particular by the international <a href="http://euroreves/reves">REVES</a>  particular by the international <a href="http://www.reves.org">REVES</a>
 network on Health expectancy, and most HE indices based on these  network on Health expectancy, and most HE indices based on these
 data, are <em>cross-sectional</em>. It means that the information  data, are <em>cross-sectional</em>. It means that the information
 collected comes from a single cross-sectional survey: people from  collected comes from a single cross-sectional survey: people from
Line 273  weights or covariates, you must fill the Line 272  weights or covariates, you must fill the
 <h2><font color="#00006A">Your first example parameter file</font><a  <h2><font color="#00006A">Your first example parameter file</font><a
 href="http://euroreves.ined.fr/imach"></a><a name="uio"></a></h2>  href="http://euroreves.ined.fr/imach"></a><a name="uio"></a></h2>
   
 <h2><a name="biaspar"></a>#Imach version 0.7, February 2002,  <h2><a name="biaspar"></a>#Imach version 0.71a, March 2002,
 INED-EUROREVES </h2>  INED-EUROREVES </h2>
   
 <p>This is a comment. Comments start with a '#'.</p>  <p>This is a comment. Comments start with a '#'.</p>
Line 349  line</font></a></h4> Line 348  line</font></a></h4>
 <h4><font color="#FF0000">Covariates</font></h4>  <h4><font color="#FF0000">Covariates</font></h4>
   
 <p>Intercept and age are systematically included in the model.  <p>Intercept and age are systematically included in the model.
 Additional covariates can be included with the command </p>  Additional covariates (actually two) can be included with the command: </p>
   
 <pre>model=<em>list of covariates</em></pre>  <pre>model=<em>list of covariates</em></pre>
   
Line 398  aij bij</b> </p> Line 397  aij bij</b> </p>
 23  -6.234642  0.022315 </pre>  23  -6.234642  0.022315 </pre>
 </blockquote>  </blockquote>
   
 <p>or, to simplify: </p>  <p>or, to simplify (in most of cases it converges but there is no warranty!): </p>
   
 <blockquote>  <blockquote>
     <pre>12 0.0 0.0      <pre>12 0.0 0.0
Line 485  prevalences and health expectancies</fon Line 484  prevalences and health expectancies</fon
 to calculated stationary prevalence, transitions probabilities  to calculated stationary prevalence, transitions probabilities
 and life expectancies at any age. Choice of age range is useful  and life expectancies at any age. Choice of age range is useful
 for extrapolation. In our data file, ages varies from age 70 to  for extrapolation. In our data file, ages varies from age 70 to
 102. Setting bage=50 and fage=100, makes the program computing  102. It is possible to get extrapolated stationary
 life expectancy from age bage to age fage. As we use a model, we  
 can compute life expectancy on a wider age range than the age  
 range from the data. But the model can be rather wrong on big  
 intervals.</p>  
   
 <p>Similarly, it is possible to get extrapolated stationary  
 prevalence by age ranging from agemin to agemax. </p>  prevalence by age ranging from agemin to agemax. </p>
   
   
   <p>Setting bage=50 (begin age) and fage=100 (final age), makes the program computing
   life expectancy from age 'bage' to age 'fage'. As we use a model, we
   can interessingly compute life expectancy on a wider age range than the age
   range from the data. But the model can be rather wrong on much larger
   intervals. Program is limited to around 120 for upper age!</p>
   
 <ul>  <ul>
     <li><b>agemin=</b> Minimum age for calculation of the      <li><b>agemin=</b> Minimum age for calculation of the
         stationary prevalence </li>          stationary prevalence </li>
Line 527  expectancies</font></h4> Line 527  expectancies</font></h4>
   
 <pre>pop_based=0</pre>  <pre>pop_based=0</pre>
   
 <p>The user has the possibility to choose between  <p>The program computes status-based health expectancies, i.e health
 population-based or status-based health expectancies. If  expectancies which depends on your initial health state.  If you are
 pop_based=0 then status-based health expectancies are computed  healthy your healthy life expectancy (e11) is higher than if you were
 and if pop_based=1, the programme computes population-based  disabled (e21, with e11 &gt; e21).<br>
 health expectancies. Health expectancies are weighted averages of  To compute a healthy life expectancy independant of the initial status
 health expectancies respective of the initial state. For a  we have to weight e11 and e21 according to the probability to be in
 status-based index, the weights are the cross-sectional  each state at initial age or, with other word, according to the
 prevalences observed between two dates, as <a href="#Computing">previously  proportion of people in each state.<br>
 explained</a>, whereas for a population-based index, the weights  
 are the stationary prevalences.</p>  We prefer computing a 'pure' period healthy life expectancy based only
   on the transtion forces. Then the weights are simply the stationnary
   prevalences or 'implied' prevalences at the initial age.<br>
   
   Some other people would like to use the cross-sectional prevalences
   (the "Sullivan prevalences") observed at the initial age during a
   period of time <a href="#Computing">defined just above</a>.
   
   <ul>
       <li><strong>popbased= 0 </strong> Health expectancies are computed
       at each age from stationary prevalences 'expected' at this initial age.</li>
       <li><strong>popbased= 1 </strong> Health expectancies are computed
       at each age from cross-sectional 'observed' prevalence at this
       initial age. As all the population is not observed at the same exact date we
       define a short period were the observed prevalence is computed.</li>
   </ul>
   
   </p>
   
 <h4><font color="#FF0000">Prevalence forecasting </font></h4>  <h4><font color="#FF0000">Prevalence forecasting ( Experimental)</font></h4>
   
 <pre>starting-proj-date=1/1/1989 final-proj-date=1/1/1992 mov_average=0 </pre>  <pre>starting-proj-date=1/1/1989 final-proj-date=1/1/1992 mov_average=0 </pre>
   
 <p>Prevalence and population projections are only available if  <p>Prevalence and population projections are only available if the
 the interpolation unit is a month, i.e. stepm=1. The programme  interpolation unit is a month, i.e. stepm=1 and if there are no
 estimates the prevalence in each state at a precise date  covariate. The programme estimates the prevalence in each state at a
 expressed in day/month/year. The programme computes one  precise date expressed in day/month/year. The programme computes one
 forecasted prevalence a year from a starting date (1 january of  forecasted prevalence a year from a starting date (1 january of 1989
 1989 in this example) to a final date (1 january 1992). The  in this example) to a final date (1 january 1992). The statement
 statement mov_average allows to compute smoothed forecasted  mov_average allows to compute smoothed forecasted prevalences with a
 prevalences with a five-age moving average centered at the  five-age moving average centered at the mid-age of the five-age
 mid-age of the five-age period. </p>  period. </p>
   
 <ul>  <ul>
     <li><strong>starting-proj-date</strong>= starting date      <li><strong>starting-proj-date</strong>= starting date
Line 569  forecasting </font></h4> Line 586  forecasting </font></h4>
 <pre>popforecast=0 popfile=pyram.txt popfiledate=1/1/1989 last-popfiledate=1/1/1992</pre>  <pre>popforecast=0 popfile=pyram.txt popfiledate=1/1/1989 last-popfiledate=1/1/1992</pre>
   
 <p>This command is available if the interpolation unit is a  <p>This command is available if the interpolation unit is a
 month, i.e. stepm=1 and if popforecast=1. From a data file </p>  month, i.e. stepm=1 and if popforecast=1. From a data file
   including age and number of persons alive at the precise date
 <p>Structure of the data file <a href="pyram.txt"><b>pyram.txt</b></a><b>  &#145;popfiledate&#146;, you can forecast the number of persons
 : </b>age numbers</p>  in each state until date &#145;last-popfiledate&#146;. In this
   example, the popfile <a href="pyram.txt"><b>pyram.txt</b></a>
 <p>&nbsp;</p>  includes real data which are the Japanese population in 1989.</p>
   
   <ul type="disc">
       <li class="MsoNormal"
       style="TEXT-ALIGN: justify; mso-margin-top-alt: auto; mso-margin-bottom-alt: auto; mso-list: l10 level1 lfo36; tab-stops: list 36.0pt"><b>popforecast=
           0 </b>Option for population forecasting. If
           popforecast=1, the programme does the forecasting<b>.</b></li>
       <li class="MsoNormal"
       style="TEXT-ALIGN: justify; mso-margin-top-alt: auto; mso-margin-bottom-alt: auto; mso-list: l10 level1 lfo36; tab-stops: list 36.0pt"><b>popfile=
           </b>name of the population file</li>
       <li class="MsoNormal"
       style="TEXT-ALIGN: justify; mso-margin-top-alt: auto; mso-margin-bottom-alt: auto; mso-list: l10 level1 lfo36; tab-stops: list 36.0pt"><b>popfiledate=</b>
           date of the population population</li>
       <li class="MsoNormal"
       style="TEXT-ALIGN: justify; mso-margin-top-alt: auto; mso-margin-bottom-alt: auto; mso-list: l10 level1 lfo36; tab-stops: list 36.0pt"><b>last-popfiledate</b>=
           date of the last population projection&nbsp;</li>
   </ul>
   
 <hr>  <hr>
   
Line 775  href="erbiaspar.txt"><b>erbiaspar.txt</b Line 808  href="erbiaspar.txt"><b>erbiaspar.txt</b
 72 9.9667 3.0502 4.8663 6.1025  72 9.9667 3.0502 4.8663 6.1025
 73 9.5077 3.0524 4.5044 6.0401 </pre>  73 9.5077 3.0524 4.5044 6.0401 </pre>
   
 <pre>For example 70 10.9226 3.0401 5.6488 6.2122 means:  <pre>For example 70 10.4227 3.0402 5.6488 5.7123 means:
 e11=10.9226 e12=3.0401 e21=5.6488 e22=6.2122</pre>  e11=10.4227 e12=3.0402 e21=5.6488 e22=5.7123</pre>
   
 <pre><img src="expbiaspar21.gif" width="400" height="300"><img  <pre><img src="expbiaspar21.gif" width="400" height="300"><img
 src="expbiaspar11.gif" width="400" height="300"></pre>  src="expbiaspar11.gif" width="400" height="300"></pre>
   
 <p>For example, life expectancy of a healthy individual at age 70  <p>For example, life expectancy of a healthy individual at age 70
 is 10.92 in the healthy state and 3.04 in the disability state  is 10.42 in the healthy state and 3.04 in the disability state
 (=13.96 years). If he was disable at age 70, his life expectancy  (=13.46 years). If he was disable at age 70, his life expectancy
 will be shorter, 5.64 in the healthy state and 6.21 in the  will be shorter, 5.64 in the healthy state and 5.71 in the
 disability state (=11.85 years). The total life expectancy is a  disability state (=11.35 years). The total life expectancy is a
 weighted mean of both, 13.96 and 11.85; weight is the proportion  weighted mean of both, 13.46 and 11.35; weight is the proportion
 of people disabled at age 70. In order to get a pure period index  of people disabled at age 70. In order to get a pure period index
 (i.e. based only on incidences) we use the <a  (i.e. based only on incidences) we use the <a
 href="#Stationary prevalence in each state">computed or  href="#Stationary prevalence in each state">computed or
Line 813  href="trbiaspar.txt"><font face="Courier Line 846  href="trbiaspar.txt"><font face="Courier
   
 <pre>#Total LEs with variances: e.. (std) e.1 (std) e.2 (std) </pre>  <pre>#Total LEs with variances: e.. (std) e.1 (std) e.2 (std) </pre>
   
 <pre>70 13.76 (0.22) 10.40 (0.20) 3.35 (0.14) </pre>  <pre>70 13.26 (0.22) 9.95 (0.20) 3.30 (0.14) </pre>
   
 <p>Thus, at age 70 the total life expectancy, e..=13.76years is  <p>Thus, at age 70 the total life expectancy, e..=13.26 years is
 the weighted mean of e1.=13.96 and e2.=11.85 by the stationary  the weighted mean of e1.=13.46 and e2.=11.35 by the stationary
 prevalence at age 70 which are 0.90134 in state 1 and 0.09866 in  prevalence at age 70 which are 0.90134 in state 1 and 0.09866 in
 state 2, respectively (the sum is equal to one). e.1=10.40 is the  state 2, respectively (the sum is equal to one). e.1=9.95 is the
 Disability-free life expectancy at age 70 (it is again a weighted  Disability-free life expectancy at age 70 (it is again a weighted
 mean of e11 and e21). e.2=3.35 is also the life expectancy at age  mean of e11 and e21). e.2=3.30 is also the life expectancy at age
 70 to be spent in the disability state.</p>  70 to be spent in the disability state.</p>
   
 <h5><font color="#EC5E5E" size="3"><b>-Total life expectancy by  <h5><font color="#EC5E5E" size="3"><b>-Total life expectancy by
Line 921  program while saving the old output file Line 954  program while saving the old output file
 <h5><font color="#EC5E5E" size="3"><b>- Prevalence forecasting</b></font><b>:  <h5><font color="#EC5E5E" size="3"><b>- Prevalence forecasting</b></font><b>:
 </b><a href="frbiaspar.txt"><b>frbiaspar.txt</b></a></h5>  </b><a href="frbiaspar.txt"><b>frbiaspar.txt</b></a></h5>
   
 <p>On a d'abord estimé la date moyenne des interviaew. ie  <p
 13/9/1995. This file contains </p>  style="TEXT-ALIGN: justify; tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt">First,
   we have estimated the observed prevalence between 1/1/1984 and
 <p>Example, at date 1/1/1989 : </p>  1/6/1988. The mean date of interview (weighed average of the
   interviews performed between1/1/1984 and 1/6/1988) is estimated
 <p>73 0.807 0.078 0.115 </p>  to be 13/9/1985, as written on the top on the file. Then we
   forecast the probability to be in each state. </p>
 <p>This means that at age 73, the probability for a person age 70  
 at 13/9/1989 to be in state 1 is 0.807, in state 2 is 0.078 and  <p
 to die is 0.115 at 1/1/1989.</p>  style="TEXT-ALIGN: justify; tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt">Example,
   at date 1/1/1989 : </p>
   
   <pre class="MsoNormal"># StartingAge FinalAge P.1 P.2 P.3
   # Forecasting at date 1/1/1989
     73 0.807 0.078 0.115</pre>
   
   <p
   style="TEXT-ALIGN: justify; tab-stops: 45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt">Since
   the minimum age is 70 on the 13/9/1985, the youngest forecasted
   age is 73. This means that at age a person aged 70 at 13/9/1989
   has a probability to enter state1 of 0.807 at age 73 on 1/1/1989.
   Similarly, the probability to be in state 2 is 0.078 and the
   probability to die is 0.115. Then, on the 1/1/1989, the
   prevalence of disability at age 73 is estimated to be 0.088.</p>
   
 <h5><font color="#EC5E5E" size="3"><b>- Population forecasting</b></font><b>:  <h5><font color="#EC5E5E" size="3"><b>- Population forecasting</b></font><b>:
 </b><a href="poprbiaspar.txt"><b>poprbiaspar.txt</b></a></h5>  </b><a href="poprbiaspar.txt"><b>poprbiaspar.txt</b></a></h5>
Line 946  to die is 0.115 at 1/1/1989.</p> Line 993  to die is 0.115 at 1/1/1989.</p>
 75 487781.02 91367.97 121915.51  75 487781.02 91367.97 121915.51
 74 512892.07 85003.47 117282.76 </pre>  74 512892.07 85003.47 117282.76 </pre>
   
   <p>From the population file, we estimate the number of people in
   each state. At age 73, 645857 persons are in state 1 and 69320
   are in state 2. One year latter, 512892 are still in state 1,
   85003 are in state 2 and 117282 died before 1/1/1990.</p>
   
 <hr>  <hr>
   
 <h2><a name="example" </a><font color="#00006A">Trying an example</font></a></h2>  <h2><a name="example"> </a><font color="#00006A">Trying an example</font></a></h2>
   
 <p>Since you know how to run the program, it is time to test it  <p>Since you know how to run the program, it is time to test it
 on your own computer. Try for example on a parameter file named <a  on your own computer. Try for example on a parameter file named <a
Line 965  question:'<strong>Enter the parameter fi Line 1017  question:'<strong>Enter the parameter fi
   
 <table border="1">  <table border="1">
     <tr>      <tr>
         <td width="100%"><strong>IMACH, Version 0.7</strong><p><strong>Enter          <td width="100%"><strong>IMACH, Version 0.71</strong><p><strong>Enter
         the parameter file name: ..\mytry\imachpar.txt</strong></p>          the parameter file name: ..\mytry\imachpar.txt</strong></p>
         </td>          </td>
     </tr>      </tr>
Line 1138  simple justification (name, email, insti Line 1190  simple justification (name, email, insti
 href="mailto:brouard@ined.fr">mailto:brouard@ined.fr</a> and <a  href="mailto:brouard@ined.fr">mailto:brouard@ined.fr</a> and <a
 href="mailto:lievre@ined.fr">mailto:lievre@ined.fr</a> .</p>  href="mailto:lievre@ined.fr">mailto:lievre@ined.fr</a> .</p>
   
 <p>Latest version (0.7 of February 2002) can be accessed at <a  <p>Latest version (0.71a of March 2002) can be accessed at <a
 href="http://euroeves.ined.fr/imach">http://euroreves.ined.fr/imach</a><br>  href="http://euroeves.ined.fr/imach">http://euroreves.ined.fr/imach</a><br>
 </p>  </p>
 </body>  </body>

Removed from v.1.6  
changed lines
  Added in v.1.7


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>