Changes between Initial Version and Version 1 of StepByStep

2007-02-25T16:08:09Z (13 years ago)
Gary J. Ferland



  • StepByStep

    v1 v1  
     1= Step by step instructions for installing Cloudy =
     3This page contains instructions for installing the current stable version of Cloudy. The code is installed in a series of steps:  a) download the files into separate directories, b) edit the file "path.cpp" to tell the code where the atomic data are located, c) compile the source, d) run the smoke test, the single command "test", e) download and compile any ancillary stellar continua you want to use, f) run the test suite in tsuite/auto to verify that your system works, and finally g) apply any hot fixes.
     5Hazy, the code's documentation, is included in the download.   You can obtain a copy of Hazy [ here] if that is all that you need.  Otherwise obtain the full download as described below.
     7Each version of the code has a set of pages giving updates.  The Hot Fixes page will list corrections that need to be made to the downloaded source.  These are bug fixes that were not included in the version of the code used to generate the output from the test suite.  So the hot fixes should be applied after the test suite has been run and your system validated.  A problems page will list known problems with that version of the code.  The revision history page lists improvements.
     8Cite the code by giving the version number and a reference to the last major review of Cloudy, Ferland et al. (1998; PASP, 110, 761, available here).  An example would be “We used version 05.07b of Cloudy, last described by Ferland et al. (1998)”.  Then, years from now, when someone wants to know how an answer was obtained, the version used to obtain it can be retrieved from the old versions part of this web site.
     10To set up the code follow the following steps
     12Setting up this version
     14Follow these steps to set up the code.
     16   1. Download the code, data, and documentation. This creates several directories,  Each contains a readme.htm file describing the contents of that directory.
     17   2. Edit path.c to tell the code where the data files are located.
     18   3. Compile the code.
     19   4. This explains how to execute the code and run a smoke test.
     20   5. You must compile some stellar data files if you want to use the some of the table star command to include realistic stellar continua.
     21   6. Download and run the test suite to confirm that all is well.  This is a critical step since it will check for bugs in your compiler.  That directory also contains a group of programs that show how to call the code as a subroutine.
     22   7. Hot Fixes  A set of corrections to the source, which will be incorporated in the next incremental upgrade, are listed in the Hot Fixes page. It is very important that you edit the source to incorporate these hot fixes since they correct known problems. The source you obtain here does not have any of these these fixes included. (Reason: this is the source that created the output files that are downloaded with the test suite.  You can validate your system/compiler by confirming that this source reproduces that output.  This source and output constitute a reference for where the code was at a particular time.)
     23   8. Known problems with this version are described here.
     25A diversion
     27While doing all that downloading/compiling/testing you might be interested in hearing Cloudy's favorite song in mp3 format (from Simon & Garfunkel's Parsley, Sage, Rosemary and Thyme).