CPPSIMU – output files

Spectra

The parameter file determines what spectra are calculated and how they are saved. There are three possibilities for the output format: an ascii file, a binary file and a FITS-file.

Ascii spectra are written if the keyword ascii was given in the parameter file and transitions were defined with keyword spectra. Each spectrum is written into a separate file. The name of a file is formed from the prefix given with prefix, the name of the molecule and the transition. A file could be named e.g. test.co02-01.000.spe – test is the given prefix, co the name of the molecule, transition is J=2-1, 000 is a running index for different spectra of the same transition and .spe is the default suffix. The file itself contains two columns: the velocity in km/s and the corresponding antenna temperature.

Binary files are written if the keyword binary was given in the parameter file. The file begins with a 4 byte integers giving the number spectra in the spectrum map and the number of channels in the file. This is followed by the velocity (km/s) of the first channel and the channel width (km/s) as 4 byte floating point numbers. This is followed by the spectra. For each spectrum the position in the map is given as two floating point numbers (4 bytes each), followed by the antenna temperature values for each channel. The spectra in a map are saved in an increasing order of RA and DEC with DEC changing fastest. In the case of the previous example all spectra would be saved into file test.co02-01.bin.

If keyword fits  is given (instead of ascii or binary) all spectra are written into separate FITS-files. The files are named according to the same scheme as the ascii files except for the suffix which is ‘.s‘.

Excitation temperatures

The parameter file determines for what transitions the excitation temperatures are calculated and how they are saved. There are three possibilities for the output format: an ascii file, a binary file and a FITS-file.

Tex files are written if keywords prefix and transitions are given in the parameter file as well as one of the following: ascii, binary, fits. The name of a file is formed from the prefix, the name of the molecule and transition. A file could be named e.g. test.co02-01.tex – test is the given prefix, co the name of the molecule, transition is J=2-1 and spe is the default suffix.

The ascii files contains five columns: three indices of the cell, the excitation temperature in Kelvins and the distance from the cloud centre in centimeters. For 1D cloud the second and the third columns are all zeros; for 2D clouds only the third column is zeros.

Binary files are written if the keyword binary is given in the parameter file. The file contains the excitation temperatures (4 byte floats) for each cell. For 3D clouds the order is (x,y,z) with the first coordinate running fastest; for 2D clouds from centre outwards, one plane at a time; for 1D clouds the shells starting from the centre. (Note: if cppsimu is compiled with the option DINTEL the byte order is reversed (1234>4321) on writing.)

If keyword fits is given the excitation temperatures are written into FITS-files. The naming conventions are as above, the suffix is '.t'.

cppsimu.err

The file cppsimu.err contains all error messages from the latest run. It contains also most of the output that is written to stout during the program execution

scaled_cloud.dat

For runs with a 1D cloud models the file scaled_cloud.dat contains densities, kinetic temperatures etc. after they were scaled as specified by the various keywords in the ini-file. The order of the columns is the same as in the cloud description of a 1D model.