Grid Tools

C.S.Jeffery  2004

A series of  tools for generating, checking and maintaining the Armagh grid of model atmospheres and synthetic spectra.

grid_sterne

To set up and compute a grid of model atmospheres. Jobs are distributed across a Condor cluster.

Edit grid_sterne.condor and make sure the data lines define the grid you want to calculate..

> ./grid_sterne <grid_label> [ <tg_grid> [ <option> ] ]

<grid_label>  is the label of the grid you want to run.
<tg_grid> is the identifier for the Teff,log g grid and overrides the definition assumed by <grid_label>.  The value "default" should be used if an additional <option> is required and the standard grid value is to be assumed.
<option> enables the user to attempt to complete nono-convreged models only. Two options are enabled:

update        Compute models for which a "converged" flag does not exist (see grid_check)
complete    Compute models for which a "converged" flag does not exist from a converged model with higher gravity.

grid_spectrum

To compute a grid of synthetic spectra. Jobs are distributed across a Condor cluster.

Edit grid_spectrum.condor and make sure the data lines define the grid you want to calculate..

> ./grid_spectrum <grid_label> [ <wl_range> [ <option> ] ]

<grid_label>  is the label of the grid you want to run.
<wl_range> is the identifier for the wavelength range and linelists combination. The default value is "blue". Other options (some still to be implemented) are :
optical, red, CaT, iue_sw, iue_lw, stis, fuse

grid_check

To check which models converged ...

> ./grid_check <grid_label> <device>

<grid_label> is the label for the grid you want to check
<device>is the name of the device on which you want to plot models. Allowed devices are "xw" and "pscol_l"

This function creates a file for any model which is found to have converged, with the extension ".cnv" It also deletes any such file attached to any model which has not converged.

grid_index

To refresh the web page attached to any of the standard grids ...

> ./grid_index <grid_label>

<grid_label> is the label of the grid you want to  construct an index for.

grid_tidy

To clean out unneeded files associated with a given grid ...

> ./grid_tidy <grid_label>

<grid_label> is the label of the grid you want to clean out.

This function currently removes all the files associated with Condor jobs used to construct models within that grid. It will also remove files in the model folders which are not necessary outputs, i.e. no longer necessary once model grid has been verified and approved.


Kernel Scripts

Sterne_Condor

Runs the individual Sterne jobs on a single node in the Condor cluster. Will also run as standalone if given the correct argument list.

Spectrum_Condor

Runs the individual Spectrum jobs on a single node in the Condor cluster. Will also run as standalone if given the correct argument list.


Minor Tools

grid_code

grid_code returns an index number <grid_code> corresponding to a given <grid_label>. It is used by GenGrid and IndexBuild. 

> gridtools/grid_code <grid_label>

check_output

GridCheck actually read a model grid folder and lists all the "<model>.summary" files therein. For each <model>, it then runs a job

> gridtools/check_output <model> <device>

which provides plot of  the temperature corrections and flux errors throughout the final model and also assesses the maximum values of these to detemine convergence. The criterion is DF/F < 1% throughout the model and DT/T < 1K for layer >15. The latter is determined using an F90  programme

check _summary

which reads a file called SUMMARY and, if convergence is obtained, creates a file called CONV. SymLinks are used to connect "<model>.summary" to SUMMARY and, if CONV is created, this is mv'ed to "<model>.cnv" by check_ouput


This page is maintained by: 
Simon Jeffery (csj@star.arm.ac.uk
Last modified: 12 May 2004