imach/html/index.htm - view

File: [Local Repository] / imach / html / index.htm
Revision 1.15: download - view: text, annotated - select for diffs
Fri Aug 29 08:50:53 2014 UTC (9 years, 10 months ago) by brouard
Branches: MAIN
CVS tags: HEAD

Summary: 0.98nX compiled now with visual studio 2010
Author: 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:  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: 28: <p align="center"><font color="#00006A" size="4"><strong>August 2014</strong></font></p> 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 (former 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: Nicolas Brouard (</font><a 47: href="mailto:brouard@ined.fr"><font color="#00006A"><i>brouard@ined.fr</i></font></a><font 48: color="#00006A">) </font></h4> 49: 50: <p> Main publication concerning the method is 51: <a href=http://dx.doi.org/10.1080/713644739>Lièvre A., Brouard N. and Heathcote Ch. (2003) Estimating Health Expectancies 52: from Cross-longitudinal surveys. <em>Mathematical Population Studies</em>.- 10(4), pp. 211-248. DOI 10.1080/713644739</a> 53: </p> 54: 55: <h2><font color="#EC5E5E"><strong>Download and instructions for installation</strong></font></h2> 56: 57: <h3> Current versions August 2014 </h3> 58: <ul> 59: <li>On Windows (win9X, 2000, XP, Vista, Windows 7, Windows 8): 0.98nV</li> 60: <li>On MacOS/X Leopard: 0.98nV</li> 61: <li>On Linux, ask for the CVS version </li> 62: </ul> 63: The grapher that IMaCh uses is gnuplot 64: from <a href="http://www.gnuplot.info/">http://www.gnuplot.info/</a>. 65: Gnuplot has evolved since version IMaCh 0.98k and therefore you need 66: at least Gnuplot 4.6. Otherwise you need to adapt the .gp file 67: produced in order to run with your old gnuplot. 68: 69: With the installer provided for OS/X and Windows, a recent gnuplot 70: binary is provided and will be installed on the same directory that 71: the IMaCh binary. It is better to use your own Gnuplot installation 72: and IMaCh will test the command '''gnuplot''' but if the binary in not 73: in your path, it will make a error but will use the binary provided by 74: the installers. Using recent gnuplot installations, there is usually a 75: possibility to add the gnuplot binary in your path. 76: 77: <h3>On Windows (win9X, 2000, XP, Vista, Windows 7, Windows 8)</h3> 78: <p> Until June 2004 the installation did consist in a zip file which 79: had to be extracted in the directory of your choice. But with version 80: 0.98d and above IMaCh we are using a windows installer (Inno setup). 81: 82: <br> In order to facilitate the use of IMaCh we associated the .imach 83: extension to two features: editing and running. Thus by right clicking 84: on a foo.imach file you can either 'edit'the file (default) with 85: the notepad editor or 'run' it with gnuplot (you need a recent version).<br> 86: 87: But we discovered that on some computers, people are not allowed 88: to modify the windows registry and need to have Administrator privileges. 89: 90: <br> 91: Thus we built two windows installer: a standard setup which will install 92: the progam (usually in <tt>\Program Files\imach</tt> and will 93: modify the registry to associate <tt>.imach</tt> extension to notepad and imach, and a 94: second which will not alter the registry. With this second installer you 95: will be able to install the programs in your home directory and 96: run it by clicking on the imach.exe icon. But you won't be able 97: to use the facility of the right clicking. 98: </p> 99: 100: <ul> 101: <li>Download latest <font size="2" face="Courier 102: New"><strong>imach-0.98nX-1-setup.exe</strong></font> and 103: execute it .</li> 104: <li> Download <font size="2" face="Courier 105: New"><strong>gnuplot</strong></font> 4.6.5 106: at <a href="http://www.gnuplot.info/">http://www.gnuplot.info/</a> 107: ; at the end of the install it is asked if you want to have the 108: gnuplot binary in your path, say yes.</li> 109: <li>Different sub-directories are created: 110: <ul> 111: <li>doc: most of the documentation. The main document 112: is <a href="wiki/index.php/Documentation">http://euroreves.ined.fr/imach/wiki/index.php/Documentation</a> 113: .</li> 114: <ul> Here are also two data files:<font size="4" 115: face="Times New Roman"> </font><ul> 116: <li><font face="Courier New">data1.txt</font> 117: which is the main data file on which the 118: program has been run as the example in 119: the main documentation.</li> 120: <li><font face="Courier New">mydata.txt </font>a 121: smaller data file which you can use for 122: your own trial.</li> 123: </ul> 124: </ul> 125: <li>bin: <ul> 126: <li><font face="Courier">imach.exe</font></li> 127: <li> gnuplot, the grapher used by IMaCh. Its 128: reference manual and sources can be accessed from <a 129: href="http://www.gnuplot.info/">http://www.gnuplot.info/</a>. 130: </ul> 131: </li> 132: <li>src: This subdirectory contains the source of the 133: program. It can be obtained by asking us by mail brouard at ined pointfr 134: .</li> 135: </ul> 136: </li> 137: <li>Right click on the .imach to either edit it or execute it with 138: IMaCh. At the end of the program, IMaCh uses gnuplot to produce 139: the graphs, then you can open your browser to read the main .htm 140: file with all results and graphs. If gnuplot is not installed or 141: not in your path, you have to run gnuplot on the ".gp" source file 142: generated by imach. Using wgnuplot you have to "open" it. </li> 143: <li>Read the file README.txt 144: </ul> 145: 146: <br> 147: Imach version 0.98nX of August 2014 can be downloaded as a setup.exe file 148: <a href="imach-0.98nX-1-setup.exe"> 149: http://euroreves.ined.fr/imach/imach-0.98nX-1-setup.exe (compiled with 150: free Visual Studio compiler 2010 32 bits)</a>. If MSVCR100.dll is 151: missing on your windows system (32 or 64 bits) please download the 152: library from Microsoft.com by installing 153: the <a href="http://www.microsoft.com/en-us/download/details.aspx?id=8328">32Bit: 154: Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)</a>. The 155: IMaCh program and gnuplot will be installed in the directory that you 156: want (usually in Program Files). Please check the md5sum which is 157: f801319e8dbc852296e4fba13029c7e0 imach-0.98nX-1-setup.exe 158: 159: <br>After installation a right click on a .imach file lets edit with 160: the notepad text editor which is less useful than other text editor 161: like workpad but exists on most Windows installation. <br> For people 162: who are not allowed to modify the registry of their Windows 163: installation here is a second 164: setup <a href="imach-0.98nX-1-noreg-setup.exe">imach-0.98nX-1-noreg-setup.exe</a>. 165: <br> 166: 766443598a014e8d9cf5cbaccab99e0d imach-0.98nX-1-noreg-setup.exe 167: <p> The executable for Windows cross-compiled on OS/X with 168: i386-mingw32-gcc doesn't produce efficient binary compared to native 169: Visual Studio 2010 (used here). imach-0.98nV-1-setup.exe is compiled 170: with i386-mingw32-gcc . 171: 172: <p><a href="oldversions.html">Old Windows versions are accessible here.</a> 173: <h3>On Mac OS/X Leopard (August 2014)</h3> 174: 175: IMaCh can be easily compiled with gcc 3.3 on MacIntosh as soon as 176: XCode (free download from Apple) is intalled on your MaCIntosh.<p> 177: 178: It take a litle more time to get version of Gnuplot 4.6.5+ for Mac OS/X 179: and to compile it on a MaC. Currently graphs are output as png 180: files. We will probably moved to svg because the svg format is 181: scalable and thus figures are easier to improve and insert in other documents. 182: 183: 184: <p> 185: You can download a dmg file 186: at <a href="imach0.98nX.dmg">imach0.98nX.dmg</a> (md5sum 187: ff9d2389abc2d3ce106203d89fd096d4). Like on Windows, two 188: sub-directories are created 189: <tt>bin</tt> and <tt>html</tt> . In the bin subdirectory you 190: will find two executables <tt>imach</tt> itself and 191: <tt>gnuplot</tt>. 192: 193: <p> 194: You need to click on <tt>imach</tt> application and IMaCh will be 195: launched in a Terminal window, asking you to enter 196: a <tt>parameter</tt> file. A parameter file is a text file with an 197: extension <tt>.imach</tt> (but you can use a <tt>.txt</tt> extension 198: if you want. Among the parameters required, a data file name has to 199: be entered. It can be a relative file name 200: like <tt>../../data/data1.txt</tt>. <br> If you open a new finder you 201: can drag an IMaCh parameter file into the terminal IMaCh Window that 202: you just created. 203: <p> 204: At the end of the run, and it order for the terminal window not to 205: disappear, the program will prompt for a command like "<tt>e</tt>" for 206: edit (with your browser) or "<tt>q</tt>" for quit. 207: 208: <br> The consequence for you is just that you have to use your finder 209: or browser (there is no more difference now) and click on the 210: <tt>.html</tt> (or .htm) file created. The filename of this html 211: file has the same name as your parameter file, only the extension 212: .imach is changed to .html. 213: 214: <h3>On Linux</h3> There are various versions of Linux, gnuplot is 215: distributed on most distributions. Just verify that your version of 216: gnuplot is more recent than version 4.6.5 . I haven't had time to make 217: a rpm yet, just ask us for the CVS tree location (not completely GPL 218: today), and compile the sources. Remarks concerning the Linux versions 219: are similar to the Mac OS/X version. 220: <p> 221: <font color="#FF0000" size="3"><tt>New (August 2014)</tt></font> You 222: can download a binary tar file for respectively a 32 bits or 64 bits 223: Linux box:<p> 224: cf9784f1d3f464b2f0c7ddf2fea84062 <a href="imach-Linux-0.98nX-linux-i586-bin.tar.bz2">imach-Linux-0.98nX-linux-i586-bin.tar.bz2</a><p> 225: or 226: 0974bcf30596f94f97d0e80acaf5a1bb <a href="imach-Linux-0.98nX-linux-x86-64-bin.tar.bz2">imach-Linux-0.98nX-linux-x86-64-bin.tar.bz2</a> <p> 227: The binaries have been crosscompiled with gcc on my OS/X Mac. Each 228: binary contains two directories <tt>bin</tt> and <tt>html/doc</tt> 229: . In the bin subdirectory you will find the <tt>imach</tt> executable 230: and in <tt>html/doc</tt> the <tt>biaspar.imach</tt> test parameter 231: file and its corresponding data file <tt>data1.txt</tt>. In order to 232: run the test the command is <tt>./bin/imach 233: ./html/doc/biaspar.imach</tt> <p> 234: <tt>gnuplot</tt> should be installed otherwise at the end of the 235: run (optimization and calculations last at least 7 minutes on 236: today most efficient hardwares) the command <tt>gnuplot 237: biaspar.gp</tt> will fail. If successful, typing <tt>e</tt> will 238: open <tt>biaspar.htm</tt> with your browser and all the results 239: including graphs generated by gnuplot will appear. Please 240: subscribe to the mailing 241: list <tt>imach-users@listes.ined.fr</tt> for comments and 242: reports on the performance (see the Performance section of 243: the <a href="http://euroreves.ined.fr/imach/wiki">wiki</a>). 244: 245: 246: <p><a href="http://euroreves.ined.fr/imach/wiki/index.php/Documentation"><font color="#FF0000" size="6">Click 247: here to access to the detailed documentation</font></a></p> 248: 249: <p>This software have been partly granted 250: by <a href="http://euroreves.ined.fr">Euro-REVES</a>, a concerted 251: action from the European Union. In 2003-2004 it has been granted by 252: the French Institute on Longevity. In January 2014, it has been 253: granted by the Japan Society for the Promotion of Science 254: (Grant-in-Aid for Scientific Research 25293121. 255: <p> 256: Our work is copyrighted as a GNU software product, i.e. program and 257: software can be distributed freely for non commercial use, but 258: actually some sources are not widely distributed today because they 259: borrow some codes from the book "Numerical Recipes in C" which is 260: copyrighted. If you are an owner of theses sources you can get our 261: sources by asking us with a simple justification (name, email, 262: Institute) <a href="mailto:imach-dev@listes.ined.fr">mailto:imach-dev@listes.ined.fr</a> 263: </p> 264: 265: <p>Today we are two developpers only but we already use a private CVS 266: server. The CVS server will be freely accessible as soon as we have 267: replaced "Numerical Recipes in C maximization routines" with 268: equivalent routines from the new GNU scientific library. 269: 270: <p>Latest documentation can be accessed at <a 271: href="http://euroreves.ined.fr/imach/wiki/index.php/Documentation">http://euroreves.ined.fr/imach/wiki/index.php/Documentation</a><br> 272: 273: <p> There is a public mailing list of IMaCh's users. You can 274: subscribe by sending a mail to <a 275: href=mailto:imach-users-subscribe@listes.ined.fr>imach-users-subscribe@listes.ined.fr</a> 276: (and unsubscribe with <a 277: href=mailto:imach-users-unsubscribe@listes.ined.fr>imach-users-unsubscribe@listes.ined.fr</a> 278: </p> 279: 280: <h2>IMaCh Wiki</h2> 281: As discussed at the 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 use 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. 282: 283: <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>. 284: 285: <p><a href="wiki"><font color="#FF0000" size="6">Access to the IMaCh Wiki</font></a></p>. Please ask for a username and password. 286: 287: 288: 289: 290: <br>$Id: index.htm,v 1.15 2014/08/29 08:50:53 brouard Exp $<br> 291:  316: </body> 317: </html> 318: