Command line interface

SDTbulkchange

usage: SDTbulkchange [-h] [-k KEY] [-v VALUE] [--apply-cal-mark] [--recursive]
                     [--debug]
                     [files ...]

Change all values of a given column or header keyword in fits files

positional arguments:
  files                 Single files to preprocess

optional arguments:
  -h, --help            show this help message and exit
  -k KEY, --key KEY     Path to key or data column. E.g. "EXT,header,KEY" to
                        change key KEY in the headerin extension EXT;
                        EXT,data,COL to change columnCOL in the data of
                        extension EXT
  -v VALUE, --value VALUE
                        Value to be written
  --apply-cal-mark      Short for -k "DATA TABLE,data,flag_cal" -v 1
  --recursive           Look for file in up to two subdirectories
  --debug               Plot stuff and be verbose

SDTcal

usage: SDTcal [-h] [--sample-config] [--nofilt] [-c CONFIG] [--splat SPLAT]
              [-o OUTPUT] [--snr-min SNR_MIN] [--show] [--check]
              [file]

Load a series of cross scans from a config file and use them as calibrators.

positional arguments:
  file                  Input calibration file

optional arguments:
  -h, --help            show this help message and exit
  --sample-config       Produce sample config file
  --nofilt              Do not filter noisy channels
  -c CONFIG, --config CONFIG
                        Config file
  --splat SPLAT         Spectral scans will be scrunched into a single channel
                        containing data in the given frequency range, starting
                        from the frequency of the first bin. E.g. '0:1000'
                        indicates 'from the first bin of the spectrum up to
                        1000 MHz above'. ':' or 'all' for all the channels.
  -o OUTPUT, --output OUTPUT
                        Output file containing the calibration
  --snr-min SNR_MIN     Minimum SNR for calibrator measurements to be
                        considered valid
  --show                Show calibration summary
  --check               Check consistency of calibration

SDTconvert

usage: SDTconvert [-h] [-f FORMAT] [--test] [--detrend] [--save-locally]
                  [files ...]

Load a series of scans and convert them to variousformats

positional arguments:
  files                 Single files to process or directories

optional arguments:
  -h, --help            show this help message and exit
  -f FORMAT, --format FORMAT
                        Format of output files (options: mbfits, indicating
                        MBFITS v. 1.65; mbfitsw, indicating MBFITS v. 1.65
                        wrapped in asingle file for each FEBE; fitsmod
                        (default), indicating a fitszilla with converted
                        coordinates for feed number *n* in a separate COORDn
                        extensions); classfits, indicating a FITS file
                        readable into CLASS, calibrated when possible;sdfits,
                        for the SDFITS convention
  --test                Only to be used in tests!
  --detrend             Detrend data before converting to MBFITS
  --save-locally        Save all data in the current directory, notalongside
                        the original data.

SDTfake

usage: SDTfake [-h] [-s SOURCE_FLUX] [-n NOISE_AMPLITUDE] [-b BASELINE]
               [-g GEOMETRY GEOMETRY GEOMETRY GEOMETRY]
               [--beam-width BEAM_WIDTH] [--spacing SPACING] [-o OUTDIR_ROOT]
               [--scan-speed SCAN_SPEED] [--integration-time INTEGRATION_TIME]
               [--spectral-bins SPECTRAL_BINS] [--no-cal] [--sun] [--debug]

Simulate a single scan or a map with a point source.

optional arguments:
  -h, --help            show this help message and exit
  -s SOURCE_FLUX, --source-flux SOURCE_FLUX
                        Source flux in Jy
  -n NOISE_AMPLITUDE, --noise-amplitude NOISE_AMPLITUDE
                        White noise amplitude
  -b BASELINE, --baseline BASELINE
                        Baseline kind: "flat", "slope" (linearly
                        increasing/decreasing), "messy" (random walk) or a
                        number (which gives an amplitude to the random-walk
                        baseline, that would be 20 for "messy")
  -g GEOMETRY GEOMETRY GEOMETRY GEOMETRY, --geometry GEOMETRY GEOMETRY GEOMETRY GEOMETRY
                        Geometry specification: length_ra, length_dec,
                        width_ra, width_dec, in arcmins. A square map of 2
                        degrees would be specified as 120 120 120 120. A
                        cross-like map, 2x2 degrees wide but only along
                        1-degree stripes, is specified as 120 120 60 60
  --beam-width BEAM_WIDTH
                        Gaussian beam width in arcminutes
  --spacing SPACING     Spacing between scans in arcminutes (default 0.5)
  -o OUTDIR_ROOT, --outdir-root OUTDIR_ROOT
                        Output directory root. Here, source and calibrator
                        scans/maps will be saved in outdir/gauss_ra,
                        outdir/gauss_dec, outdir/calibrator1,
                        outdir/calibrator2, where outdir is the outdir root
  --scan-speed SCAN_SPEED
                        Scan speed in arcminutes/second
  --integration-time INTEGRATION_TIME
                        Integration time in seconds
  --spectral-bins SPECTRAL_BINS
                        Simulate a spectrum with this number of bins
  --no-cal              Don't simulate calibrators
  --sun                 Simulate a map of the Sun
  --debug               Plot stuff and be verbose

SDTimage

usage: SDTimage [-h] [--sample-config] [-c CONFIG] [--refilt] [--altaz]
                [--sub] [--interactive] [--calibrate CALIBRATE] [--nofilt]
                [-g] [-e EXCLUDE [EXCLUDE ...]] [--chans CHANS] [-o OUTFILE]
                [-u UNIT] [--frame {icrs,altaz,sun}] [--destripe]
                [--npix-tol NPIX_TOL] [--debug] [--quick] [--scrunch-channels]
                [--nosave] [--noplot] [--bad-chans BAD_CHANS] [--splat SPLAT]
                [file]

Load a series of scans from a config file and produce a map.

positional arguments:
  file                  Load intermediate scanset from this file

optional arguments:
  -h, --help            show this help message and exit
  --sample-config       Produce sample config file
  -c CONFIG, --config CONFIG
                        Config file
  --refilt              Re-run the scan filtering
  --altaz               Do images in Az-El coordinates (deprecated in favor of
                        --frame altaz)
  --sub                 Subtract the baseline from single scans
  --interactive         Open the interactive display
  --calibrate CALIBRATE
                        Calibration file
  --nofilt              Do not filter noisy channels
  -g, --global-fit      Perform global fitting of baseline
  -e EXCLUDE [EXCLUDE ...], --exclude EXCLUDE [EXCLUDE ...]
                        Exclude region from global fitting of baseline and
                        baseline subtraction. It can be specified as X1, Y1,
                        radius1, X2, Y2, radius2 in image coordinates or as a
                        ds9-compatible region file in image or fk5 coordinates
                        containing circular regions to be excluded. Currently,
                        baseline subtraction only takes into account fk5
                        coordinates and global fitting image coordinates. This
                        will change in the future.
  --chans CHANS         Comma-separated channels to include in global fitting
                        (Feed0_RCP, Feed0_LCP, ...)
  -o OUTFILE, --outfile OUTFILE
                        Save intermediate scanset to this file.
  -u UNIT, --unit UNIT  Unit of the calibrated image. Jy/beam or Jy/pixel
  --frame {icrs,altaz,sun}
                        Reference frame for the image. One of icrs, altaz, sun
  --destripe            Destripe the image
  --npix-tol NPIX_TOL   Number of pixels with zero exposure to tolerate when
                        destriping the image, or the full row or column is
                        discarded. Default None, meaning that the image will
                        be destriped as a whole
  --debug               Plot stuff and be verbose
  --quick               Calibrate after image creation, for speed (bad when
                        calibration depends on elevation)
  --scrunch-channels    Sum all the images from the single channels into one.
  --nosave              Do not save the hdf5 intermediate files whenloading
                        subscans.
  --noplot              Do not produce diagnostic plots for data processing
  --bad-chans BAD_CHANS
                        Channels to be discarded when scrunching, separated by
                        a comma (e.g. --bad-chans Feed2_RCP,Feed3_RCP )
  --splat SPLAT         Spectral scans will be scrunched into a single channel
                        containing data in the given frequency range, starting
                        from the frequency of the first bin. E.g. '0:1000'
                        indicates 'from the first bin of the spectrum up to
                        1000 MHz above'. ':' or 'all' for all the channels.

SDTinspect

usage: SDTinspect [-h] [-g GROUP_BY [GROUP_BY ...]] [--options OPTIONS] [-d]
                  [--only-after ONLY_AFTER] [--only-before ONLY_BEFORE]
                  directories [directories ...]

From a given list of directories, read the relevant information and link
observations to calibrators. A single file is read for each directory.

positional arguments:
  directories           Directories to inspect

optional arguments:
  -h, --help            show this help message and exit
  -g GROUP_BY [GROUP_BY ...], --group-by GROUP_BY [GROUP_BY ...]
  --options OPTIONS     Options to be written in config files; they have to be
                        specified as a string defining a dictionary. For
                        example,'{"pixel_size": 0.6, "noise_threshold": 5}'
  -d, --dump-config-files
  --only-after ONLY_AFTER
                        Only after a certain date and time, e.g. ``--only-
                        after 20150510-111020`` to indicate scans done after
                        11:10:20 UTC on May 10th, 2015
  --only-before ONLY_BEFORE
                        Only before a certain date and time, e.g. ``--only-
                        before 20150510-111020`` to indicate scans done before
                        11:10:20 UTC, May 10th, 2015

SDTlcurve

usage: SDTlcurve [-h] [-s SOURCE [SOURCE ...]] [--sample-config] [--nofilt]
                 [-c CONFIG] [--splat SPLAT] [-o OUTPUT]
                 [file]

Load a series of cross scans from a config file and obtain a calibrated curve.

positional arguments:
  file                  Input calibration file

optional arguments:
  -h, --help            show this help message and exit
  -s SOURCE [SOURCE ...], --source SOURCE [SOURCE ...]
                        Source or list of sources
  --sample-config       Produce sample config file
  --nofilt              Do not filter noisy channels
  -c CONFIG, --config CONFIG
                        Config file
  --splat SPLAT         Spectral scans will be scrunched into a single channel
                        containing data in the given frequency range, starting
                        from the frequency of the first bin. E.g. '0:1000'
                        indicates 'from the first bin of the spectrum up to
                        1000 MHz above'. ':' or 'all' for all the channels.
  -o OUTPUT, --output OUTPUT
                        Output file containing the calibration

SDTmonitor

usage: SDTmonitor [-h] [-c CONFIG] [--polling] [-p PORT] [-v] [-w WORKERS]
                  directories [directories ...]

Run the SRT quicklook in a given directory.

positional arguments:
  directories           Directories to monitor

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        Configuration file
  --polling             Use a platform-independent, polling watchdog
  -p PORT, --port PORT  The port on which the server will be listening
  -v, --verbosity       Set the verbosity level
  -w WORKERS, --workers WORKERS
                        The maximum number of worker processes to spawn

SDTopacity

usage: SDTopacity [-h] [--tatm TATM] [--tau0 TAU0] [--t0 T0] files [files ...]

Calculate opacity from a skydip scan and plot the fit results

positional arguments:
  files        File to inspect

optional arguments:
  -h, --help   show this help message and exit
  --tatm TATM  Atmospheric temperature
  --tau0 TAU0  Initial value for tau (to be fit)
  --t0 T0      Initial value for Tsys (to be fitted)

SDTparselog

usage: SDTparselog [-h] [--to-csv] [--list-calon] [files ...]

Read ACS logs and return useful information

positional arguments:
  files         Single files to preprocess

optional arguments:
  -h, --help    show this help message and exit
  --to-csv      Save a CSV file with the results
  --list-calon  List files with calibration mark on

SDTpreprocess

usage: SDTpreprocess [-h] [-c CONFIG] [--sub] [--interactive] [--nofilt]
                     [--debug] [--plot] [--nosave] [--splat SPLAT]
                     [-e EXCLUDE [EXCLUDE ...]]
                     [files ...]

Load a series of scans from a config file and preprocess them, or preprocess a
single scan.

positional arguments:
  files                 Single files to preprocess

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        Config file
  --sub                 Subtract the baseline from single scans
  --interactive         Open the interactive display for each scan
  --nofilt              Do not filter noisy channels
  --debug               Be verbose
  --plot                Plot stuff
  --nosave              Do not save the hdf5 intermediate files whenloading
                        subscans.
  --splat SPLAT         Spectral scans will be scrunched into a single channel
                        containing data in the given frequency range, starting
                        from the frequency of the first bin. E.g. '0:1000'
                        indicates 'from the first bin of the spectrum up to
                        1000 MHz above'. ':' or 'all' for all the channels.
  -e EXCLUDE [EXCLUDE ...], --exclude EXCLUDE [EXCLUDE ...]
                        Exclude region from global fitting of baseline and
                        baseline subtraction. It can be specified as X1, Y1,
                        radius1, X2, Y2, radius2 in image coordinates or as a
                        ds9-compatible region file in image or fk5 coordinates
                        containing circular regions to be excluded. Currently,
                        baseline subtraction only takes into account fk5
                        coordinates and global fitting image coordinates. This
                        will change in the future.