Running Damocles

Running Damocles

Once installed, the command damocles will execute from any directory where an input directory is present and contains the required files. The default list of input files required by Damocles and the variables they contain can be found here. An output directory must also be present.

Please take note of the key concepts described below. They are common questions and your life will be easier if you note them now!

Set-up

Each input file contains a list of variable parameters. All parameters must always have a variable associated with them. In general, these variables are either boolean, floats or integers. Descriptions of each variable are contained within the input files for easy reference. Further details can be found here.

Run

Once all parameters in the input files have been specified (and checked!), then Damocles can be run by typing:

damocles

If running correctly, the following text should be printed to terminal:

 reading input from file input/input.in...
 calculating opacities...
 constructing grid...
 constructing frequency grid...
 building emissivity distribution...
 propagating packets...
 writing to file...
 complete!

Output

All output files will be saved to the output directory where they can then be used for visualisation. For further details, please see the output files pages.

Key concepts

• There is no actual gas in the model - the gas density distribution is used only to specify the initial emissivity distribution which determines where packets are emitted
• Damocles does not conserve energy or solve the full radiative transfer equation since only a narrow range of wavelength space is of interest and dust optical properties are temperature independent
• Dust and gas may be coupled or decoupled - if they are coupled then parameters specified in the dust.in file take precedence over the gas.in file
• By default, velocity is specified as a power of radius but there is a flag that allows for random velocities to be sampled from a power-law distribution independent of radius
• There is a flag in the input folder that controls whether output files are overwritten or written to a new directory with each run
• Input file names can be changed in the input.in file but this documentation will refer to default file names