[BACK]Return to README.txt CVS log [TXT] [DIR] Up to [Local Repository] / imach / src

Diff for /imach/src/README.txt between versions 1.1 and 1.9

version 1.1, 2004/06/17 17:36:38 version 1.9, 2022/03/15 18:40:36
Line 1 Line 1
   Version IMaCh 0.99
   
 Interpolated Marlov Chain (IMaCh program)  Interpolated Marlov Chain (IMaCh program)
   
 This program is GPL licensed for the part the code that we wrote at  This program is licensed under the GNU GNU GENERAL PUBLIC LICENSE.
 INED. But currently (version 0.97b may 2004) maximization routines use  
 a modified version of the patented routines from "Numerical Recipes in  The program estimates Life Expectancies from Cross-longitudinal
 C". If you have the right to use the sources of their software you can  studies as well as age-specific forward and backward prevalences in each state.
 get access to the source code and to the CVS tree of IMaCh.  The main publications are:
   (1) Lièvre, A. Brouard. N, Heathcote Ch. Estimating Health
 The program estimates Health Expectancies from Cross-longitudinal  Expectancies from Cross-longitudinal surveys, Mathematical Population Studies, 10(1), 2003, pp. 1-52.
 studies.  (2) Nicolas Brouard, 2019, "Theory and applications of backward probabilities and prevalences in cross-longitudinal surveys". In: Arni S. R. Srinivasa Rao (Ed.) and C.R. Rao (Ed.), Handbook of Statistics.
 The main publication is Lievre, A. Brouard. N, Heathcote  Integrated population biology and modeling, Part B, Elsevier, p. 435-486.
 Ch. Estimating Health Expectancies from Corss-longitudinal surveys,  http://hdl.handle.net/20.500.12204/AWltfxMuXMQCvuZmm9UI
 Mathematical Population Studies, 10(1), 2003, pp. 1-52.  
   To be brief, for each people interviewed we need the age and
 To be brief, for each people interviewed we have the age and health  state at each interview. Also the month and year of death should be
 states at each interview. Also the month of death is known. We model  known as for birth.  We model the probability to be observed in any
 the probability to be observed in any state at any age via a  state at any age via a parametric model and estimate the parameters
 parametric model and estimate the parameters and their confidence interval  and their confidence interval by maximum likelihood. Many tables and
 by maximum likelihood, many tables and graphs are output in  graphs are output in HTML. Graphs are built using gnuplot.
 HTML. Graphs are built using gnuplot.  
   First versions appeared around year 2000. Currently (May 2019)
 In the Windows version, gnuplot is also distributed. Version 4 is out  version 0.99r19 can run on any Unix, including OS/X and on Windows 10
 since early 2004 and is used by latest version of Imach (at least  (64bit) as well as Windows XP (32bit).
 version 0.38i is required).  
 IMaCh is supposed to work on Linux, MacIntosh and Windows (9X or  Binaries are usually provided for OS/X (DMG for 64bit), Linux (rpm)
 NT/XP).  and Windows installer (32 and 64bit).
   
 WINDOWS  
 On Windows it is distributed via a setup file (no more a zip file). As  STRUCTURE of the binary
 usual you can put the 'imach' directory in Program Files or  
 wherever. The directory contains at least 2 directories, 'bin' for the  IMaCh is a command line program (no time for a GUI) which means that
 binaries which are imach.exe and gnuplot.exe, doc for some of the  it can be run on a shell by "$ imach foo.imach" where foo.imach is your
 documentation, and 'mytry' in order to test the program on a parameter  'parameter' file which is a simple text file with a few lines that
 file name 'mypar.imach'.  your must edit in order to describe your data as well as your model
   line. In this parameter file you give the name and path of your data
 You still can click on the imach.exe icon (which opens a DOS window)  file which is also a text file.
 and drag your parameter file into the DOS windows and enter  
 return. But with the newly installable version (>0.97) you can use the right  Even if it is command line program, most operating systems offer
 click (once your mouse cursor is on an foo.imach file) to either edit the  simplifications of use:
 parameter file (with wordpad) or execute this parameter file via  
 imach.  - On Windows, you can click on the imach.exe icon (which opens a DOS
 If the program runs well you get a main foo.htm file which can be viewed  window) and drag your parameter file into the DOS windows and enter
 with your browser and which includes all the results.  return. You can use the right click (once your mouse cursor is on an
   foo.imach file) to either edit the parameter file (with notepad) or
 As the program output a file named foo.gp which is executed by gnuplot  execute this parameter file via imach. At the end of the run, your are
 in order to draw all the graphs, you can edit it and customize it at  asked to enter a character and the terminal will not disappear.
 your will.  
   - On OSX, you can click on the IMaCh application and a terminal window will be
 By default the file gnuplot.exe is located on the same directory as    opened: either type in the name and path of your parameter file or
 imach and is used by imach with its absolute path. Thus if you have    drag it from the finder.
 another gnuplot program which is in your path it will not be used by  
   The output of your run consists in many text files which are grouped
   into a sub-directory having the same name as of your parameter
   filename 'foo'. In addition, you will find two other important files
   on the same directory as your parameter file:
   
   -1- a text file named 'foo.gp' which is a gnuplot file. This gnuplot
   is automatically runned by imach in order to create the graphs from
   the various result text files.
   
   You can edit this gnuplot file, customize it at your will and run it
   to get additional figures or modified figures to be published. Just
   click on gnuplot executable and type "load foo.gp" for example.
   
   Gnuplot is a well known grapher under the GPL license too. As it is
   changing often, the OS/X and Windows installers are providing binaries
   for gnuplot 2.6.5.
   
   -2- a text file named 'foo.htm' which is an html file. It can be
   opened by your browser and it will display various hyperlinks to most
   of your results as well as your graphs.
   
   
   Since the era of 64bit processors and their wide use on OS/X and
   Windows 7, 8 or 10, we discovered that our usual GNU compiler were not
   efficient on Windows 64 and current binaries are compiled with the
   Intel C compiler.  On OS/X the native LLVM C compiler from Apple is
   very efficient too.
   
   Usually IMaCh binaries are distributed under two subdirectories, 'bin'
   for the binaries which are imach.exe and gnuplot.exe and 'html' for
   some of the documentation, and 'mytry' in order to test the program on
   a parameter file named 'mypar.imach'. In order to use IMaCh, you need
   two text files, one is called the parameter file with extension .imach
   or .txt which contains few lines and the data file which can be juge
   according to the number of people surveyed.  You can find in the
   subdirectory doc of your installed package, some testing files like
   biaspar.imach and mypar.imach . If you edit such a parameter file, you
   will see a link to the data file, for exemple data1.txt . You can copy
   both files, parameter and data file into a private directory. Then run
   imach and drag the parameter file.
   
   You can access to the main IMaCh server at
   http://euroreves.ined.fr/imach but the main documentation is a wiki at
   http://euroreves.ined.fr/imach/wiki .  You can download the latest versions
   at http://euroreves.ined.fr/imach/Download .
   
   By default the file 'gnuplot.exe' is located on the same directory as
   imach and is used by imach with its absolute path. Thus, if you have
   another gnuplot program which is already in your path it will not be used by
 imach (we tried to simplify the installation process).  imach (we tried to simplify the installation process).
   
 If you download a newer version of IMaCh you are supposed to Uninstall the  If you download a newer version of IMaCh, you are supposed to Uninstall the
 former version with the standard Install/Uninstall process of Windows.  former version with the standard Install/Uninstall process of Windows.
   
 The Windows version is compiled via cygwin (gcc -mno-cygwin -o imach  
 imach.c). It can be used on a command line with the command "imach  
 foo.imach". But then imach.exe must be in your path.  
 The program can be used (with more comfort?) on Linux or on a  
 MacIntosh.  
   
 Enjoy (?) using IMaCh.  Enjoy (?) using IMaCh.
   
 You may subscribe to imach-users@listes.ined.fr by sending a mail at  You may subscribe to imach-users@listes.ined.fr by sending a mail at
 imach-users-subscribe@listes.ined.fr and you can unsubscribe with a  imach-users-subscribe@listes.ined.fr and you can unsubscribe with a
 mail to imach-users-unsubscribe@listes.ined.fr .  mail to imach-users-unsubscribe@listes.ined.fr .
   
   Other comments are included on the Wiki server
   http://euroreves.ined.fr/imach/wiki, please use it ask questions too.
   
 Nicolas Brouard (brouard at ined point fr)  Nicolas Brouard (brouard at ined point fr)
 Agnès Lièvre (lievre chez ined dot fr)  Institut national d'études démographiques
 Christopher Heathcote  133 Boulevard Davout
   75014 Paris
   
   Earlier versions were also written by
   Agnès Lièvre (former PHD student at INED)
   Christopher Heathcote (ANU)
   
     
   
Removed from v.1.1  
changed lines
  Added in v.1.9

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