picalib


1. picalib program allows to run pi-photometry and dump star list with celestial coordinates, astrometry parameters are read from
    fits file or from cfg file , the following options are aailable :

          picalib FITS_FILE -dark=dark1.fit -flat=FLAT_K2a -tresh=5 -tresh_cluster=3 -border=30 -astrocfg -savemag -aperture=-1


          FITS_FILE  - name of fit / fitc file to be analysied
          -dark=dark1.fitc - name of dark frame file
          -tresh=5 - setting treshold to find stars
          -tresh_cluster=3 - setting treshold to find cluster
          -border=30  - setting width of border to be ignored
          -astrocfg - force usage of astrometry parameters from ccd.cfg file
          -savemag - save mag file ( ASAS format )
          -aperture=4 - in order to use new photometry , with circular apertures and fractions of pixels

2. Output of picalib program is be default txt file , in the following format :

    x y mag sky sharp shape RA DEC Mag_Catalog Laplace Lap_mag Cluster_lap Cluster_mag LapNew LapNew_Mag UNIX_TIME PLUS_SUM
       

          x - X coorindate of star ( fractional )
          y - Y coorindate of star ( fractional )
          mag - NOT USED , final pi-photometry magnitudo will be placed were
          sky - value of sky background to be subtracted from aperture sum for single pixel ( total in aperture version )
          sharp -  NOT USED
          shape -NOT USED
          RA - right ascension in format 03h34m34.54s
          DEC - declination in degrees
          Mag_Catalog - catalog magnitudo ( currently using ASAS catalog )
          Laplace - value of laplace
          Lap_mag - aparature magnitudo as calculated from Laplace value
          Cluster_lap - NOT USED
          Cluster_mag - NOT USED
          LapNew - value of sum of aperture - sky * N_PIXELS ( in aperture version it is in fact SUM of aperture )
          LapNew_Mag - magnitudo calculated from LapNew ( LapNew_Mag:=MAG_0-2.5*log10( LapNew) )
          UNIX_TIME - frame unix_time
          PLUS_SUM - values of pluses ( aperture sum )
           catDist[arcsec] - distanace to matching catalog star
          N_cat_stars - shows number of nearby stars brighter then limit CCD_COUNT_BRIGHTER_THEN ( optional - only when CCD_COUNT_BRIGHTER_THEN>0 )

3. in case same catalog star was matched to several positions (x,y) it should not be used, one can verify catDist and choose smaller , but this may not always be the best choice !

4.   in order to fix astrometry in FITC headers of many frames run :

          nohup do_astro_all! k2a_list dark1.fitc > out2 2>&1 &
  
        where :
             k2a_list  - list of frames to be fixed
             dark1.fitc - path to dark frame file