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
-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.
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
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.
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.