Berk Commands

Command-line programs in the Berk package are described below.

berk

berk can perform many tasks, such as fetching data from the MeerKAT archive ; calibration and imaging ; cataloging ; and distribution of data products.

usage: berk [-h] [-o CAPTUREBLOCKID] [-s {decalsdr10,rubindp1}]
            [-d {parent,edr,dr1}] [-v] [--begin BEGINIMAGE] [--end ENDIMAGE]
            [--nsources NINJECTIONSOURCES] [--nrep NREPETITIONS]
            [--minflux MINFLUXJYINJ] [--maxflux MAXFLUXJYINJ]
            [--rad RADIUSFACTORTOINJECT]
            {list,fetch,setup,process1,process2,analyse,analyze,xmatch,collect,store,builddr,builddb,report,summarize,summarise,inject}

Positional Arguments

task

Possible choices: list, fetch, setup, process1, process2, analyse, analyze, xmatch, collect, store, builddr, builddb, report, summarize, summarise, inject

Task to run - one of: ‘list’ (list downloaded observations available for processing by captureBlockId), ‘fetch’ (retrieve data from archive, store under $BERK_MSCACHE location), ‘setup’ (link measurement set under ‘processing’ directory and set up for ‘process1’), ‘process1’ (run 1GC calibration with Oxkat), ‘process2’ (run imaging with Oxkat up to 2GC), ‘analyse’ (apply primary beam correction and make object catalogs with PyBDSF), ‘xmatch’ (cross-match with DECaLS DR10), ‘collect’ (collect data products for all processed observations - i.e., primary beam corrected images and catalogs), ‘store’ (store a more extensive set of processed data products for an observations for possible further processing in future), ‘builddr’ (build data release products), ‘builddb’(build survey-wide database and related products), ‘summarize’ (summarize the observations), ‘inject’ (estimate the completeness of catalogues using source injection).

Named Arguments

-o, --observation

MeerKAT observation to fetch and process. For the ‘fetch’ task, this must be a link to an .rdb file on the archive, of the form https://archive-gw-1.kat.ac.za/captureBlockId/captureBlockId_sdp_l0.full.rdb?token=longTokenString. For the other tasks (‘process’, ‘analyse’), this should be the captureBlockId itself.

-s, --opticalsurvey

Possible choices: decalsdr10, rubindp1

Name of optical survey to crossmatch (default: decalsdr10). Should be one of: decalsdr10 or rubindp1.

Default: 'decalsdr10'

-d, --dr

Possible choices: parent, edr, dr1

Name of data release to build or summarize. Should be one of: edr or dr1.

-v, --version

show program’s version number and exit

--begin

begin

Default: 0

--end

end

--nsources

Number of sources to inject. Default is 10000.

Default: 5000

--nrep

Number of repetitions to perform the injection. Default is 100.

Default: 50

--minflux

Minimum flux density (in Jy) of the sources to be injected. Default is 1e-5 Jy.

Default: 1e-05

--maxflux

Maximum flux density (in Jy) of the sources to be injected. Default is 1.0 Jy.

Default: 1.0

--rad

Radius factor to inject sources within (0 to 1). Default is 0.95, which means sources will be injected within the radius of the image.

Default: 0.95