hipercam.scripts.makebias

Command line script to grab images

Functions

makebias([args])

``makebias [source] run first last twait tmax sigma plot

Module Contents

hipercam.scripts.makebias.makebias(args=None)

makebias [source] run first last twait tmax sigma plot output

Combines the frames of a single run (or list) into a single frame using clipped-mean averaging appropriate for biases. This uses grab to get the frames and combine to combine them. If you already have the frames separately, then just use combine directly.

Parameters:

sourcestr [hidden]

Data source, five options for built-in sources:

‘hs’ : HiPERCAM server

‘hl’ : local HiPERCAM FITS file

‘us’ : ULTRACAM server

‘ul’ : local ULTRACAM .xml/.dat files

‘hf’ : list of HiPERCAM hcm FITS-format files

‘hf’ is used to look at sets of frames generated by ‘grab’ or converted from foreign data formats. The standard start-off default for source can be set using the environment variable HIPERCAM_DEFAULT_SOURCE. e.g. in bash export HIPERCAM_DEFAULT_SOURCE="us" would ensure it always started with the ULTRACAM server by default. If unspecified, it defaults to ‘hl’.

Any instruments installed via plugins can be used as a source by specifying either <instrument>:local or <instrument>:server.

runstr

run name to access

firstint

First frame to access

lastint

Last frame to access, 0 for the lot

twaitfloat [hidden]

time to wait between attempts to find a new exposure, seconds.

tmaxfloat [hidden]

maximum time to wait between attempts to find a new exposure, seconds.

fliststr [if source ends ‘f’]

name of file list.

sigmafloat

The value of ‘sigma’ to pass to the clipped mean combination in ‘combine’

plotbool

make a plot of the mean level versus frame number for each CCD. This can provide a quick check that the frames are not too different. You will need explicitly to close the plot generated at the end of the script

outputstr

name of final combined file. Set by default to match the last part of “run” (but it will have a different extension so they won’t clash)

Note

This routine writes the files returned by ‘grab’ to automatically generated files, typically in .hipercam/tmp, to avoid polluting the working directory. These are removed at the end, but may not be if you ctrl-C. You should check .hipercam/tmp for redundant files every so often