NOTE :
Do not use character '/' in values of parameters which must be saved in FITS file , this is due to fact that saving to fits
file finds sign '/'  as start of comment. So in case '/' is found in that value of keyword this keyword will not be correctly written to
fits file header.

Setting parameters means putting name of paramter , sign =  and value of paramter , for example :

PARAM_N=34

NOTE : make sure there is no unnessesary trailing spaces after paramter value , in example newline signe shoud go just after 4

The table below contains list of parameters  for  controlling  each of described cuts :


Cut Type
List of paramters
Laplace frame
CCD_LAPLACE_TYPE
Find stars
CCD_NEW_LAPLACE_TRESHOLD_IN_SIGMA
Reject stars
CCD_MAX_LAPLACE_ON_OTHER_IN_SIGMA
CCD_AVERAGE_OF_PREV_N
CCD_VETO_SHAPE
CCD_VETO_REDIAL
CCD_CALC_MAX_NEIGHB_REDIAL

Clustering and overlaps
CCD_CLUSTER_IF_N_SIGMA_ABOVE_BACKGR
CCD_SKIP_OVERLAPS
CCD_OVERLAP_REDIAL
If more cut
CCD_CHECK_IF_MORE_POINT -  0 - current frame only, 1 - only after coic, 2 - both
CCD_SKIP_IF_MORE_THEN_MIN_DIST
CCD_SKIP_IF_MORE_THEN
CCD_SKIP_IF_MORE_THEN_REDIAL

CCD_MAX_NUMBER_OF_EVENTS
CCD_MAX_NUMBER_OF_EVENTS_AFTER_COIC
CCD_MAX_NUMBER_OF_EVENTS_AFTER_TV
black pixels
CCD_REJECT_BLACK_PIXELS - enable / disable
CCD_BLACK_PIXELS_RATIO
hot pixels
CCD_REJECT_HOT_PIXELS_BY_AVERAGE - enable / disable
CCD_REJECT_HOT_PIXELS_BY_AVERAGE_TRESH
coicydence in 2 cameras
CCD_COIC_BY_RA_DEC - enable / disable coic by RA,DEC
CCD_COIC_RADIUS_IN_SEC

old version - using linear transform between cameras ( when CCD_COIC_BY_RA_DEC=0) :
CCD_TRANSFORM_MATRIX_FILE
CD_COICYDENCE_REDIAL
Tracks :
On single camera, single frame :
CCD_CHECK_PLANE_TRACKS
CCD_MAX_CHI2_IN_PLANE_TRACK

Track on single camera :
# chi2=2, min_events=5 , veloc_error=0.5 - currently hardcoded
CCD_CHECK_TRACKS_ON_SINGLE_CAM=0

Track of coic events only :
 CCD_CHECK_TRACKS
CCD_NUM_BACK_FRAMES_FOR_TRACK
CCD_NUM_BACK_FRAMES_HAS_EVENTS_FOR_TRACKS
CCD_MIN_EVENTS_NO_IN_TRACK
CCD_MIN_DIST_OF_EVENTS_IN_TRACK
CCD_CHECK_OLD_TRACKS_NOT_OLDER_THEN

velocity check for tracks:
CCD_CHECK_VELOCITY_FOR_TRACK
CCD_CHECK_VELOCITY_ERROR_FOR_TRACK

Object shape
CCD_CLUSTER_IF_N_SIGMA_ABOVE_BACKGR
CCD_CHECK_EVENT_SHAPE

in case CCD_CHECK_EVENT_SHAPE>0 and event has shape < CCD_CHECK_EVENT_SHAPE such event is rejected
 currently rejected events are also used in track fit
Satellite Database
Satellites DB cut :
CCD_CHECK_IF_SATELITE - enable / disable
CCD_REJECT_SATELITES=0
CCD_TLE_FILE
CCD_QTH_FILE
CCD_SAT_REJ_RADIUS_IN_SEC

Stars catalogue
CCD_CHECK_IF_STAR - enable / disable
CCD_REJECT_STARS=0
CCD_STAR_REJ_RADIUS_IN_SEC

for picalib :
CCD_COUNT_BRIGHTER_THEN  - shows number of nearby stars brighter then specified magnitudo i radius  CCD_STAR_REJ_RADIUS_IN_SEC

# using TYCHO catalog to reject stars :
# in order to enable/disable set :
CCD_CHECK_STARS_IN_TYCHO=1
# maximum magnitude of stars to be used from TYCHO - in order not to use to faint stars
CCD_STARCAT_MAX_MAG=13
# in case TYCHO catalog not in $(DATADIR)/cat/tycho set path to it :
# CCD_TYCHO_STAR_CAT=$(DATADIR)/cat/tycho
Frame Quality Checks
# if check frame for shift error :
CCD_CHECK_FRAME=0
# column which is checked for "edge"
CCD_SHIFT_COL=15
# CCD_SHIFT_VAL in sigma in case <200 , in ADU otherwise
CCD_SHIFT_VAL=5
CCD_REJECT_EVENTS_NEAR_SHIFT=0

# if repair frame by making pixel shift ( default not ) :
CCD_REPAIR_FRAME=0
Monte Carlo ( off-line analysis )
CCD_MONTE_CARLO - enable / disable
CCD_MC_USE_SAMPLE_OBJ
CCD_PUT_OBJ_ON_N_FRAMES

# but samples by ra,dec when running Nparamstest2C :
CCD_PUT_SAMPLE_BY_RA_DEC

CCD_FULL_FRAMES_SAMPLE_DIR=
CCD_IMAGES_SAMPLE_DIR=$(DATADIR)/Samples/SamplesFromMZ20030202_from_400
CCD_MC_GEN_IDENT_REDIAL
CCD_CHECK_GEN_ONLY

# in MC - when Astrometry in in FITS header use it Yes/No :
CCD_USE_ASAS_ASTROMETRY_FROM_FITS - enable / disable

#putting samples :
# directory where list file is expected, samples are stored in subdirectories named by magnitudo : 8.00 9.04 7.45 etc
CCD_IMAGES_SAMPLE_DIR=$(DATADIR)/Samples/k2a

# if WIDTH>0 requires that after position (X,Y) is found sample in ring ( r-WIDTH , r+WIDTH ) will be choosen
 CCD_PUT_SAMPLE_CUT_OUT_IN_WIDTH=-1

# enables that same sample is found on list of samples for second camera ( by mag, RA, DEC )
CCD_PUT_SECOND_SAMPLE_BY_NAME=0

# ensures that sample is put on frame close to the one from which it was cut off
# by default disabled, if set to >0 then sample will be but to frame +- CCD_PUT_TAKEN_FROM_FRAME_IN_RANGE from which was cut off
CCD_PUT_TAKEN_FROM_FRAME_IN_RANGE=-1

# logging of sample put information on/off :
CCD_LOG_SAMPLE_PUT=0

# saving of images with pasted sample :
CCD_SAVE_IMAGE_WITH_SAMPLE=1
Database
# enabling database usage and choosing database :
CCD_USE_DB=1
CCD_DBNAME=pidb
CCD_DBUSER=pidb_user
CCD_DBPASS=pidb_user
CCD_DBHOST=$(PIDB_HOST)

# enabling saving information to database , in online mode frames and events are saved to db in case :
CCD_USE_DB=1
CCD_SAVE_EVENTS_TO_DB=1
CCD_SAVE_FRAMES_TO_DB=1
these are default settings, in case of offline mode by default no information is saved , but if one wants to
save events the following parameters must be set :
CCD_SAVE_EVENTS_TO_DB=1

saving sum events to database yes/no :
CCD_SAVE_SUM_EVENTS_TO_DB=1

or in order to save also verified events set :
CCD_SAVE_ VERIF_EVENTS_TO_DB=1

# database statementes loging level ( default = 0 )
CCD_DB_LOG_LEVEL=0
Instrument
# description of camera optics :
CCD_CAMOPTIC=85\1.2 Canon
# size of Field Of View in degrees :
CCD_FOV=20
Astrometry

































Important in off-line analysis :


Keep temporary files ??? :







SCAN MODE ( TAKE_N_MODE ) :
# this is to set that every time position is change
# first astrometry is executed
# but in case of trigger astrometry is executed in ASYNCHRO mode :
CCD_DO_ASAS_ASTRO_ON_STARTUP=1

# in case =1 will force every astrometry to be run in synchro mode
# that we don't want for triggers , so it is set to 0 now :
CCD_ASTROMETRY_SYNCHRO_MODE=1

CCD_USE_ASAS_TRANSFORM=1
CCD_AUTO_ASTROMETRY_FREQ=250
CCD_AUTO_ASTROMETRY_FREQ_IN_SEC=1800
CCD_ASAS_ASTROMETRY_RETRY=5

CCD_SAVE_REDUCT_FRAMES_FREQ=-10
# 0-no flip, 1-PI, 2-Horizontal <-> , 3-Vertictal
# CCD_DRIVER_REVERSE_IMAGE=3
CCD_ASAS_REVERSE_FOR_TRANSFORM=2
CCD_DO_ASAS_PHOT_ASTR=1
CCD_EXEC_ASTRO_ON_FIRST=0
CCD_ASAS_PHOTO_THRES=5.00
CCD_ASAS_ASTROMETRY_VERB=1
# in order to turn off verbose astrometry mode after N good converges , set parameter below
# value <0 means verbose mode will not be changed :
CCD_ASTRO_TO_SILENT_AFTER_N_GOOD=-1
CCD_ASAS_ASTROMETRY_TRY=5
CCD_ASAS_STAR_CAT=$(DATADIR)/cat/act
PIXSCALE=59.5
CCD_ASAS_ASTROMETRY_FI=0
CCD_ASAS_BORDER_SIZE=0
CCD_ASAS_SUBTR_DARK=0
MAX_AST_ERR=0.1
MAX_AST_ERR_FATAL=0.2

# minimum number of matches in astrometry to accept result , in case astrometry error is passing
# limit , it seems that astrometry has converged number of matches is verified and if to small
# astrometry fails
CCD_MIN_NUMBER_OF_MATCH_STARS=150

# in MC - when Astrometry in in FITS header use it Yes/No :
CCD_USE_ASAS_ASTROMETRY_FROM_FITS=0
CCD_USE_COORD_FROM_FITS=1

# keep mag/ast files from astrometry yes/no :
CCD_KEEP_MAG_AND_AST_FROM_ASTRO=0

# if fix problem when RA~=0 on new canon 85mm objectives ( fov = 22 deg ) :
CCD_FIX_RA_CLOSE_ZERO=1


To enable astrometry or only photometry in takeNmode - when images taken by take_npictures_synchro command :

CCD_ASTROMETRY_IN_TAKE_N_MODE=0
CCD_PHOTO_IN_TAKE_N_MODE=1

Checking shift of images
# FRAME SHIFT TO BE USED IN ON-LINE ALGORITHM
# determining shift of every image (disabled) :
CCD_USE_FRAME_SHIFT=1
CCD_MIN_SHIFT_TO_USE=0.5

# FORCING ASTROMETRY WHEN IMAGE SHIFT TO BIG :
# Shift detection to force new astrometry :
# max allowed shift
CCD_FORCE_ASTRO_WHEN_BIG_SHIFT=1.00
# max allowed sigma
CCD_FORCE_ASTRO_WHEN_BIG_SHIFT_RMS=1.00

Cataloging
# size of radius used when selecting stars from database to match new measurements -
# shoud correspond to radius of camera FOV for CarlZeiss 50 mm :
CCD_FRAME_SIZE_IN_DEG=28.00
# for cannon 85 mm , it is enough to set 20.00 deg :
CCD_FRAME_SIZE_IN_DEG=20.00

#
CCD_FOV - field of view of camara
CCD_FOV_BORDER - border used in selection stars from catalog

Camera Controll
# SHUTTER :
CCD_DRIVER_SHUTTER_TIME_IN_SEC - shutter time in seconds
CCD_SHUTTER_MODE - shutter mode 2 - normal mode (DEFAULT)
                                                                   1 - permanently open mode
CCD_OPEN_SHUTTER_WHEN_STARCOUNT_BELOW - minimum number of stars on frame to automatically
                                                 change shutter mode to permanently opened ( DEFAULT -1 - not used )

CCD_IGNORE_CAMERA - set 1 to disable camera

CCD_ADC_OFFSET - adc offset , in units of 1.2 mV , ( -50 -> -60 mV )
CCD_ADC_GAIN     - adc gain, # 0 - gain = 1, 37.8 , gain=2, 50.4 - gain=3, ... , 63-gain=6 ( see README )
CCD_ADC_RANGE - adc range, 0=2V, 1=4V,
CCD_ADC_CLAMPING - adc clamaping, 0=3V, 1=4V
CCD_MPP_MODE     - mpp mode

# adc configuration registers :
CCD_ADC_CONF_REG0=80 - adc configuration register0 ( before hardcoded value was 80 ) , now possible to change
CCD_ADC_CONF_REG1=192 - adc configuration register1 ( before hardcoded value was 192 ) , now possible to change

# pre-amplifier :
CCD_LNA_GAIN - lna gain , 1=x8, 2=x20

# TEMPERATURE CONTROLL :
CCD_COOLING_ON_OFF - 0 - cooling off , 1 - cooling on
CCD_TEMPERATURE       - temperature in Celcius
CCD_WAIT_FOR_DESIRED_TEMP - forces program to wait unitl desired temerature is reached before starting analysis
CCD_COOLING_TOLERANCE_DIFF (default = 2 degrees ) , tolerance of temperature in case reached temp differs from
                 desired by less then this value camera is considered as cooled ok
# action when cooling fails : 1 - set last temerature and stop waiting, 0 - continue cooling to desired temperature all the time
# default is 1 - stops cooling and stays on last achived temperature
CCD_ACTION_ON_TEMP_WAIT_FAIL=1

# fast - asynchro mode :
CCD_DRIVER_ASYNCHRO_MODE - 0 - disabled , 1 - enabled

# readout speed :
CCD_READOUT_SPEED_HORIZONTAL
CCD_READOUT_SPEED_VERTICAL


# TIMEOUTS AND EXIT ON PROBLEMS
CCD_MAX_COMM_ERROR_COUNT_TO_EXIT=-1   - max number of errors allowed, when more occures daq programs exists
                                                                                                 by default to allow reconnection with cameras ( or just reconnect )
                                                                                                 -1 mins no limit for number of errors

Ethernet Gigabit Camera Controll parameters
CCD_CAMERA_TIMEOUT_MILI_SEC=200 - timeout in mili seconds ( default 0.2 sec )
CCD_CAMERA_IP=127.0.0.1                           - ip address of camera
CCD_CAMERA_PORT=1234                           - communication port in camera ( default 1234, siumlator 23567 )
CCD_ETH_CAM_LOGFILE=cam_driver.log   - log file on PC ( default - empty - means loging disabled - optimization )
CCD_ETH_CAM_ERRFILE=cam_driver.err    - error log file on PC

DAQ simulator
CCD_SIMUL_USE_REAL_FITS_FILES=1 - this parameters decides if daq simulator
                uses images from fits files specially prepared for this purpose and stored
                also in svn, or in case =0 images are generated according to star
                catalog used in astrometry.
CCD_SIMUL_BACKGR_MEAN - mean value ( in ADU ) of background in generated images ( default = 2248 )
CCD_SIMUL_BACKGR_SIGMA - sigma value ( in ADU ) of background in generated images ( default = 82 )
CCD_SIMUL_COOL_SPEED  - cooling speed ( default 50  , values in range : 0-100 )
CCD_SIMUL_FRAME_ERROR - simulate error in DoCleanMeasure, in case <1 means probability that this error will occure
                                                           in case <0 no error simulation is done, in case >=1 - always error occures !!
SCRIPT GENERATOR
CCD_FOV - field of view of the cameras
AUTO POINTING
This settings should be placed in global cfg file in $NDIR/cfg/ccd.cfg , this is because piman reads this file not night specific cfg file in night
directory :

CCD_AUTOPOINT_SWIFT=1
CCD_AUTOPOINT_INTEGRAL=1
CCD_POINT_IO=1
# to specify special target with highest priority set :
CCD_SPECIAL_TARGET=NAME,12.331,-23.433
# priority of targets :
CCD_POINTING_PRIOR=SWIFT,INTEGRAL
DAQ LOG FILES
CCD_DUMP_ALL_LOG_TO_STDOUT=0 - enables/disables dumping of allevents log file to stdout
CCD_DAQ_LOG_FILE=/opt/pi/dev/pisys/log/daq20060707.log - by default name of daq log file is automatically
                                    generated, but can also be passed using this parameter
CCD_GLOBAL_LOG_ENABLED - enables/disables (values : 1/0 ) global log file /opt/pi/dev/pisys/log/pi.log , description of enabling loging
                                    using syslog can be found here . Guidelines for developers can be found here.
ASAS PHOTOMETRY
file : PI.defaults source $SRCDIR/ccd/cfg in , config for system in $NDIR/cfg/