astro.toolbox.photometry package

Submodules

astro.toolbox.photometry.extcurve_generator module

astro.toolbox.photometry.ingest_extinction module


CATEGORY : tools, photometry.

PURPOSE : generating valid entries for extinction coefficients into the DB.


This tool is used to insert AtmosphericExtinctionCoefficient objects into the database for a specified filter.

The tool assumes that a database is active; it actively queries the database for the requested filter.


Mandatory parameters :

-e : extinction coefficient
-err : error on extinction coefficient (1 sigma?)
-f : filter name
-i : instrument name

-start : start of validity range in yyyy-mm-dd (timestamp_start) -end : end of validity range in yyyy-mm-dd (timestamp_end)

Optional parameter :

-commit : commit result to the database

Examples of use :

awe ingest_extinction.py -e 0.46 -f #877 -i WFI -commit -start 2003-02-11
-end 2003-02-12

astro.toolbox.photometry.ingest_extinction.create_timestamps(start, end)
astro.toolbox.photometry.ingest_extinction.main()
astro.toolbox.photometry.ingest_extinction.make_extinctioncoefficients(extinction_value, extinction_value_error, filter_name, instrument_name, start, end, commit=0)
astro.toolbox.photometry.ingest_extinction.parse_command_line()
astro.toolbox.photometry.ingest_extinction.retrieve_chip_from_database(chip_name)
astro.toolbox.photometry.ingest_extinction.retrieve_chip_list(instrument_name)
astro.toolbox.photometry.ingest_extinction.retrieve_from_database(filter_name, instrument_name)
astro.toolbox.photometry.ingest_extinction.usage()

astro.toolbox.photometry.ingest_gain module

astro.toolbox.photometry.ingest_illuminationmap module


CATEGORY : tools, photometry

PURPOSE : ingesting an illumination correction map into the database


This tool is used to ingest an illumination correction map into the database.

The data content of the map is read in from an input ASCII-file. This input ASCII-file must contain exactly seven columns (in this order):

chip name, C_0, C_x, C_y, C_xx, C_xy, C_yy

with one line for every chip included in the map. The C_a are the coefficients in the fitting formula :

z(X, Y) = C_0 + C_x*X + C_y*Y + C_xx*X*X + C_xy*X*Y + C_yy*Y*Y

with z(X, Y) the zeropoint as a function of pixel-position (X, Y).

The tool assumes that a database is active; it actively queries the database for the requested filter and instrument.

The illumination correction table will after creation only be committed to the database if the “-commit” switch was set on the command line.


Mandatory parameters :

-i : input ASCII file
-f : filter name

-instr : instrument name -start : start of validity range in yyyy-mm-dd (timestamp_start) -end : end of validity range in yyyy-mm-dd (timestamp_end)

Optional parameter :

-commit : commit the illumination correction map to the database
Example : make an illumination correction map for the INT g’ filter, and
commit the result to the database. The table is valid from 1 Jan 2000 until 1 Jan 2005.
Command : awe ingest_illuminationmap.py -i wfc.txt -f 220 -instr WFC
-commit -start 2000-01-01 -end 2005-01-01

astro.toolbox.photometry.ingest_illuminationmap.create_timestamps(start, end)
astro.toolbox.photometry.ingest_illuminationmap.main()
astro.toolbox.photometry.ingest_illuminationmap.make_illuminationmap(input_file, filter_name, instrument_name, start, end, commit)
astro.toolbox.photometry.ingest_illuminationmap.parse_command_line()
astro.toolbox.photometry.ingest_illuminationmap.read_contents_of_input_file(input_file)
astro.toolbox.photometry.ingest_illuminationmap.retrieve_from_database(filter_name, instrument_name)
astro.toolbox.photometry.ingest_illuminationmap.usage()

astro.toolbox.photometry.ingest_photometrics module


CATEGORY : tools, photometry.

PURPOSE : generating a valid Calfile 563 that is used in photometric
calibration.

This tool is used to ingest a Calfile 563 into the database that contains a default value for the zeropoint and the atmospheric extinction. This Calfile is produced for the chip, filter and instrument specified on the commandline. The values for the zeropoint and the extinction should be given on the commandline. Optionally, an error on the zeropoint can also be given.

The tool assumes that a database is active; it actively queries the database for the requested chip, filter and instrument.

The photometric CalFile will after creation only be committed to the database if the “-commit” switch was set on the commandline.


Mandatory parameters :

-z : value of the zeropoint
-e : value of the extinction coefficient
-c : chip name
-f : filter name
-i : instrument name

-start : start of validity range in yyyy-mm-dd (timestamp_start) -end : end of validity range in yyyy-mm-dd (timestamp_end)

Optional parameters :

-ze : error of the zeropoint (default : 0.00)

-commit : commit result to the database

Example of use :

awe ingest_photometrics.py -z 25.12 -ze 0.04 -e 0.19 -c A5382-1-7
-f 220 -i WFC -commit -start 1990-01-01 -end 2030-01-01

astro.toolbox.photometry.ingest_photometrics.create_timestamps(start, end)
astro.toolbox.photometry.ingest_photometrics.main()
astro.toolbox.photometry.ingest_photometrics.make_photometricparameters(zeropoint_value, zeropoint_error, extinction_value, chip_name, filter_name, instrument_name, start, end, commit=0)
astro.toolbox.photometry.ingest_photometrics.parse_command_line()
astro.toolbox.photometry.ingest_photometrics.retrieve_from_database(chip_name, filter_name, instrument_name)
astro.toolbox.photometry.ingest_photometrics.usage()

astro.toolbox.photometry.ingest_transformation module


CATEGORY : tools, photometry

PURPOSE : ingesting a transformation table into the database.


This tool is used to create a transformation table in the database for a given filter and instrument.

The transformation table will after creation only be committed to the database if the “-commit” switch was set on the command line.


Mandatory parameters :

-p : the primary band (eg JohnsonB)
-s : the secondary band (eg JohnsonB)
-t : the tertiary band (eg JohnsonV)
-ct : the value for the color term (eg 0.050)
-cte : the value for the color term error (eg 0.005)
-d : the value for the coefficient (eg 0.400)
-de : the value for the coefficient errorr (eg 0.005)
-f : filter name
-i : instrument name

-start : start of validity range in yyyy-mm-dd (timestamp_start) -end : end of validity range in yyyy-mm-dd (timestamp_end)

Optional parameter :

-commit : commit the transformation table to the database
Example : make a transformation table for the WFI broad-band V filter, and commit
the result to the database. The table is valid from 1 Jan 2000 until 1 Jan 2005.
Command : awe ingest_transformation.py -p JohnsonB -s JohnsonB -t Johnson V
-ct 0.10 -cte 0.01 -d 0.40 -de 0.01 -f #843 -i WFI -start 2000-01-01 -end 2005-01-01 -commit

astro.toolbox.photometry.ingest_transformation.check_validity_of_filter_and_instrument(filter_name, instrument_name)
astro.toolbox.photometry.ingest_transformation.check_validity_of_input_bands(primary, secondary, tertiary)
astro.toolbox.photometry.ingest_transformation.create_timestamps(start, end)
astro.toolbox.photometry.ingest_transformation.ingest_transformation(primary, secondary, tertiary, color_term, color_term_error, coefficient, coefficient_error, filter_name, instrument_name, start, end, commit=0)
astro.toolbox.photometry.ingest_transformation.main()
astro.toolbox.photometry.ingest_transformation.parse_command_line()
astro.toolbox.photometry.ingest_transformation.retrieve_from_database(filter_name, instrument_name)
astro.toolbox.photometry.ingest_transformation.usage()

astro.toolbox.photometry.sdss2refcat module

astro.toolbox.photometry.sdss2refcat_wrapper module

astro.toolbox.photometry.skybrightness_generator module

astro.toolbox.photometry.transformations module

astro.toolbox.photometry.transformations.UBVRI_to_ugriz_Jester(jU=None, jB=None, jV=None, cR=None, cI=None, djU=None, djB=None, djV=None, dcR=None, dcI=None)

Based upon Jester et al transformations listed at: http://www.sdss.org/dr5/algorithms/sdssUBVRITransform.html Note: UBVRI mag errors need to be propagated.

astro.toolbox.photometry.transformations.UBVRI_to_ugrizprimed_Smith(U=None, B=None, V=None, R=None, I=None)
astro.toolbox.photometry.transformations.ugriz_to_UBVRI_Jester(su=None, sg=None, sr=None, si=None, sz=None)

Based upon Jester et al transformations listed at: http://www.sdss.org/dr5/algorithms/sdssUBVRITransform.html Note: ugriz mag errors need to be propagated.

astro.toolbox.photometry.transformations.ugriz_to_UBVRI_Lupton(u=None, g=None, r=None, i=None, z=None)
astro.toolbox.photometry.transformations.ugriz_to_UBVRI_Smith(u=None, g=None, r=None, i=None, z=None)
astro.toolbox.photometry.transformations.ugrizprimed_to_UBVRI_Smith(u=None, g=None, r=None, i=None, z=None)
astro.toolbox.photometry.transformations.ugrizprimed_to_ugriz(up=None, gp=None, rp=None, ip=None, zp=None)

See http://www.sdss.org/dr5/algorithms/jeg_photometric_eq_dr1.html#usno2SDSS

Module contents

This directory contains tools for the setup of the photometric pipeline.