Annotation of imach/html/index.htm, revision 1.10

1.1       brouard     1: <html>
                      2: 
                      3: <head>
                      4: <meta http-equiv="Content-Type"
                      5: content="text/html; charset=iso-8859-1">
                      6: <meta name="GENERATOR" content="Microsoft FrontPage Express 2.0">
                      7: <title>Computing Health Expectancies using IMaCh</title>
                      8: <!-- Changed by: Nicolas Brouard, 17-Mar-2000 -->
                      9: </head>
                     10: 
                     11: <body bgcolor="#FFFFFF">
                     12: 
                     13: <hr size="3" color="#EC5E5E">
                     14: 
                     15: <h1 align="center"><font color="#00006A">Computing Health
                     16: Expectancies using IMaCh</font></h1>
                     17: <h1 align="center"><font color="#00006A" size="5">(a Maximum
                     18: Likelihood Computer Program using Interpolation of Markov Chains)</font></h1>
                     19: 
                     20: <p align="center"><a href="http://www.ined.fr/"><img
                     21: src="doc/logo-ined.gif" border="0" width="151" height="76"></a><img
                     22: src="doc/euroreves2.gif" width="151" height="75"></p>
                     23: 
                     24: <h3 align="center"><a href="http://www.ined.fr/"><font
                     25: color="#00006A">INED</font></a><font color="#00006A"> and </font><a
                     26: href="http://euroreves.ined.fr"><font color="#00006A">EUROREVES</font></a></h3>
                     27: 
1.10    ! lievre     28: <p align="center"><font color="#00006A" size="4"><strong>August 2005</strong></font></p>
1.1       brouard    29: 
                     30: <hr size="3" color="#EC5E5E">
                     31: 
                     32: <h4 align="center"><font color="#00006A">Authors of the program: </font><a
                     33: href="http://sauvy.ined.fr/~brouard"><font color="#00006A">Nicolas
                     34: Brouard</font></a><font color="#00006A">, senior researcher at
                     35: the </font><a href="http://www.ined.fr"><font color="#00006A">Institut
                     36: National d'Etudes Démographiques</font></a><font color="#00006A">
                     37: (INED, Paris) in the "Mortality, Health and Epidemiology
                     38: Research Unit" </font></h4>
                     39: 
                     40: <h4 align="center"><font color="#00006A">and Agnès Lièvre (PHD student at INED)</font></h4>
                     41: 
                     42: <h4><font color="#00006A">Contribution to the mathematics: C. R.
                     43: Heathcote </font><font color="#00006A" size="2">(Australian
                     44: National University, Canberra).</font></h4>
                     45: 
                     46: <h4><font color="#00006A">Contact: Agnès Lièvre (</font><a
                     47: href="mailto:lievre@ined.fr"><font color="#00006A"><i>lievre@ined.fr</i></font></a><font
                     48: color="#00006A">) </font></h4>
                     49: 
1.2       brouard    50: <p> Main publication concerning the method is 
                     51: <a href=http://taylorandfrancis.metapress.com/app/home/contribution.asp?wasp=1f99bwtvmk5yrb7hlhw3&referrer=parent&backto=issue,1,2;journal,2,5;linkingpublicationresults,1:300265,1
                     52: >Lièvre A., Brouard N. and Heathcote Ch. (2003) Estimating Health Expectancies 
                     53: from Cross-longitudinal surveys. <em>Mathematical Population Studies</em>.- 10(4), pp. 211-248</a>
1.1       brouard    54: </p>
                     55: 
1.6       brouard    56: <h2><font color="#EC5E5E"><strong>Download and instructions for installation</strong></font></h2>
1.1       brouard    57: 
1.6       brouard    58: <h3>On Windows (win9X, 2000, XP)</h3>
1.5       brouard    59: <p> Until June 2004 the installation did consist in a zip file which
                     60: had to be extracted in the directory of your choice. But with version
                     61: 0.97b IMaCh we are using a windows installer (Inno setup).  Both
                     62: executables <tt>imach.exe</tt> and <tt>gnuplot.exe</tt> (the grapher
                     63: that we are using) have to be on the same directory.
                     64: 
                     65: <br> In order to facilitate the use of IMaCh we associated the .imach
                     66: extension to two features: editing and running. Thus by right clicking
                     67: on a foo.imach file you can either 'edit'the file (default) with
                     68: the notepad editor or 'run' it with gnuplot (you need a recent version).<br>
                     69: 
                     70:       But we discovered that on some computers, people are not allowed
                     71:       to modify the windows registry and need to have Administrator privileges.
                     72: 
                     73:      <br>
                     74:       Thus we built two windows installer: a standard setup which will install
                     75:       the progam (usually in <tt>\Program Files\imach</tt> and will
                     76:       modify the registry to associate <tt>.imach</tt> extension to notepad and imach, and a
                     77:       second which will not alter the registry. With this second installer you
                     78:       will be able to install the programs in your home directory and
                     79:       run it by clicking on the imach.exe icon. But you won't be able
                     80:       to use the facility of the right clicking.
1.1       brouard    81: </p>
                     82: 
                     83: <ul>
1.3       brouard    84:     <li>Download latest <font size="2" face="Courier New"><strong>imach-0.97b-setup.exe</strong></font>
1.2       brouard    85:         and execute it .</li>
                     86:     <li>Different sub-directories are created:
                     87:           <ul>
1.1       brouard    88:             <li>doc: most of the documentation. The main document
                     89:                 is <a href="doc/imach.htm">doc/imach.htm</a> .</li>
1.2       brouard    90:                 <ul> Here are also two data files:<font size="4"
1.1       brouard    91:                 face="Times New Roman"> </font><ul>
                     92:                     <li><font face="Courier New">data1.txt</font>
                     93:                         which is the main data file on which the
                     94:                         program has been run as the example in
                     95:                         the main documentation.</li>
                     96:                     <li><font face="Courier New">mydata.txt </font>a
                     97:                         smaller data file which you can use for
                     98:                         your own trial.</li>
                     99:                 </ul>
1.4       brouard   100:                </ul>
                    101:             <li>bin: <ul> <li><font face="Courier">imach.exe</font>
                    102:             the executable for Windows 95/98/NT compiled with gcc from
                    103:             cygwin.</li> <li> gnuplot, the grapher use by IMaCh.  Its
                    104:             reference manual and sources can be accessed from <a
                    105:             href="http://www.gnuplot.info/">http://www.gnuplot.info/</a>.
1.2       brouard   106:                 </ul>
1.1       brouard   107:             </li>
                    108:             <li>src: This subdirectory contains the source of the
                    109:                 program. It can be obtained by asking us by mail <a
                    110:                 href="mailto:brouard@ined.fr">mailto:brouard@ined.fr</a>
                    111:                 and <a href="mailto:lievre@ined.fr">mailto:lievre@ined.fr</a>
                    112:                 .</li>
                    113:         </ul>
                    114:     </li>
1.2       brouard   115:     <li>Right click on the .imach to either edit it or execute it with Imach.</li>
1.1       brouard   116:     <li>Read the file README.txt or, better, click on <a
                    117:         href="doc/imach.htm">doc/imach.htm</a></li>
                    118: </ul>
                    119: 
1.6       brouard   120: <br>
                    121: Imach version 0.97b of June 21 2004 can be downloaded as a setup.exe file
1.10    ! lievre    122: <a href="imach-0.97b-2-setup.exe">
1.6       brouard   123: http://euroreves.ined.fr/imach/imach-0.97b-2-setup.exe</a>. The IMaCh
                    124: program and gnuplot will be installed in the directory that you want
                    125: (usually in Program Files).  We made some errors in the new setup and
                    126: some erlier versions did not work. Please check the md5sum which is
                    127: 3cb42bf71396d531d4bc3d42fee46a52 imach-0.97b-2-setup.exe 
                    128: 
                    129: <br>We also changed the wordpad editor to notepad which is less useful
                    130: but exists on most Windows installation.  <br> For people who are not
                    131: allowed to modify the registry of their Windows installation here is a
                    132: second setup <a
                    133: href="imach-0.97b-2-noreg-setup.exe">imach-0.97b-2-noreg-setup.exe</a>.
                    134: 
1.7       brouard   135: <p><a href="oldversions.html">Old Windows versions are accessible here.</a>
1.10    ! lievre    136: <h3>On Mac OS/X Panther only (october 2005)</h3>
1.6       brouard   137: 
                    138: IMaCh can be easily compiled with gcc 3.3 on MacIntosh as soon as
                    139: XCode (free download from Apple) is intalled on your MaCIntosh.<p>
                    140: 
                    141: It take a litle more time to get latest version of Gnuplot 4.0 for Mac
1.10    ! lievre    142: OS/X and to compile it on a MaC (sources tar.gz can be also accessed on our site from <a href=gnuplot-4.0.0.tar.gz>here</a>. The main problem resides in finding
1.6       brouard   143: the png library. Gif images are patented now and the replacement is
                    144: png, but the development of the png library is growing on its own and
                    145: you just have to find on Google where it is hosted now.
                    146: 
                    147: <br>
                    148: Gnuplot can be easily compiled on a MaC, but I don't know yet (July
1.10    ! lievre    149: 2004) which is default screen terminal driver for gnuplot. 
        !           150: As already said you need libpng (to be included in terms) which itself needs zlib on the same directory level. Boths sources can be acessed on the Web but here you can get the sources used on the MacOS/X Panther version (<a href- libpng-1.2.5.tgz>libpng-1.2.5.tgz</a> and <a href=zlib-1.2.1.tar.gz>zlib-1.2.1.tar.gz</a>.
        !           151: 
        !           152: If X11 is already installed on your MaC (it is included on your installation CD
        !           153: or you can download it from the WEB), then you can do <tt>set ter
1.6       brouard   154: X11</tt> and <tt>plot sin(x)</tt> to get a nice sin curve on an X11
                    155: window of your Mac.
                    156: 
                    157: <br> Let me add that for running IMaCh with all of its features, you don't
                    158: need X11; the gnuplot program included in the distribution needs only
                    159: to have the png terminal driver to output graphs and these graphs will
                    160: be viewed by your browser.<br>
                    161: 
                    162: You need X11 only if you want to modify and test the gnuplot code output by
                    163: ImaCh, because it might be a more convenient way to view the graphs
                    164: directly on the screen than writing images on a file and viewing them
                    165: with a browser,
                    166: 
                    167: <p>
1.7       brouard   168: You can download a .pkg.pax file at <a
1.6       brouard   169:        href="imach097b.pkg.pax">imach097b.pkg.pax</a>. Stuffit
1.7       brouard   170:       Expander will expand the compressed file into a imach097b.pkg directory. Just
                    171:       clicking on the directory will let you install IMaCh in a local
                    172:       directory of your own (you have to create a new folder name IMaCh097b or whatever). Two sub-directories are created
1.6       brouard   173:       <tt>bin</tt> and <tt>html</tt> . In the bin subdirectory you
                    174:       will find two executables <tt>imach</tt> itself and
                    175:       <tt>gnuplot</tt>. 
1.10    ! lievre    176: <p>You can also download a dmg file (octobre 2005) still for Panther only (we do not have a Tiger version at INED yet) at <a href=imach-0.98panther.dmg>imach-0.98panther.dmg</a>.
1.6       brouard   177: 
                    178: <p>
                    179: You need to click on <tt>imach</tt> and IMaCh will be launched in a
1.10    ! lievre    180: Terminal window, asking you to enter a <tt>parameter</tt> file. A
1.9       brouard   181: parameter file is text file with an extension <tt>.imach</tt> (but you
                    182: can use a <tt>.txt</tt> extension if you want. Among the parameters
                    183: required, a data file name has to be entered. It can be a relative
                    184: file name like <tt>../../data/data1.txt</tt>. <br> If you open a new
                    185: finder you can drag an IMaCh parameter file into the terminal IMaCh
                    186: Window that you just created.
1.6       brouard   187: <p>
                    188: At the end of the run, and it order for the terminal window not to
1.7       brouard   189:       disappear, the program will prompt for a command like "<tt>e</tt>" for
1.6       brouard   190:       edit or "<tt>q</tt>" for quit. The edit command might not work
                    191:       on a MaC, or on Unix or even on recent Windows, because the program should know which
                    192:       browser you are using and becauee the BROWSER environment
                    193:       doesn't seem to be standard on a Mac and on some other OS too.
                    194: 
                    195: <br> The consequence for you is just that you have to use your finder
                    196:       or browser (there is no more difference now) and click on the
                    197:       <tt>.html</tt> (or .htm) file created. The filename of this html
                    198:       file is the same name as your parameter file, only the extension
                    199:       .imach is changed to .html.
                    200: 
1.7       brouard   201: <h3>On Linux</h3> There are various versions of Linux, gnuplot is
                    202: distributed on most distributions. Just verify that your version of
                    203: gnuplot is more recent than version 0.38i . I haven't had time to make
                    204: a rpm yet, just ask us for the CVS tree location (not completely GPL
                    205: today), and compile the sources. Remarks concerning the Linux versions
                    206: are similar to the Mac OS/X version. A binary rpm will be given as
1.8       brouard   207: soon as a src rpm will be given which means that the whole program
                    208: will be GPL licensed.
1.6       brouard   209: 
1.1       brouard   210: <p><a href="doc/imach.htm"><font color="#FF0000" size="6">Click
                    211: here to access to the detailed documentation</font></a></p>
                    212: 
                    213: <p>This software have been partly granted by <a
1.2       brouard   214: href="http://euroreves.ined.fr">Euro-REVES</a>, a concerted action
                    215: from the European Union. In 2003-2004 it has been granted by the
                    216: French Institute on Longevity. Our work is copyrighted as a GNU
                    217: software product, i.e. program and software can be distributed freely
                    218: for non commercial use, but actually some sources are not widely
                    219: distributed today because they borrow some codes from the book
                    220: "Numerical Recipes in C" which is copyrighted. If you are an owner of
                    221: theses sources you can get our sources by asking us with a simple
                    222: justification (name, email, Institute) <a
                    223: href="mailto:imach-dev@listes.ined.fr">mailto:imach-dev@listes.ined.fr</a>
                    224: </p>
1.1       brouard   225: 
1.2       brouard   226: <p>Today we are two developpers only but we already use a private CVS
                    227: server. The CVS server will be freely accessible as soon as we have
                    228: replaced "Numerical Recipes in C maximization routines" with
                    229: equivalent routines from the new GNU scientific library.
1.1       brouard   230: 
                    231: <p>Latest documentation can be accessed at <a
                    232: href="http://euroreves.ined.fr/imach">http://euroreves.ined.fr/imach</a><br>
                    233: </p>
                    234: 
1.5       brouard   235: <p> There is a public mailing list of IMaCh's users.  You can
1.2       brouard   236: subscribe by sending a mail to <a
                    237: href=mailto:imach-users-subscribe@listes.ined.fr>imach-users-subscribe@listes.ined.fr</a>
                    238: (and unsubscribe with <a
                    239: href=mailto:imach-users-unsubscribe@listes.ined.fr>imach-users-unsubscribe@listes.ined.fr</a>
1.1       brouard   240: </p>
1.10    ! lievre    241: 
        !           242: <h2>IMaCh Wiki</h2>
        !           243: As discussed at the last REVES meeting in <a href="http://www.prw.le.ac.uk/cgi-bin/reves/2005.cgi">Beijing</a>, we created a Wiki for IMaCh were people having used IMaCh (or having not been able to used it because of obscure or unadequate features) can add tips and discuss various aspects of IMaCh and interface with other statistical softwares. In many aspects, our "official documentation" is not accurate enough.
        !           244: 
        !           245: <p> Wikis are a very promising way to give information closer to your expectations. It also a very dynamic movement if you consider the first <a href="http://wikimania.wikimedia.org/wiki/Main_Page">International Wikimedia Conference in Francfurt</a> (August 2005), where most Wikis were represented and in particular <a href="http://wikipedia.org">Wikipedia</a>.
        !           246: 
        !           247: <p><a href="wiki"><font color="#FF0000" size="6">Access to the new (August 2005) IMaCh Wiki</font></a></p>
        !           248: 
        !           249: 
        !           250: 
        !           251: 
        !           252: <br>$Id: index.htm,v 1.9 2004/07/23 16:07:11 brouard Exp $<br>
1.4       brouard   253: <!--  $State: Exp $
                    254:   $Log: index.htm,v $
1.10    ! lievre    255:   Revision 1.9  2004/07/23 16:07:11  brouard
        !           256:   *** empty log message ***
        !           257: 
1.9       brouard   258:   Revision 1.8  2004/07/23 14:34:18  brouard
                    259:   *** empty log message ***
                    260: 
1.8       brouard   261:   Revision 1.7  2004/07/23 14:31:46  brouard
                    262:   *** empty log message ***
                    263: 
1.7       brouard   264:   Revision 1.6  2004/07/23 14:11:14  brouard
                    265:   MaC OS/X version added.
                    266: 
1.6       brouard   267:   Revision 1.5  2004/06/22 11:18:20  brouard
                    268:   Adding the noreg setup for users who don't have privileges to modify Windows registries.
                    269: 
1.5       brouard   270:   Revision 1.4  2004/06/16 23:49:33  brouard
                    271:   *** empty log message ***
                    272: 
1.4       brouard   273: -->
1.1       brouard   274: </body>
                    275: </html>
                    276:                                       

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