Setting up c94
Home Up Other versions Revision history The future etcetera Acknowledgements Contacts, Mailing list Links Site map, search




File formats
Hazy, the documentation for Cloudy
Getting the source and creating the executable
The test cases
Stellar atmospheres in Cloudy
Cloudy's favorite song

This is the current version of Cloudy.  Instructions for downloading the source and atomic data, setting up the executable, and compiling the ancillary star files, are given in links at the bottom of this page.  

The two papers that will appear in ADASS99 ( postscript or pdf ) and the Mexico 1999 Plasma meeting (postscript ) form the definition of C94. A set of notes concerning the conversion from Fortran to C is given here.

The Cloudy 94 Revision History lists changes that have occurred in this version of the code.  The source downloaded here does not include the Hot Fixes, which much be manually added.

If you have trouble with accessing this site with your browser, you can still get the files by anonymous ftp.  The site is, and you should cd to gary.  Files are in subdirectories. 

File formats

bulletFiles are grouped together by a common theme - all volumes of the documentation Hazy are packaged together, all the stellar atmosphere files are together, the source files, and the test cases.
bulletThe files are in tar'd and gziped format.  Uncompress the individual files (example: gunzip filename.tar) then untar the file with the command tar -xvf filename.tar. PC users: WinZip will do both steps with a double mouse click.
bulletThe documentation is available as either PDF or postscript
bulletThe PDF files require version 3 or later.  You can get a free viewer from Adobe.  
bulletThe postscript files were created with MS Word using the current Adobe postscript driver.  Most were gzip'd.  They are viewable with my version of gsviewUnix users:  if you cannot view the postscript files it is almost certainly because you need to update your viewer.  The gv viewer always seems to work.  The files almost always print ok even when you can't view them.

Hazy, the Documentation for Cloudy

bulletThe 1997 version of Hazy with updates is the current  description of Cloudy 94.  The change from Fortran to C will be an unwelcome culture shock for older people  (I wrote my first FORTRAN program while the Apollo XII astronauts were on the moon) and a welcome relief for graduate students.  Every effort has been made to not also change the functionality of the code, and to keep the atomic data base parallel between 90 and 94, at least initially.  Input scripts that worked for C90 will work for C94.00 with only a few changes, and predictions of the two versions should agree fairly well. Hazy will be updated in summer 2000.  
bulletHazy comes in four volumes. Vol. 1 gives a discussion of the commands, Vol. 2 of the numerical procedures, Vol. 3 of the machine environment, and Vol. 4 describes the output and how it relates to observations.   Last changed 1997 Oct 26. Hazy is available in the following formats:
bulletPDF:  The four volumes can be obtained as a set of Adobe Acrobat files packed into a single tar file. It may be necessary to obtain a PDF Reader,  free from Adobe. This file is tar'd but not compressed.
bulletPostscript:  A second gziped tar file contains a complete set of postscript files. Please read the included file if this format is chosen, since a high-end postscript printer is needed. 

Cloudy, getting the source and creating the executable

bulletThe current version is C94.00.  Get it here.  This also shows how to set up the code.  Last changed 1999 Dec 24.
bulletHot 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 listed below.  You can validate your system/compiler by confirming that this source reproduces that output.  This source and output constitutes a reference for where the code was at a particular time.)
bulletKnown problems with this version are described here.
bulletThe revision history page gives a complete list to revisions to the code.

The test cases

bulletReliability in the face of complexity is the real challenge of software development.
bulletTest cases input This file contains the suite of test cases I use to verify the behavior of the code in well-documented cases. They are discussed in Vol. 3 of Hazy. This file should be untar'd in its own directory since it will explode into a large number of input files.  Last changed 1999 Dec 24.
bulletRunning the test cases  The input files have names that end in ".in".  The code should be executed with this as the input file.  I have scripts that direct output to the same name, but with the ".out" extension.  An example would be 
cloudy.exe < > parispn.out
where cloudy.exe is the executable, and and parispn.out are the input and output files.  The test cases input tar file includes Perl script, to run all tests in the current directory.  The script then checks that they ended successfully. 
bulletTest cases output These files contain the results of the suite of test cases I use to verify the behavior of the code in well-documented cases. These tar files contain only the resulting output. Results are available for five platforms, PC (NT, Visual Studio 6 SR3, PC end of lines), HP SPP, Alpha, gcc/Intel, and Sparc. Note that the code that generated this output did not have the hot fixes included.  Last changed 1999 Dec 24.

Stellar atmospheres in Cloudy

bulletKevin Volk incorporated several large grids of stellar atmosphere emergent continua into Cloudy. These can be used as part of the incident continuum with the table stars Werner, table star Rauch, table stars CoStar, or table stars atlas commands, as described in Part 1 of Hazy.  It is necessary to download and compile several files if these stellar atmospheres are to be used.  Play by play instructions for setting up the stellar atmospheres are given here.

While doing all that downloading you might be interested in Cloudy's favorite song in mp3 format (from Simon & Garfunkel's Parsley, Sage, Rosemary and Thyme).

Please let me know of any problems you encounter or suggestions for how to improve the code and these instructions.  
, to the many people who have helped me with Cloudy.
I  maintain a  mailing list of anyone interested in being notified about new or revised versions.

Hit Counter
Last changed 04/02/03.
Return to the Cloudy Home Page.
Copyright 1978-2003 Gary J. Ferland