astro.main.ReferenceFrame (version @(#)$Revision: 1.28 $)
index
/astro-wise/AWEHOME/AWBASE/astro/main/ReferenceFrame.py

defines class ReferenceFrame
 
ReferenceFrame is a sum of RegriddedFrames that have been expanded to a common grid.

 
Modules
       
astro.external.Sextractor
datetime
os
time

 
Classes
       
astro.main.RegriddedFrame.RegriddedBaseFrame(astro.main.BaseFrame.BaseFrame)
ReferenceFrame
common.database.DBMain.DBObject(__builtin__.object)
ReferenceFrameParameters

 
class ReferenceFrame(astro.main.RegriddedFrame.RegriddedBaseFrame)
    This class is intended to sum up RegriddedFrames to a ReferenceFrame.
 
All pixel data needs to be available on a single node/machine. The inputs for this class must
always have been regridded to the same grid.
 
 
Method resolution order:
ReferenceFrame
astro.main.RegriddedFrame.RegriddedBaseFrame
astro.main.BaseFrame.BaseFrame
common.database.DataObject.DataObject
common.database.DBMain.DBObject
astro.main.ProcessTarget.ProcessTarget
common.database.DBMeta.DBMixin
__builtin__.object
astro.main.OnTheFly.OnTheFly

Methods defined here:
__del__(self)
__init__(self, pathname='')
check_preconditions(self)
copy_attributes(self)
create_weight(self)
derive_chipname(self)
derive the chip names from the regridded frames
derive_objectname(self)
derive the object (names) from the regridded frames
get_canonical_name(self)
Generate the unique filename for this ReferenceFrame.
get_canonical_name_for_error(self)
Generate the unique filename for the associated ErrorFrame produced by MDia.
get_canonical_name_for_weight(self)
Generate the unique filename for the associated WeightFrame produced by MDia.
get_previous_version(self, level=0)
Return previous version of this object.  If it does not exist,
return None.
 
  level: depth of query for previous version (0 goes as deep as
         possible)
make(self)
Make a reference frame.
 
Dependencies: regridded_frames -- a list of RegriddedBaseFrame objects
make_phot(self)
Make ReferenceFrame photometry with USMphot:
make_ref(self)
Create kernel base images.
prepare_sourcelists(self)
run_getsky(self)
run_prepare(self)
run_skycalc(self)
run_starphot(self)
run_subby(self)
run_wcscut(self)
run_weight(self)
set_error_attribute(self)
set_kernel_attributes(self)
set_logfile_attribute(self)
set_phot_attributes(self)
set_table_attribute(self)
set_weight_attribute(self)
store(self)
store_phot(self)
store_ref(self)
verify(self)

Data descriptors defined here:
DATE_OBS
observation date [None]
NAXIS1
Length of data in axis 1 [pixel]
NAXIS2
Length of data in axis 2 [pixel]
OBJECT
OBJECT [None]
ZEROPNT
Zeropoint of this image [mag]
ZPNTERR
Zeropoint error [mag]
all_sources_ref
list of all sources in result frame [None]
all_sources_ref_skycat
skycat table of all sources in result image [None]
all_sources_ref_table
ASCII table of all sources in result image [None]
all_sources_reg
list of all sources in best seeing frame [None]
all_sources_reg_skycat
skycat table of all sources in best seeing image [None]
all_sources_reg_table
ASCII table of all sources in best seeing image [None]
astrom
Information about the astrometry [None]
bg_base_frames
background base files [None]
chip
chip name [None]
creation_date
Date this object was created [None]
error
variance map [None]
filename
The name of the associated file [None]
filter
Information about the filter [None]
globalname
The name used to store and retrieve file to and from Storage [None]
grid_target
The GridTarget object for the regridding operation [None]
imager
masked reference image [None]
imstat
Image statistics for the frame [None]
instrument
Information about the instrument [None]
is_valid
Manual/external flag to disqualify bad data (SuperFlag) [None]
logfile_getsky
getsky logfile [None]
logfile_ref
reference base logfile [None]
logfile_skycalc
skycalc logfile [None]
logfile_starphot
starphot logfile [None]
logfile_subby
subby logfile [None]
logfile_usmphot
logfile of task usmphot [None]
logfile_weight
weight logfile [None]
object_id
The object identifier
 
The object identifier is an attribute shared by all persistent
instances. It is the prime key, by which object identity is established
phot_is_made
reference photometry calculated [None]
phot_ref_skycat
skycat table of photometric reference stars [None]
phot_ref_table
ASCII table of photometric reference stars [None]
process_params
process parameters [None]
process_status
A flag indicating the processing status [None]
psf
psf frame of reference frame [None]
psf_error
psf error frame of reference frame [None]
psf_radius
Seeing FWHM [arcsec]
psf_ref_skycat
skycat table of PSF reference star used by starphot [None]
psf_ref_table
ASCII table of PSF reference star used by starphot [None]
quality_flags
Automatic/internal quality flag [None]
ref_base_frames
reference base files [None]
ref_flux_table
fluxes in reference frame measured by usmphot [None]
ref_is_made
basis calculated [None]
regridded_frames
input RegriddedFrames/CoaddedFrames [None]
rmask_calc
diffima mask #1 [None]
rmask_conv
diffima mask #2 [None]
sources
list of sources in result frame [None]
sources_skycat
skycat table of sources in result image [None]
sources_table
ASCII table of sources in result image [None]
std_stars_skycat
skycat table of PSF reference stars used by usmphot [None]
std_stars_table
ASCII table of PSF reference stars used by usmphot [None]
swarpconf
The Swarp configuration file [None]
variables
list of variable sources [None]
variables_skycat
skycat table of variable sources [None]
variables_table
ASCII table of variable sources [None]
weight
The regridded WeightFrame object [None]

Data and other attributes defined here:
PROCESS_TIME = 350
mandatory_dependencies = (('regridded_frames', 1),)

Methods inherited from astro.main.RegriddedFrame.RegriddedBaseFrame:
derive_psf_radius(self)
This method derives the median stellar FWHM, which is used in quality
control.
derive_timestamp(self)
get_default_config(self)
Base version of get_default_config, derived classes could implement
this
get_fixed_config(self)
Base version of get_fixed_config, derived classes could implement
this
get_fluxscale(self)
Use this method to calculate the gain.
 
S = counts * get_fluxscale()
get_overlap_region(self, other)
Return a dictionary of the overlapping region of two
RegriddedBaseFrames which have the same grid target (i.e. that are
regridded to the same grid).
 
Returns:
  overlap = {self : [xmin1, xmax1, ymin1, ymax1],
             other: [xmin2, xmax2, ymin2, ymax2]}
 
   where the keys "self" and "other" in the dictionary are
   RegriddedBaseFrame instances.
get_zeropoint(self)
This method is used to calculate the zeropoint.
 
Magnitude = -2.5*log10(counts) + get_zeropoint().
make_psf_catalog(self)
This catalog is required to determine a median stellar FWHM from,
which is used as a quality control measure.
make_swarp_config(self)
Set the fixed swarp parameters
set_astrom_attribute(self)
write_new_image_header(self, filename='')

Data descriptors inherited from astro.main.RegriddedFrame.RegriddedBaseFrame:
PSF_DIFFERENCE_TOO_HIGH

Methods inherited from astro.main.BaseFrame.BaseFrame:
build_header(self)
Fill a default header with values from descriptors
commit_subwinstat(self)
Conditionally commit subwindow statistics
display(self, viewer='skycat', filename=None)
Independent display method for all frames.
empty_header(self)
Initalize to a default (empty) header
estimate_statistics(self, pixmap=None, zone=None, max_iter=5, threshold=5.0)
Estimate the mean, median and stddev, by iteratively excluding
pixelvalues deviating too far from the median
 
Arguments:
   pixmap     -- optional map for bad pixels (default=None)
   zone       -- optional region (x0, y0, x1, y1) (default=None)
   max_iter   -- The maximum number of iterations
   sig_thresh -- The threshold in number of standard deviations
initialize_astrom_attribute(self)
initialize_chip_attribute(self)
initialize_filter_attribute(self)
initialize_imstat_attribute(self)
initialize_instrument_attribute(self)
initialize_lamp_attribute(self)
initialize_observingblock_attribute(self)
initialize_template_attribute(self)
inspect(self, pixels=None, zone=None, kappa=3.0, iterations=2, cmap=None, vmin=None, vmax=None, interpolation='lanczos', width=6, ratio=None, viewer='skycat', force_figure=False, force_viewer=False, subplot_size=50, contour_levels=20, num_bins=100, extension=None, compare=False, level=0, other=None, clip=False, color=False)
Optional visual inspection for quality control displays image in a
PyLab (MatPlotLib) window or optionally in an external viewer.
 
        pixels: optional list or array representing the image to be
                inspected (can be MxN for greyscale, or MxNx3 for RGB)
          zone: tuple of (x0, y0, x1, y1) representing the image
                coordinates of the two oposing corners of the sub
                image to consider
         kappa: the factor by which the dynamic range is increased in
                units of sigma (0 gives full range)
    iterations: number of iterations in the kappa-sigma range clipping
          cmap: PyLab color map instance
          vmin: lower display range in native units (e.g. ADU)
          vmax: upper display range in native units (e.g. ADU)
 interpolation: type of interpolation the PyLab viewer uses (nearest,
                bilinear, etc.)
         width: width of the PyLab figure window (in inches)
         ratio: ratio by which to scale the figure height (default:
                x_dim/y_dim)
        viewer: external viewer to use in case the image is too large
  force_figure: always use the PyLab figure window (Be Careful!
                Statistics calculations on large images can be very
                time and memory consuming.)
  force_viewer: always use the viewer
  subplot_size: width and height in pixels of region of interest
contour_levels: number of contour levels for the contour plot of the
                region of interest
      num_bins: number of bins in the histogram plot
     extension: extension of the filetype to save plot to (png, ps,
                or eps) None disables saving
       compare: compare this frame to its previous version using
                difference imaging (current-previous), pixels is
                ignored
         level: depth of query for previous version (0 goes as deep
                as possible) when compare is True
         other: a second of the same type of Frame object to replace
                previous when compare is True (if color is True,
                other can be a list of two images)
          clip: kappa-sigma clip each image prior to subtraction when
                compare is True
         color: use color combining (RGB) instead of differencing
                when compare is True (kappa, vmin/vmax only honored
                when clip is True), this image is R, other is B if
                single, other is [G, B] if it is a list
                (EXPERIMENTAL)
 
When force_viewer is False, inspect() displays basic image
statistics (mean, stddev) and then a representation of the image
that can be zoomed and panned.  Pressing various keys will give
different results described below in a region of interest described
by subplot_size:
 
      q - closes the most recent plot window when pressed in the
          main window
[space] - displays the X and Y coordinate (FITS standard unit
          indexed) and the count level
      a - performs aperture photometry on brightest feature in the
          region of interest (NOT YET IMPLEMENTED)
      c - displays a contour plot of the region of interest (see
          contour_levels)
      h - displays a histogram of the pixel values of the region of
          interest (see num_bins)
      r - displays a radial plot of the brightest feature in the
          region of interest
      s - displays a surface plot of the region of interest
      p - displays profile plots in both X and Y dimensions versus
          intensity (count level)
 
NOTE: None of the commands above work in the subplots.
is_compressed(self)
Find out if a FITS file is compressed
load_header(self)
Initialize self.header
load_image(self, readonly=0)
Initialize self.image.
make_background(self)
Make a background image,
 
Returns a new BaseFrame object. The name of the new file is
"name.back.fits"
make_subwinstat(self)
Compute statistics on subwindows
read_header(self)
Read a header into descriptors.
 
The descriptor is assumed to include a number of all caps
attributes that map directly to FITS header keywords. In
addition, if any of the following attributes are present, this
routine will initialize those attributes.
 
Initialized attributes: instrument, chip, filter, lamp, imstat,
astrom, observing_block, template
retrieve(self)
Retrieve this frame from the data server and uncompress it if it has
been compressed with FITSIO.
save(self, filename='', overwrite=1)
statistics(self, pixmap=None, zone=None)
Compute statistics and store in self.imstat.
 
Arguments:
   pixmap -- optional pixelmap object         (default=None)
   zone   -- optional region (x0, y0, x1, y1) (default=None)
update_header(self)
Update a header with values from descriptors
update_history(self)
Update a header with history
 
History is maintained in the instance attribute
history. History is written by appending string to the history
list.

Methods inherited from common.database.DataObject.DataObject:
FileName(self)
Return the pathame of the object
Name(self)
Return the name of the object
check_mandatory_dependencies(self)
check if all the mandatory dependencies are set
commit(self)
derive_hash(self)
Apply hashing function to the contents of the file that is part of
this object.
 
The SHA hashing function is used to calculate a hash value of the
contents of this DataObject. The hash value is returned as a
hexadecimal string.
distinct(self, param_list)
This method returns the distinct values from an input list. The
current implementation is kinda cheesy.
exists(self)
Test is the file existsts
get_pathname(self)
Getter for pathname
is_on_dataserver(self)
Checks if file is accessable on the dataserver.
 
NOTE: A return of False does NOT imply the file is not on any
      dataserver!  It is simply not on any accessable
      dataserver.
is_stored(self)
locate(self)
See common/net/dataserver_client.py (Data_IO.locate).
 
Returns a list of strings describing all dataservers where the file is
located as well as a few properties of the file, i.e.
 ['ip=...,port=...,path=...,size=...,mdate=...,
  'ip=...,port=...,path=?,size=?,mdate=?']
 
Question marks indicate that this dataserver is not reachable.
name_insert_suffix(self, suffix)
name_replace_suffix(self, suffix)
name_with_new_suffix(self, suffix)
release(self)
set_filename(self, pathname=None, processlevel='')
Specify a filename for this DataObject or use the default filename.
 
This method is used to set the filename attribute of a DataObject.
If called without a filename, the filename is set to the canonical name.
Classes that are derived from DataObject are expected to define a
method get_canonical_name() that returns the name for an instance
of that class. This is mandatory for CalFiles (or files that are
store()d on the data server) and optional for other files.
set_pathname(self, pathname)
Setter for pathname
set_process_parameters_from_dict(self, pars={})
pars is a dictionary of the type e.g.:
{'BiasFrame.process_params.SIGMA_CLIP':8}
set_stored(self)
set_user_config(self, pars={})
store_with_hash_as_name(self, prefix='', suffix='fits')
Name the file after the hash value of the file and store it.
 
First the hash value of the file is calculated. The pathname of the
dataobject is renamed to the hash value with the given suffix appended.
Then the file is stored.

Class methods inherited from common.database.DataObject.DataObject:
is_cal(cls) from common.database.DBMeta.DBObjectMeta
Test for being cal, derived raw classes should set _IS_CAL to 1
is_config(cls) from common.database.DBMeta.DBObjectMeta
Test for being config, derived raw classes should set _IS_CONFIG to 1
is_raw(cls) from common.database.DBMeta.DBObjectMeta
Test for being raw, derived raw classes should set _IS_RAW to 1
is_science(cls) from common.database.DBMeta.DBObjectMeta
Test for being science, derived raw classes should set _IS_SCIENCE to 1
is_seq(cls) from common.database.DBMeta.DBObjectMeta
Test for being seq, derived raw classes should set _IS_SEQ to 1
is_support(cls) from common.database.DBMeta.DBObjectMeta
Test for being config, derived raw classes should set _IS_SUPPORT to 1

Data descriptors inherited from common.database.DataObject.DataObject:
pathname

Data and other attributes inherited from common.database.DataObject.DataObject:
filepath = './'
localname = ''
storage = <common.net.dataserver_client.Storage at 0xa0c9e0>

Methods inherited from common.database.DBMain.DBObject:
__reduce__(self)
Method necessary to create picklable objects
 
This mehod return a tuple containg a function object used for
unpickling and a picklable state tuple, to be used as argument
to the unpickle function. If necessary this object is registered
in the pickle cache
as_dict(self, seqnr=1, dependency_name='', dictionary={}, allow_lazy_typed_list=False)
Method much like the info method, but returns a dictionary.
 
Dictionary looks like:
  {'<classname>.<property1_name>.<property2_name>': value,
   '<classname>.<property2_name>.<property3_name>': value}
 
Problem: infinite loops for cold/flat dependencies. It seems a maximum
recursion depth limits the problem.
get_creator(self)
Returns the name of the user who created this object.
get_persistent(self)
get_project(self)
Returns the name of the project to which this object belongs.
info(self, level=0, doc=False, _indent=0, _printclass=True)
Print the values of all persistent properties of the object.
 
level       : level of introspection
doc         : display docstrings for attributes
_indent     : internal parameter used for formatting
_printclass : internal parameter used for formatting
inverse_objects(self, max_results=100)
Iterate through and return all objects that use the current object
max_results     The maximum number of objects returned per query
inverse_query(self)
go through all inverse properties to see if this object is used
persists(self)
Returns whether an object is already made persistent or transient.
recommit(self)
Commits changes to an object, without following links.

Class methods inherited from common.database.DBMain.DBObject:
get_inverse_properties(cls, props=None) from common.database.DBMeta.DBObjectMeta
return all inverse properties 
that are all the properties that point to this class

Data descriptors inherited from common.database.DBMain.DBObject:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

Data and other attributes inherited from common.database.DBMain.DBObject:
__metaclass__ = <class 'common.database.DBMeta.DBObjectMeta'>
This is the metaclass for persistent classes
 
Provides:
  __new__ -- manages class construction
  __call__ -- manages object instantiation
database = <common.database.DBOracle.DBProxy instance at 0xe8e878>
pickle_id = None

Methods inherited from astro.main.ProcessTarget.ProcessTarget:
check_observing_blocks(self, childs)
check if all childs have the same observing_block
check_templates(self, childs)
check if all childs have the same template
compare(self)
Quality Control -- basic trend analysis
 
The compare() method is used for default trend analysis. This
is done by comparing with a previous version of the same
object (last weeks bias, for example). This may be as simple
as comparing attribute values, but may also involve more
complex computations (e.g., subtracting the two images, and
analysing the residuals)
get_dependencies(self)
Return a list of names of attributes that are required for make()
get_qcflags_set(self)
Return a list of names of flags that have been set.
get_qcflags_set_dict(self)
Return a dictionary of flags that have been set.  The key is the
name, the value is a tuple of (index, docstring).
is_compared(self)
Return true if the object has been compared
is_inspected(self)
Return true if the object has been inspected
is_made(self)
Return true if the object has been made
is_ok(self)
Return true if no quality control flags have been set.
is_verified(self)
Return true if the object has been verified
set_compared(self)
Set the process status to indicate that the object has been
compared.
set_inspected(self)
Set the process status to indicate that the object has been
inspected.
set_made(self)
Set the process tatus to indicate that the object has been made
set_verified(self)
Set the process status to indicate that the object has been
verified.

Class methods inherited from astro.main.ProcessTarget.ProcessTarget:
get_qcflags(cls) from common.database.DBMeta.DBObjectMeta
Return a list of attribute names of QCflag() objects.
select(cls, **searchterms) from common.database.DBMeta.DBObjectMeta
Class method to select RawFrames, Calfiles and ReducedScienceFrames
from the database.
 
Syntax example:
 
q = RawScienceFrame.select(instrument='WFI', filter='#842',
    chip='ccd50', time_from='2000-01-02 04:45:46',
    time_to='2000-01-02 05:03:00')
 
Possible search terms:
----------------------
check_quality  - (Default 1) Exclude invalidated data (quality_flags!=0)
check_validity - (Default 1) Exclude invalidated data (is_valid=0)
chip        - select of the same CCD ('ccd50', 'ccd51', etc.)
date        - select of the same date (i.e. date at the start of
              observing night, in yyyy-mm-dd format)
exptime     - select frames with similar exposure time
              (EXPTIME-0.8sec to EXPTIME+0.8 sec)
extension   - select (raw) frames for a certain extension of its
              RawFitsData object
filename    - select a frame(!) by its filename
filter      - select of the same filter ('#842', '#843', etc.)
instrument  - select of the same instrument ('WFI', 'WFC', 'OCAM')
object      - select for OBJECT header keyword, uses "like"
              functionality, which allows wildcards "*" and "?"
time_from   - precise form of date, in yyyy-mm-dd hh:mm:ss format
time_to     - required when using time_from
select_for_raw(cls, raw, overscan=None, check_quality=1, check_validity=1) from common.database.DBMeta.DBObjectMeta
Class method to select the most recent valid calfile for the
provided raw frame from the database.
select_for_reduced(cls, reduced, overscan=None, check_quality=1, check_validity=1) from common.database.DBMeta.DBObjectMeta
Synonym for the select_for_raw method; the implementation should
be identical.

Data and other attributes inherited from astro.main.ProcessTarget.ProcessTarget:
STATUS_COMPARE = 2
STATUS_INSPECT = 3
STATUS_MAKE = 0
STATUS_VERIFY = 1

Class methods inherited from common.database.DBMeta.DBMixin:
get_persistent_attributes(cls) from common.database.DBMeta.DBObjectMeta
return a list of persistent attributes

Methods inherited from astro.main.OnTheFly.OnTheFly:
Flagged(self)
Check if any flag is set
return 1 for flag is set
return 0 no flag
after_do_make(self, switches=None)
extra make statements, this method can be overridden by OnTheFly classes to
implement extra make statements which will be executed after the make of self
after_set_onthefly_dependencies(self, switches, advanced)
this method is called after the onthefly method set_onthefly_dependencies
derived classes can implement this method to customize the dependencies
setting after this has been done automatically by onthefly
after_uptodate_object(self, dependencies_missing, dependencies_new, dependencies_obsolete)
The uptodate_object method determines if the object is uptodate, and will result in three listings :
 dependencies_missing - missing mandatory dependencies
 dependencies_new - new dependencies
 dependencies_obsolete - current dependencies that are obsolete
Derived classes can override this method to tweak the listings
check_for_mandatory(self, dep_str, dep_new)
check if dependency is mandatory and present
dep_str is the name of the attribute, dep_new is the (attribute) object
get_onthefly_dependencies(self, advanced=None)
Method retrieves a list of all dependencies used for
on-the-fly processing
Return: [dependency, dependency class, dependency name]
uptodate(self, date_time=None, template=None, switches=None, advanced=None)
This method checks if the object is up-to-date, for the given datetime.
OnTheFly_uptodate class has the functionality for checking uptodate

Class methods inherited from astro.main.OnTheFly.OnTheFly:
exist(cls, date_time=None, chip=None, filter=None, object_id=None, parent=None, parent_attr=None, template=None, extra=[], advanced=None, switches=None) from common.database.DBMeta.DBObjectMeta
for the given parameters and class return the most
recent object(s), or None
get_onthefly(cls, date_time=None, filter=None, chip=None, object_id=None, advanced=None, switches=None, template=None, parent=None, parent_attr=None) from common.database.DBMeta.DBObjectMeta
For the given parameters and class get the object,
if the object does not exist -> make it.
This is done recursively for all dependencies.
 
The object can only be made if there are raws

 
class ReferenceFrameParameters(common.database.DBMain.DBObject)
    
Method resolution order:
ReferenceFrameParameters
common.database.DBMain.DBObject
__builtin__.object

Data descriptors defined here:
ALL_SOURCES_REF_NUMBER
number of stars in result frame [None]
ALL_SOURCES_REF_THRESH
SExtractor detection threshold for all stars in result frame[None]
ALL_SOURCES_REG_NUMBER
number of stars in in best seeing frame [None]
ALL_SOURCES_REG_THRESH
SExtractor detection threshold for all stars in best seeing frame [None]
GETSKY_KAPPA
Clipping kappa value for background subtraction [None]
GETSKY_SKY_ORDER
Polynomial order for sky subtraction [None]
GETSKY_THRESHOLD
Threshold value for background subtraction [None]
IO_MODE
I/O mode [None]
PSF_REF_MAX_THRESH
Maximum threshold for autoselect PSF-reference stars [None]
PSF_REF_MIN_THRESH
Minimum threshold for autoselect PSF-reference stars [None]
PSF_REF_NUMBER
Number of PSF reference stars [None]
PSF_SIZE
Box radius of PSF [pixel]
REF_KERNEL_MODEL
convolution kernel model [None]
REF_KERNEL_SIZE
Convolution kernel size [pixel]
REF_SKY_ORDER
Polynomial order for sky alignment [None]
SKYCALC_ABS_ORDER
Polynomial order for absorption alignment [None]
SKYCALC_MAX_THRESH
Maximum threshold for autoselect reference stars [None]
SKYCALC_MIN_THRESH
Minimum threshold for autoselect reference stars [None]
SKYCALC_MODE
Method of photometric alignment [None]
SKYCALC_NUMBER
Number of reference stars for autoselect [None]
SKYCALC_SKY_ORDER
Polynomial order for sky alignment [None]
SOURCES_NUMBER
number of stars to be analyzed [None]
SOURCES_THRESH
SExtractor detection threshold for stars to be analyzed [None]
SOURCE_CODE_VERSION
The version of the source code [None]
STARPHOT_MAX_THRESH
Maximum threshold for autoselect reference star [None]
STARPHOT_MIN_THRESH
Minimum threshold for autoselect reference star [None]
STARPHOT_REF_DEC
DEC of psf-reference star [deg]
STARPHOT_REF_RA
RA of psf-reference star [deg]
USMPHOT_APERTURE
PSF fitting radius [pixel]
USMPHOT_BETA
Valid range for Moffat beta value [None,None]
USMPHOT_FWHM
Valid range for fwhm value [pixel,pixel,None]
USMPHOT_INTERPOLATION
Interpolation order for regridding [None]
USMPHOT_POS_TOLERANCE
position precision [subpixel]
USMPHOT_SUBGRID
PSF subgid precision [1/pixel]
USMPHOT_SUBPIXEL
PSF subpixel precision [1/pixel]
VERBOSE
Verbose level [None]
object_id
The object identifier
 
The object identifier is an attribute shared by all persistent
instances. It is the prime key, by which object identity is established

Methods inherited from common.database.DBMain.DBObject:
__del__(self)
Destructor for the DBObject
 
This destructor is called by the garbage collector for the transient
part of the DBObject. When it is called it calls the gc_transient()
method of the DBProxy implementation. The implementation of the
gc_transient() method can then decide what to do with the persistent
counterpart.
E.g. the database can be synchronized with its transient counterpart.
Another possibility is that the gc_transient() implementation checks
whether any attributes of a read-only object have changed since an
object was fetched from the database. If there are differences an
exception can be raised.
__reduce__(self)
Method necessary to create picklable objects
 
This mehod return a tuple containg a function object used for
unpickling and a picklable state tuple, to be used as argument
to the unpickle function. If necessary this object is registered
in the pickle cache
as_dict(self, seqnr=1, dependency_name='', dictionary={}, allow_lazy_typed_list=False)
Method much like the info method, but returns a dictionary.
 
Dictionary looks like:
  {'<classname>.<property1_name>.<property2_name>': value,
   '<classname>.<property2_name>.<property3_name>': value}
 
Problem: infinite loops for cold/flat dependencies. It seems a maximum
recursion depth limits the problem.
commit(self)
Commits object including objects that are referenced and have been changed.
 
If this object refers to other persistent object a commit() ensures that
 
1. ALL changes to the object and referred objects are made persistent.
2. NONE of the changed object and referred objects are made persistent.
Under normal circumstances only the first thing should ever happen.
If the second case occurs it is almost certainly because of some bug in
the routine that implements the DBProxy interface.
get_creator(self)
Returns the name of the user who created this object.
get_persistent(self)
get_project(self)
Returns the name of the project to which this object belongs.
info(self, level=0, doc=False, _indent=0, _printclass=True)
Print the values of all persistent properties of the object.
 
level       : level of introspection
doc         : display docstrings for attributes
_indent     : internal parameter used for formatting
_printclass : internal parameter used for formatting
inverse_objects(self, max_results=100)
Iterate through and return all objects that use the current object
max_results     The maximum number of objects returned per query
inverse_query(self)
go through all inverse properties to see if this object is used
persists(self)
Returns whether an object is already made persistent or transient.
recommit(self)
Commits changes to an object, without following links.

Class methods inherited from common.database.DBMain.DBObject:
get_inverse_properties(cls, props=None) from common.database.DBMeta.DBObjectMeta
return all inverse properties 
that are all the properties that point to this class

Data descriptors inherited from common.database.DBMain.DBObject:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

Data and other attributes inherited from common.database.DBMain.DBObject:
__metaclass__ = <class 'common.database.DBMeta.DBObjectMeta'>
This is the metaclass for persistent classes
 
Provides:
  __new__ -- manages class construction
  __call__ -- manages object instantiation
database = <common.database.DBOracle.DBProxy instance at 0xe8e878>
pickle_id = None

 
Functions
       
check_uniqueness_of_filter(input_frames)
This small routine checks whether all the input frames are from the same
filter.  The "input_frames" parameter must be a list, and all the items
included in the list must have a valid "filter" attribute.
check_uniqueness_of_instrument(input_frames)
This small routine checks whether all the input frames are from the same
instrument. The "input_frames" parameter must be a list, and all the items
included in the list must have a valid "instrument" attribute.
get_best_thresh(frame, min_number=0, max_number=9.9999999999999997e+98, thresh_start=10, verbose=0)
Function to find a certain sextractor DETECTION_THRESH for which the number of sources is between min_number and max_number. 
 
Syntax examples:
get_best_thresh( my_frame, min_number = 300, max_number = 350, thresh_start = 100 )
 
Possible parameters:
--------------------
min_number    - minimum number of stars
max_number    - maximum number of stars
thresh_start  - initial threshold
verbose       - verbose level
int2str(value, digits)
This small routine converts an integer value in a string with fixed number of digits
by inserting a number of leading zeros.
make_table_on_sources(sl=None, filename=None)
creates a simple ASCII table which contains only x, y, RA, DEC, flux and flag
sl is of type SourceList.
the default filename is the filename of the SourceList with extension .ascii
str2datetime(dateobs)

 
Data
        Env = {'astrometric_refcat': '/aw01/users/catalog/USNO-A2/', 'aw_usno_url': 'http://dbusno.astro-wise.org/', 'aweshell': 'awe', 'awvo_url': '', 'baseconf_dir': '/astro-wise/awehome/config', 'calts_server': 'calts.astro-wise.org', 'data_port': '8000', 'data_server': 'ds.astro.rug.astro-wise.org', 'database_api': 'cx_Oracle', 'database_engine': 'oracle_10g', ...}
__version__ = '@(#)$Revision: 1.28 $'
database = <common.database.Database.Database object at 0x2aaab368b210>