Software tools related with the ASDM.


Browsing and checking.


xmllint.

Most of the tables of an ASDM datasets are XML documents located in a same common directory commonly called the ASDM's directory. The simplest way to get a clean view of one of these documents is to use the fairly standard command xmllint with the --format option. If you are familiar with the XPath expression language you can xmllint with the --shell option and from there fully customize the kind of output that you want to produce from the content of one document.

Availability.

In principle available on any Linux or Mac OS X platform.

asdmBrowser.

This program displays a tabular representation of an ASDM dataset in a GUI. It's a java application which requires a Java Runtime Environment.

Availability.

If you are working on a machine where the ACS/ALMA software is installed and configured you have it. Otherwise you can get it as a standalone package here. Untar the tarball somewhere, you'll get a directory asdmBrowser containing the code and a file README containing the instructions. UPDATED (to take into account the table CalAppPhase) -- MichelCaillat - 12 Mar 2014

asdmCheck.

This application performs a number of checks on the content of an ASDM to verify that constructions rules are respected (array shapes, references between tables, ...). Only the tables of metadata are considered by this application, not the binary files containing the visibilities. Output is sent to stdout.

Availability.

Available if and only if you are on a machine where the ACS/ALMA software is installed and operational.

asdmSummary.

Gives a quite exhaustive summary of the metadata attached to an ASDM. Output is sent to stdout.

Availability.

  • If you are working on a machine where the ACS/ALMA software is installed and configured you have it.
  • If you have CASA installed and your PATH and LD_LIBRARY_PATH environment variables properly configured to run the CASA applications in a standalone way you have it also.
  • Under casapy (the CASA command interpreter) it's available under the name asdmsummary (no capital 'S' !) . In this particular case the output is sent to the logger of the CASA session.


scanBrowser.

Gives a skeleton of the ASDM considered as collections of scans themselves considered as collections of subscans. Options allow to control the level of verbosity. Output is sent to stdout.

Availability.

It's a simple Python script which only requires a fairly complete and recent installation of this language (say >= 2.6.5). You can find it here. The script may need some edition depending where the env program is located your machine; take a quick look at the beginning of the script. Please don't forget to rename the downloaded file by simply removing the .txt extension.

toKML

Generates a file of the positions of the stations hosting the antennas recorded in an ASDM dataset (tables Station and Antenna). The file is at the KML format; drag'n drop it on Google Earth ( or simply open it from Google Earth) and you will see the array of antennas used for the observation.

Availability.

It's a simple Python script which only requires a fairly complete and recent installation of this language (say >= 2.6.5). You can find it here . The script may need some edition depending where the env program is located your machine; take a quick look at the beginning of the script. Please don't forget to rename the downloaded file by simply removing the .txt extension.

pyBDFBrowser.

An application to browse the content of a so called BDF file, i.e. one of the containing the visibilities of an ASDM. Let's recall that all these files are located in a subdirectory, named ASDMBinary, of the ASDM's directory. The user interacts with the application through a GUI.

Availability.

STE Machines.

On an STE machine, where the ACS/ALMA software is installed and operational, the application is available automatically for everyone.
Reduction Machines.

-- MichelCaillat - 22 Jan 2015

On reduction machines at ALMA a quasi standalone version of pyBDFBrowser can be installed after downloading this tarball. This package can be used without troubles in principle on a machine where :
  • CASA is installed.
  • CASA is installed at the usual standard location (/usr/lib64/casapy)
  • the OS is a 64 bits Linux like Scientific Linux or compatible.
Unpack the tarball to a location of your choice (<...>) , run once (per session) the setup script located in the package directory ( . <...>/pyBDFBrowser/setup) and run the application (pyBDFBrowser).

pyBDFCheck.

An application which simply reads one or many BDF files and reports if one problem is encountered by sending a message on stdout. It simply verifies that the content of the file is conform with the BDF.

Availability.

Available if and only if you are on a machine where the ACS/ALMA software is installed and operational.

bdfFlagsDetector.py.

A simple Python script which reports percentages of non nul flags in the binary data of an ASDM dataset. Launched from a shell it reports on standard output.

Availability.

Any machine running a reasonably recent version of Python (>= 2.6) should be able to host the execution of this script. An up to date version can be found here. (-- MichelCaillat - 12 Jun 2013)

bdfFlagBrowser.py

A simple Python script which allows to traverse the BDF files of an ASDM and to visualize which baselines and antennas have produced flagged data.

Availability.

Requires no special software except a pretty recent version of Python (>=2.6). A up to date version (1.8) can be found here . -- MichelCaillat - 10 Jul 2014

pyBDFExplorer

A Python library to fetch any part of observations done with the ALMA radiotelescope. Related to JIRA ticket http://ictjira.alma.cl/browse/ICT-2780

Availability.

It can be dowloaded at the LERMA git repository : http://lermagit.obspm.fr/alma/PyBDFExplorer . Once there, click on the button "Download zip" (or whatever other format which you'll have chosen).

Howto.

Visit the tutorial PyBDFExplorer.

-- MichelCaillat - 21 Apr 2015

-- MichelCaillat - 19 Jun 2012
  • scanBrowser.py.txt: A simple Python scripts to browse the [sub]scans of an ASDM.
  • toKML.py.txt: A simple Python script to see your antennas in Google Earth
  • asdmBrowser.tgz: A standalone version of the ASDM browser (aka asdmBrowser)
  • bdfFlagsDetector.py.txt: A simple Python scrip reporting the percentage of non null flags values in the BDFs of an ASDM
  • asdmBrowser.tgz: A standalone version of the ASDM browser (aka asdmBrowser)
  • bdfFlagBrowser.py.txt: The version 1.8 . Added option to select spectral resolution types and processor types. Finished the processing of radiometric data
Topic attachments
I Attachment Action Size Date Who Comment
asdmBrowser.tgztgz asdmBrowser.tgz manage 6191.7 K 12 Mar 2014 - 15:32 MichelCaillat A standalone version of the ASDM browser (aka asdmBrowser)
bdfFlagBrowser.py.txttxt bdfFlagBrowser.py.txt manage 56.3 K 10 Jul 2014 - 13:52 MichelCaillat The version 1.8 . Added option to select spectral resolution types and processor types. Finished the processing of radiometric data
bdfFlagsDetector.py.txttxt bdfFlagsDetector.py.txt manage 33.1 K 12 Jun 2013 - 15:42 MichelCaillat A simple Python scrip reporting the percentage of non null flags values in the BDFs of an ASDM
scanBrowser.py.txttxt scanBrowser.py.txt manage 14.5 K 19 Jun 2012 - 17:42 MichelCaillat A simple Python scripts to browse the [sub]scans of an ASDM.
toKML.py.txttxt toKML.py.txt manage 7.0 K 26 Jun 2012 - 16:08 MichelCaillat A simple Python script to see your antennas in Google Earth
Topic revision: r16 - 21 Apr 2015, MichelCaillat
 

This site is powered by FoswikiCopyright &© by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback