Documentation of Deepsearch Software

This documentation will hopefully be kept up to date by R.Knop ( and all others maintaining it.... Most of it does not as yet exist. The list below is an optimistic menu of what will hopefully be available eventually.

Deepsearch software for the astronomical user

If you want to use our software to load and display images, find images, measure statistics or stars on images, then this section should get you started.

General Overview
Setting up
What procedures are necessary to get your account set up to run the deepsearch software, as well as an introduction to where to find yourself an introduction to IDL.

Customizing the Startup
How to insert your own cutomized IDL startup into the deepsearch startup. (Do not replace or subvert the standard deepsearch startup... please read this if you want to customize your startup.)

Images and the Database
An overview of what our "database" (including the many gigabytes of images, as well as the database proper) includes, and where all of this is. Additional information on the implicit assumptions for images in our database.

Additionally, see the current version of the Deepsearch Data Reduction Manual, available as a Postscript file (1.3MB) or as a PDF file (440K). This is an attempt at a complete manual for data reduction. The first few chapters are about "standard" data reduction procedures, and for the most part will not be of use to an experienced astronomer; there are only one or two quirks (e.g. gain multiplication) that are non-standard for the Deepsearch. The last chapter attempts to document everything which is necessary in order to get images loaded into the Deepsearch database for use by Deepsearch software.

The Deepsearch Database
Most people shouldn't have to read this. Read Images and the Database instead.

Image names
The naming scheme of deepsearch images.

Conceptual overview
Some of the most important common blocks and data structures you will be interacting with in order to use the deepsearch software.

Display and Colors
Some information about how the Deepsearch software handles IDL dislplays, and how to access the standard deepsearch colors in such a way that will be compatible with both 24-bit and 8-bit displays.

Using CVS for IDL software
We use the CVS revision control system to keep track of software in the $DEEPHOME/idlpro directory. READ THIS before you edit any software in that directory!

Almost every innocent thing you do is going to modify the database. Be aware!

Database Access
Finding Images
How to figure out what images we have in our database, and how to find images of certain specifications.

Reading and displaying images
The most basic of operations.

"Reducing" images
What it means to run reduceimages and why you do it so much.

Translating images
Finding transformations between images.

Finding the RA and Dec of coordinates on images; transforming between coordinate systems.

Database access from within your IDL programs
All the IDL routines you need to know to access the Deepsearch database. You should only use the programs documented here; doing it any other way makes it very hard if we ever have to change the database system.

Programmers/Maintainers Guide to the Databse
This has information for the IDL (or other) programmer working on either standard Deepsearch software, or their own software which interacts with the deepsearch database. Note that most of what you need to know is already in one of the descriptions above. This also has information for whoever it is who has to maintain the database, written when Rob transferred some of the summary files over to SQL. So that the next person who has to do this doesn't have to dig as hard as he did to figure out how to patch things up, this should hopefully be a complete description of what routines and programs are necessary for the maintenance of the database.

Programmer's/Maintainer's Guide: freadimage
The internals of just what freadimage does, and what varaibles it sets. Includes documentation on the new freadimage2, which has a conceptually cleaner interface (i.e. no global variables). Also includes some information on readfits.

Programmer's/Maintainer's Guide: freduceimage
The internals of what freduceimage does, more detailed information about star_struct. Includes information on the no-global-variable version freduceimage2. Includes documentation on isofind and catalog.

Programmer's/Maintainer's Guide: faperture

Programmer's/Maintainers's Guide: Transformations
Some information about how the transformations are calculated and what pieces of code actually use them. Includes some brief descriptions of the relevant procedures and a list of which pieces of code will have to be modified if you want to add another transformation.

Programmer's/Maintainer's Guide: matchall
Some of the internals of what matchall actually does to produce lists of matched objects.

Supernova Search Software
This is the software actually used when searching for supernovae.

Quick Guide

The overview quick guide to running a subtraction and search

Longer Guide

The longer guide to running a subtraction a subtraction and search, with more fiddly details.

Maintainer's Guide

The programmer's / maintainer's guide (including descriptions of data structures and algorithms). It also includes some documentation on the other tools (such as "scanmonitor"), and how to set up the database and all the tools for a new search campaign.

Lightcurve Software

Ivan's Lightcurve Software

How to build the Ivan lightcurves; Horribly, horribly out of date!!!

Reynald's Lightcurve Software

Using reylight.

Fitting lightcurves

Using SNMINUIT fitting software.

Cosmology Software

Markus's Cosmology Software

IDL Software to calculate the cosmological parameters.

Markus's Photometry Software

IDL Software to calculate observed magnitudes of SNe Ia.

Image Cleaning and Reduction

Image data reduction

This is the Deepsearch Data Reduction Manual, a 440K PDF file of some 60-odd pag length. (It is also available as a 1.3MB Postscript File, if you like that sort of thing.) This includes instructions for the neophyte about how to actually reduce data, as well as instructions for what is necessary to make the images Deepsearch compliant and to get them loaded into our database.

Photometric Calibration

  • Data Products