Fake Source Injection with lcogtsnpipe

1) sourceingest.py


sourceingest.py takes images from photlco that have ' e91' in the filename and have a zeropoint, and create a new image with a fake source and a new filename labeled with 'e93' instead of 'e91'. The header of this new image will be the same as the e91, but with a new key, FAKEMAG, which will contain the magnitude of the source that was placed into the image. sourceingest.py will both ingest the image into photlcoraw and photlco. However, it will not reduce the photometry of this data, so that is still necessary to do with lscloop.py

Query Arguments:


-e, --epoch YYYYMMDD-YYYYMMDD
     This argument is necessary, and will specify the dayobs of the images or image you want. You can input both a range of dates, or just one date.
-n, --name OBJNAME
    This argument, while not necessary for the script to run, is very useful when specifying images. You will be able to choose the object name of the image or images you want to inject a fake source into. A typical objname would be SEATiDE001.
-f. --filename FILENAME
    This argument isn't very useful due to the use of the objname option. However, you can specify a specific filename to be used for the source injection and ingestion. Notice, all files to be used for this will need to have e91 in their name.

Fake Source Creation Arguments:
-m, --magnitude MAG 
    This argument has two options. The first would be to manually specify the magnitude of the source that you want to inject. The second would be to not use this argument, and have the program 50/50 having a source and not having one. If the option to have a source is chosen, the header key FAKEMAG will be blank. If the chance falls on having a source, the program will randomly choose a float between 14-20 and have that be the magnitude. This magnitude will be shown in FAKEMAG.
-F, --force
    This argument is a boolean. Upon executing the program with this option, the boolean will be set to true, and will force the program to perform the injection on all images. Without this option, the program will compare the FAKE MAG header key of a preexisiting images of the same name with the input magnitude to see if anytime can be saved.

Movement Arguments:
--RAS degrees
    This argument is not necessary and will be used to move the fake source to the specified right ascension. Using this or --DECS will change the filename to *e93.moved.fits. This is useful for creating a source over background noise. You can then use --RAS in the psfmag stage of lscloop to find the photometry.
--DECS degrees
   This argument is not necessary and will be used to move the fake source to the specified right ascension. Using this or --RAS will change the filename to *e93.moved.fits. This is useful for creating a source over background noise. You can then use --DECS in the psfmag stage of lscloop to find the photometry.




2) magcomparison

    This is a new table that I have created to store the data created from sourcesub.py.