====== makebeamtables ======
As of 26-March-2011 BBS expects all info (e.g. antenna field layout) to be present in the MeasurementSet. This will be the case for observations done at or after this date, but not for older observations.

The program ''makebeamtables'' can be used to add such info the an old MeasurementSet.
It can be run like:

  makebeamtables param1=value param2=value ...

Running it with the ''-h'' option shows the available parameters and their possible default values.

^ Parameter ^ type ^ default ^ description ^
|||||
| ms | string | | Name of the MS. |
| antennaset | string | | Name of the AntennaSet used (e.g. LBA_OUTER or HBA_DUAL). |
| antennasetfile | string | /home/diepen/data/AntennaSets.conf | Name of the file describing AntennaSets. The default is usually fine. |
| antennafielddir | string | /home/diepen/data/AntennaFields | Name of the directory containing the AntennaField files. The default is usually fine. |
| ihbadeltadir | string | /home/diepen/data/iHBADeltas | Name of the directory containing the iHBADelta files. The default is usually fine. |
| overwrite | bool | false | Overwrite the beam subtables if they already exist? |

Usually only the parameters ''ms'' and ''antennaset'' need to be given.

==== Distributed run ====
Using the script [[cexecms| cexecms]] it is possible to execute ''makebeamtables'' on all subbands of an observation. It can be done like:

  cexecms "makebeamtables ms=<FILENAME> antennaset=LBA_OUTER" \
          "/data/scratch/pipeline/L2011_34173/L34173*uv.MS"

''cexecms'' will start a process on all lce nodes and execute the ''makebeamtables'' command (with the arguments) for all MSs matching the given file name pattern, while substituting the ''<FILENAME>'' placeholder with the actual MS name. Note that the quotes shown in the example are important.