| Next revision | Previous revision |
| public:user_software:documentation:bbs [2016-10-11 09:03] – Document moved from engineering:software:tools:bbs Arno Schoenmakers | public:user_software:documentation:bbs [2017-03-08 15:27] (current) – external edit 127.0.0.1 |
|---|
| BBS has two modes of running. The first is to run as a stand-alone tool to calibrate one subband. If a single subband does not contain enough signal, BBS offers the possibility to use data from multiple subbands together for parameter estimation. This is called /global/ parameter estimation. On this page, we will focus on the stand-alone version; setting up a global solve is described elsewhere. | BBS has two modes of running. The first is to run as a stand-alone tool to calibrate one subband. If a single subband does not contain enough signal, BBS offers the possibility to use data from multiple subbands together for parameter estimation. This is called /global/ parameter estimation. On this page, we will focus on the stand-alone version; setting up a global solve is described elsewhere. |
| |
| **Currently this page is work in progress, see [[engineering:software:tools:bbsconfigurationsyntax|Configuration Syntax]] for the old version** | **Currently this page is work in progress, see [[bbsconfigurationsyntax|Configuration Syntax]] for the old version** |
| ===== Usage ===== | ===== Usage ===== |
| To calibrate a single MS, execute the ''calibrate-stand-alone'' script on the command line: | To calibrate a single MS, execute the ''calibrate-stand-alone'' script on the command line: |
| * ''<MS>'': name of the MS to process. | * ''<MS>'': name of the MS to process. |
| * ''<parset>'': description of the reduction (see below). | * ''<parset>'': description of the reduction (see below). |
| * ''<source catalog>'': A list of sources that can be used for calibration (see [[#source_catalog|below]]). When the MS already contains a sourcedb, it is not necessary to specify a new source catalog if you're calibrating on the same sourcedb. | * ''<source catalog>'': A list of sources that can be used for calibration (see [[bbs#source_catalog|below]]). When the MS already contains a sourcedb, it is not necessary to specify a new source catalog if you're calibrating on the same sourcedb. |
| * The ''-f'' option, which overwrites stale information from previous runs (remove old instrument table and old source model if they exist with the measurement set). | * The ''-f'' option, which overwrites stale information from previous runs (remove old instrument table and old source model if they exist with the measurement set). |
| * The ''-t'' option, which provides some basic multithreading. | * The ''-t'' option, which provides some basic multithreading. |
| </code> | </code> |
| |
| More information about the format is on the [[engineering:software:tools:makesourcedb|makesourcedb page]]. You can use [[engineering:software:tools:gsm.py|gsm.py]] to get a source catalog from an existing catalog. | More information about the format is on the [[makesourcedb|makesourcedb page]]. You can use [[gsm.py|gsm.py]] to get a source catalog from an existing catalog. |
| |
| ===== Creating a PARSET file describing a reduction ===== | ===== Creating a PARSET file describing a reduction ===== |
| ^ Parameter ^ type ^ default ^ description ^ | ^ Parameter ^ type ^ default ^ description ^ |
| | Step.<StepName>.Operation | string | | Operation to be performed in this step. Possible values are \\ ''PREDICT'': Simulate visibilities \\ ''ADD'': Add simulated visibilities to the input visibilities \\ ''SUBTRACT'': Subtract predicted visibilities from the input visibilities \\ ''CORRECT'': Correct the input visibilities \\ ''SOLVE'': Fit model parameters, perform a calibration | | | Step.<StepName>.Operation | string | | Operation to be performed in this step. Possible values are \\ ''PREDICT'': Simulate visibilities \\ ''ADD'': Add simulated visibilities to the input visibilities \\ ''SUBTRACT'': Subtract predicted visibilities from the input visibilities \\ ''CORRECT'': Correct the input visibilities \\ ''SOLVE'': Fit model parameters, perform a calibration | |
| | Step.<StepName>.Model | | | Description of the model to be used. Only subkeys of this key should be specified. See [[#Parameters_for_the_model|below]] | | | Step.<StepName>.Model | | | Description of the model to be used. Only subkeys of this key should be specified. See [[bbs#Parameters_for_the_model|below]] | |
| | Step.<StepName>.Baselines | string | *& | Baselines to process. See the key ''Strategy.Baselines'' | | | Step.<StepName>.Baselines | string | *& | Baselines to process. See the key ''Strategy.Baselines'' | |
| | Step.<StepName>.Correlations | string | [] | Correlations to process. If this key is not specified, all correlations will be selected. \\ <code>Step.simulate.Correlations = [XX,YY] | | Step.<StepName>.Correlations | string | [] | Correlations to process. If this key is not specified, all correlations will be selected. \\ <code>Step.simulate.Correlations = [XX,YY] |
| ===== References ===== | ===== References ===== |
| |
| * [[engineering:software:tools:bbsconfigurationsyntax | BBS parameter set documentation]] (old) | * [[bbsconfigurationsyntax| BBS parameter set documentation]] (old) |
| * [[engineering:software:tools:makesourcedb| makesourcedb, with the description of the sky catalog file format]] | * [[makesourcedb| makesourcedb, with the description of the sky catalog file format]] |
| * [[http://usg.lofar.org/wiki/doku.php?id=workshops:2009-02_processing_school:exercise_08 | BBS Exercise from the LOFAR Data Processing School]] | * [[http://usg.lofar.org/wiki/doku.php?id=workshops:2009-02_processing_school:exercise_08 | BBS Exercise from the LOFAR Data Processing School]] |
| * {{:software:performance_JvZ.pdf | Initial report on BBS performance (Joris van Zwieten, Jan 7, 2008)}} | * {{performance_JvZ.pdf | Initial report on BBS performance (Joris van Zwieten, Jan 7, 2008)}} |
| * {{:software:parmdb.pdf | Parameter database description (Ger van Diepen)}} | * {{parmdb.pdf | Parameter database description (Ger van Diepen)}} |
| * {{:software:makems.pdf | Creating (distributed) MeasurementSets (Ger van Diepen)}} | * {{makems.pdf | Creating (distributed) MeasurementSets (Ger van Diepen)}} |
| * {{:software:BBS_iono.pdf | Ionospheric calibration in BBS (Maaijke Mevius)}} | * {{BBS_iono.pdf | Ionospheric calibration in BBS (Maaijke Mevius)}} |