Project

General

Profile

Run TIPS under configuration

In this page we describe the format of the TIPS configuration file.

Usage

All the configuration is in a fits file (used more or less as a database).
The first HDU (#0) contain the metadata, the other hdu contain the data like the sensitivity or the noise map.
You can load the configuration file with the method loadFromFile:

obs = tips.Observation("Input_cat.fits", "Input_spc.fits")
obs.loadFromFile("configuration_files.fits")
obs.runSimulation(workDir="./directory")

The method can also take in argument the exposure time and the pointing.
In that that case, the value in argument overwrite the value in the configuration file.
obs.loadFromFile("configuration_files.fits", exptime=42., ra0=4.2, dec0=4.2)

Description of the configuration file

The metadata

The metadata in the header of the HDU 0 and EXPO#
This HDUs do not contain any data.
In that section, we describe the keyword used to set the simulation.

Description of the telescope (HDU0)

'VERSION' [int] version of the configuration file
'MODEL' [int] instrument model (baseline for example)
'DATE' [int] date of creation DDMMYY
'TELAREA' [cm2]
'INSTRU' [string] name of the instrument
'RA0' [deg] initial rigth ascension (lower left corner of the lower left detector ie [0,0] in pixel coordinates)
'DEC0' [deg] initial declination (lower left corner of the lower left detector ie [0,0] in pixel coordinates)
'ORIENTAT0' [deg] (optional) initial orientation (use it carefully, not fully implemented in the code right now)

Description of the detectors (HDU0)

'NDETX' [int] number of detector along x
'NDETY' [int] number of detector along y
(total number of detector = 'NDETX' x 'NDETY'
'XSTEP' [um] step between detectors along x
'YSTEP' [um] step between detectors along y
'NPIXX' [int] number of pixel along x per detector
'NPIXY' [int] number of pixel along y per detector
'NBIT' [int] (optinal) number of bit used to encode the detector value
'REJECT' [string] (optinal) rejection mode (see Cosmic)
'PIXSCALE' [arcsec] pixel scale
'PIXSIZE' [um] pixel size
'RN' [electron/pix] read out noise
'RN' [string] reference to the HDU of the RN map
'DC' [electron/s/pix] dark current
'DC' [string] reference to the HDU of the DC map
'QE' [float] quantum efficiency
'QE' [string] reference to the HDU of the QE map

The read out noise, the dark current, the quantum efficiency could be define independently per detector.
'RN##' read out noise of the detector ##
'DC##' dark current of the detector ##
'QE##' quantum efficiency of the detector ##

See User_guide for more details on the detector numeration.

Reference to the exposures (HDU0)

NEXPO [int] number of exposure
EXPO# [string] reference to the HDU containing the metadata of the exposure #

If NEXPO is not define, only 1 exposure will be simulate and the EXPO0 will be HDU0 (that keep the compatibility with the previous configuration files).

Description of the exposures (EXPO#)

'CAMERA' [string] name of camera, grism or filter
'EXPTIME' [s] exposure time
'SKYBCK' [photon/s/pix] (optional) sky background
'SKYBCK' [string] (optional) reference to the HDU of sky background image

Description of the instrument configuration (EXPO#)

'DITRA' [float] dither in RA direction in degree
'DITDEC' [float] dither in DEC direction in degree

Take care, the dither is applyed BEFORE the simulation of the exposure.

'ROT90' [bool] is True rotate the grism dispersion direction of 90 deg
'PSFWAVE' [nm] reference wavelength for the PSF
'PSFSIG1' [arcsec] (optional) first gaussian component of the global PSF
'PSFSIG2' [arcsec] (optional) second gaussian component of the global PSF
'PSFC' [float] (optional) ratio between the two gaussian component

See PSF for more details on the PSF model

'NBEAM' [int] number of dispersion order

'BEAMID#' [int] identifier of the beam #
'BSTART#' [pixel] trace first pixel of the beam #
'BEND#' [pixel] trace last pixel of the beam #
'ODYDX#' [int] order of the dydx function of the beam #
'DYDX#_%' [float] parameter of the % of the dydx function of the beam #
'ODLDP#' [int] order of the dldp function of the beam #
'DLDP#_%' [float] parameter % of the dydx function of the beam #
'XOFF#' [pixel] x offset
'YOFF#' [pixel] y offset
'PSFSIG1#' [arcsec]] (optional) first gaussian component of the beam PSF
'PSFSIG2#' [arcsec] (optional) second gaussian component of the beam PSF
'PSFC#' [float] (optional) ratio between the two gaussian component (see PSF)
'SENS#' [string] reference to the HDU of the senstivity

See aXe documentation for more details on the beam definition.

'COSMAP' [string] reference to the HDU of the cosmic map

The cosmic map could be define independently per detector.
'COSMAP##' cosmic map of the detector ##

The data

The sensitivity HDU

The sensitivity is a table of 3 columns:
'WAVELENGTH' [A] wavelength
'SENSITIVITY' [photon/(erg/s/cm2/A)] sensitivity
'ERROR' [photon/(erg/s/cm2/A)] error on sensitivity

The header contains:
'VERSION' [int] version of the sensitivity file
'DATE' [int] date of creation DDMMYY

The map HDU

The map HDU is an image (size of the detector).
Each pixel of the image contain the value of the detector property described for the pixel.

The header contains:
'VERSION' [int] version of the sensitivity file
'DATE' [int] date of creation DDMMYY