Setting up the code
To execute the code as a stand-alone
program
To run a grid of models
Revision History
Mailing list
Comments or suggestions?
Instructions are now totally web-based since this insures the most up-to-date advice.
Instructions for downloading the files, and an overview of setting things up, are located at http://nimbus.pa.uky.edu/cloudy/cloudy_96.htm
Incorporate any hot fixes after downloading the files. Hot fixes are a set of corrections that must be made to the distributed source. They are listed on the hot fixes page of the web site, http://nimbus.pa.uky.edu/cloudy/hotfix_96.htm . The downloaded source was used to generate the test output on the web site and did not include these hotfixes.
Compile the code using an ANSI standard C compiler. Instructions are at http://nimbus.pa.uky.edu/Cloudy/compiling_96.htm
Compile the stellar atmosphere grids if they will be used. Continua from several sets of stellar atmospheres can be automatically accessed by the code. See Stellar Atmospheres in C96 for more details. This is described further in the read me file located within the data directory.
Run the test cases. Cloudy is designed to be autonomous and self-aware. The code uses extensive self-checking to insure that the results are valid. Many of these tests include assert commands in the input stream or in the C source code. If anything goes wrong the code will announce this at the end of the calculation. Details are given at the main C96 site, http://nimbus.pa.uky.edu/cloudy/cloudy_96.htm The distributed set of test case files includes a read me, the input files themselves, and Perl scripts to execute the files and verify their results. This is described further in the read me file located within the tests directory.
From the command line the code would be executed as follows, if the executable is called cloudy.exe:
cloudy.exe < input_file > output_file
In this example commands are read in from the file "input_ file" and results are sent to the file "output_ file". A typical input file is the series of commands written one per line in free format:
title typical input stream
blackbody 120,000K
luminosity 37
radius 17
hden 4
Often the most insight is gained from producing a large number of models with various input parameters changing, to see how predicted quantities change as a result. To do this you want to write your own main program, and delete the one that comes with the distribution.
In the distribution this is the file maincl.c. Delete this file (or rename it to something like maincl.old) , and also delete maincl.o if you compiled the entire distribution.
You will need to compile the rest of the code, generating *.o files, then compile the new main program, and link it all together. Note that in C the main program must be called main, but it can live in a file with any name. All of the routines you need to access are declared in the header file cddrive.h. Include this file with your main. That header also describes how the various driving routines should be called.
This is maintained in the web site, http://nimbus.pa.uky.edu/cloudy/cloudy_94_revision_history.htm . This is a complete history of changes to the active version of the code.
To be placed on the Cloudy mailing list and be notified of updates to the code, please send a request to garyl@cloud9.pa.uky.edu The Cloudy home page http://www.pa.uky.edu/~gary/cloudy also has an option to place yourself on the mailing list. It is important to be on this list and that the current version of the code, with hot fixes included, be used. Anything as complex as Cloudy must contain bugs. These are fixed as soon as they are found.
Please send comments or suggestions to Gary Ferland at gary@cloud9.pa.uky.edu
Visit http://nimbus.pa.uky.edu/cloudy for details and latest updates.
Good luck,
Gary J. Ferland