piaddast2 program description

1. General description

piaddast2 program is the  machinery to  catalog  ast-files to database and perform stars normalization, the usage can be seen by writing :

piaddast2 -h

In the later section each option will be described in detail , program is called :

piaddast2 AST_LIST_FILE OPTIONS

2. Program options


Option Name
Description
DEFAULT
-min_aver
minimum number of averaged frames, it is idenfied by header keyword AVERF0, AVERF1, ... , in case averaging program
does not add such keyowrds this option should not be used, as all ast files will be skiped
0
-skip_dups
if enabled in case star has multiple measurements on single frame all are skiped and
not loaded to DB. Such situation is mainly due to photometry mistakes  which sometimes 
finds multiple objects on single big star, eventually when we will have better photometry
this will not be nessesery, however no it is enabled as such "ghosts" produce bad measurements - point on light curve far from rest of points
enabled
-force_external_camid
forcing ID of camera to be filled in DB, default is 0 , means that ID from fits header is used
FALSE
-apert
index of aperture to be used , -1 means average of all apertures is used
-1
-on_line
on-line cataloging , waits for new frames in list file
FALSE
-wait_time
time of waiting for next frame in on-line mode
300 sec
-keep_sql
if keep sql files used for database loading , removes if FALSE
FALSE
-skip_field_change
in case of field change frames one before and one after is skipped
FALSE
-verb
verbose mode
FALSE
-skip_field
list of fields to be skiped in cataloging

-camid
provides external camid to be set
2
-update_radec
if update Star.ra,Star.dec when adding new measurements - maybe usful for planetoid/asteroid search
FALSE
-max_ast_err
maximum allowed value of astrometry error , in case ast file has larger it will be skiped
0.22
-min_alt
minium altitude above horizont for star to use measurements, all stars below this limit are skiped
25 deg
-no_update
if turn off update of stars during cataloging - when loading many nights it is usful.
When loading new portions of data it is also better to have it turned off and make recalculation
of updated stars range afterwards
update is enabled by default
-scan
if this is cataloging of scan, sets minium number of measurements to add new star to 1

-min_points_to_add_new
minimum number of measurements to add new star ( in -scan option set to 1 )
2
-error_log
name of error log file
error.log
-doload
if load stars to database
FALSE
-star_limit
in case >0 sets maxium number of stars allowed in ast, otherwise ast is skiped
70000
-min_smooth_stars
normalization parameter - minium number of nearby stars to smooth
30
-max_smooth_radius
normalization parameter - maximum radius 5
-star_log
name of star log file
lc.txt
-min_mag
minium magnitude of stars used in normalization
5
-max_mag
maximum magnitude of stars used in normalization
10
-show_star
coordinates of star to be shown, in format : RA,DEC where RA - decimal hours, DEC - decimal
degrees or 10h12m23s,DEC, light curve is written to file specified in option -star_log
not show
-star_match_radius
radius of matching star to star existing in catalog - in arcsec
120
-no_avg_mag
if use average ( of all apertures ) magnitudo as final magnitudo
TRUE
-confirm_on_next
OBSOLATE if confirmation of  new star on next frame is required

-gen_copy
generate COPY file for loading
FALSE
maybe should be
 changed to default TRUE ?
-border
size of border where stars are not added to catalog, if < 0 no border is ignored (whole image
is cataloged )
-1
-save_corr_file
TESTING  : if save every correction image to file
FALSE
-corr_file
name of correction file to be used on every frame before normalization
-
-db_log_level
sets level of sql loging
0
-sql_log
name of sql log file
/opt/pi/dev/pisys/log/pidb_ask.log
-stop_on_error
NOT USED - if stop on error
FALSE
-show_min_dist
TESTING - if show minimum distance to star in catalog
FALSE
-n_parts
OBSOLATE - it was number of parts to which image was divided for normalization
40
-alert_log
OBSOLATE - name of file to which new stars are saved
-
-list
if catalog list of ast files , list file name is provied as first parameter of the program
by default it is disabled - program catalogs single ast file provided as first parameter
FALSE
-norm
OBSOLATE

-db
if use db and catalog to db
FALSE
-image_size
size of FOV - radius of circle in which stars are selected in degress
28
-no_cat_corr
if make normalization to star catalog
TRUE
-savesql
MUST NOT BE USED

-dump_freq
maximum number of subsequent frames between dumps to database, if more
a lot of memory is needed to keep measurements between dumps
50
-min_star_count
minimum number of stars on frame to be catalogued, otherwise normalization does
not work perfectly and causes pseudo-flares and brightenings
NOTE : currently this parameter is static , but I will try to do it in such a way that
it will be set dynamicaly as 1/2 of average number of stars on given field
15000
-gzip_ast
gzips ast file after it is cataloged
disabled
-max_field_stars_from_db
maximum number of field stars which can be read from DB, to avoid crashes due to too big number of stars and memory limit exceeded
1,500,000
-monitor_io_type=13,15,17
List of io_types to be cataloged on-line to separate database ( they are cataloged to both main and second database ) in order to have lightcurves accessible on-line
disabled
-monitor_io_db=aver20_iodb
Name of small database to which on-line cataloging of interesting objects specified by option -monitor_io_type is done
empty ( disabled )