Obit - Astronomy Software for Algorithm Development
Merx mollis mortibus nuper
Overview
Obit is a group of software packages for handling radio astronomy
data, especially interferometric imaging.
This software is made available under the GNU General Public License
in the hope that it might be useful but "as is" with NO GUARANTEE OR
ASSURANCE of suitability, usability or correctness for any purpose.
Obit is developed and maintained by Bill Cotton at The National
Radio Astronomy Observatory in Charlottesville, Virginia, USA.
Obit is intended primarily as an environment in which new data
processing algorithms can be developed and tested but which can also
be used for production processing of a certain range of scientific
problems.
Obit is a Unix software environment with a limited set of developed
applications.
It is an object--oriented set of class and utility libraries
allowing access to multiple disk--resident data formats.
In particular, access to either AIPS disk data or FITS files.
A number of low level applications are implemented such as imaging and
deconvolving interferometer.
High-level applications may be either compiled c programs or python
scripts; most of the high-level operations have bindings to python.
Obit applications are interoperable with Classic AIPS and the ObitTalk
python interface gives access to AIPS tasks as well as Obit libraries
and tasks.
A
preprint of a paper describing the Obit package (PASP, 2008, 120,
439) is available.
NOTE: Python 3 upgrade
As of version 608 (Nov. 2019), the Obit python routines should work
with either python version 2.7 or python 3, whichever is run using
command "python" (or /usr/bin/python).
Part of this upgrade is to require some python 3
features (e.g. parentheses in print statements) in existing scripts,
even using python 2.7.
This was a major revision of the python interface and it no longer
works with older versions of python.
Binary Distribution of Obit
Periodic binary distributions of Obit are available
here.
Obit Mac Installation using Homebrew
There is an installation package for Obit on Apple MacIntosh computers
developed by Ludwig Schwardt (schwardt@ska.ac.za) at SARAO that,
when it works, is very straightforward. There may be conflicts with other
installation packages.
The instructions are:
Using homebrew to install Obit on Macs
# If you do not have Homebrew (http://mxcl.github.com/homebrew/),
# uncomment and run the following and follow the instructions
# ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"
# Homebrew changes occasionally so you may need to check the site in future.
# This also needs git and curl.
# After that do:
% brew tap ska-sa/tap
% brew install --HEAD obit
Obtaining Development Obit
Github no longer supports the subversion server and now only git.
The anonymous server allows you to get the most up-to-date version
of software and then do updates to the software.
To checkout the Obit installation package from Subversion, including
most third party software:
%git clone https://github.com/bill-cotton/Obit/
This will checkout the installation package described below.
This software can be installed as described in the
README file.
Updates are then possible from the top level Obit directory using:
% git pull origin master
This should (hopefully) not require a passphrase.
Note: If you have a working linux installation build using the old NRAO svn server,
a description of a relatively painless migration to the new server is available in a
migration
file.
Documentation
Software Documentation
-
ObitTalk User documentation.
-
ObitTalk Software (python) architecture documentation.
-
Obit Software (c) architecture documentation.
-
Obit single dish (c) software architecture documentation.
-
doxygen generated Obit C language documentation.
-
doxygen generated Obit Single dish C language documentation.
Obit Algorithmic Development Memos
-
pdf Image Pixelization and Dynamic Range (EVLA memo 114).
-
pdf Automatic CLEAN Windowing (EVLA memo 116) .
-
pdf Beam Squint and Stokes V on the VLA (EVLA memo 113).
-
pdf Ionospheric Effects and Imaging and Calibration of the VLA (EVLA memo 118).
-
pdf Ionospheric Effects and Calibration of the VLA at 327 MHz (EVLA memo 117).
-
pdf Tools for Ionospheric Studies (EVLA memo 115).
-
pdf Users guide to Obit software for Mustang (GBT 3 mm bolometer
camera).
Obit Development Memo Series
- no. 1:
pdf Testing of multithreading implementation in Obit.
- no. 2:
pdf Testing of parallel processing of spectral line imaging.
- no. 3:
pdf Partial solution to wideband interferometric imaging problem.
- no. 4:
pdf Imaging Data From the MUSTANG Bolometer Array.
- no. 5:
pdf Multithreaded Image Interpolation.
- no. 6:
pdf Parallel Facet Imaging in Obit.
- no. 7:
pdf Simulating UV Data in Obit.
- no. 8:
pdf Testing Obit with a 100 GByte simulated dataset.
- no. 9:
pdf Performance Enhancement of the autoWindow technique.
- no. 10:
pdf User's Guide to Obit Software for the GBT/Mustang 3 mm
Bolometer Array.
- no. 11:
pdf Tests on a High Frequency EVLA 100 GByte Simulated Dataset.
- no. 12:
pdf Tests on a High Frequency EVLA TeraByte Simulated Dataset
- no. 13:
pdf Effects of Baseline Dependent Time Averaging of UV Data.
- no. 14:
pdf A vector Fast Sine/Cosine Routine.
- no. 15:
pdf Multi-facet CLEANing in Obit.
- no. 16:
pdf Removal of Interference from Low Frequency VLA data.
- no.17:
pdf Measurements of, and corrections for, the EVLA beam pattern.
- no.18:
pdf Attempt to adapt Sault-Wieringa 1994 wideband deconvolution to high dynamic
range applications.
- no.19:
pdf High dynamic range wideband imaging.
- no.20:
pdf Wideband phase and delay calibration.
- no.21:
pdf Efficacy of Obit Threading on an EVLA Dataset.
- no.22:
pdf Accurate Calibration of VLBI Measurements of Circular Polarization.
- no.23:
pdf Hanning smoothing and removal of strong, quasi-stationary,
narrow band RFI
- no.24:
pdf Multi-resolution CLEANing in Obit.
- no.25:
pdf False Detection Rate of Source Finding.
- no.26:
pdf Amplitude calibration of ALMA using polarized calibrators.
- no.27:
pdf A Fast Vector Exp Function.
- no.28:
pdf A New Method for Cross Polarized Delay Calibration of Radio Interferometers.
- no.29:
pdf EVLA Continuum Scripts: Outline of Data Reduction and Heuristics.
- no.30:
pdf On-axis Instrumental Polarization Calibration for Circular Feeds.
- no.31:
pdf On the Stability of EVLA C Band Polarization.
- no.32:
pdf On-axis Instrumental Polarization Calibration for Linear Feeds.
- no.33:
pdf Calibrating ALMA Phases with WVR Data.
- no.34:
pdf Polarization calibration and imaging of EVLA Demo Hercules A.
- no.35:
pdf Comparison of GPU and Multithreading for Interferometric DFT Model Calculation
- no.36:
pdf Comparison of GPU, Single- and Multi-threading for Interferometric Gridding
- no. 37:
pdf A Fast Sine/Cosine Routine: Revenge of the Vector Processors.
- no. 38:
pdf Wideband Widefield calibration models.
- no. 39:
pdf Differential Instrumental Polarization Calibration.
- no. 40:
pdf ALMA Continuum Scripts: Outline of Data Reduction and Heuristics.
- no. 41:
pdf Image Combination by Feathering.
- no. 42:
pdf Tiling the Field of View with Facets.
- no.43:
pdf False Detection Rate of Source Finding Revisited.
- no. 44:
pdf Simplified EVLA OTF Interferometry.
- no. 45:
pdf Note on Selfcalibration of EVLA Snapshot Imaging.
- no. 46:
pdf Note on Polarization Calibration of the EVLA.
- no. 47:
pdf EVLA Beam Holography take 2
- no. 48:
pdf Feathering vs. UV Data Combination.
- no. 49:
pdf AVX2: First Look.
- no. 50:
pdf Inner UV Taper Weighting for Synthesis Imaging.
- no. 51:
pdf ngVLA Dynamic Range.
- no. 53:
pdf Note on tuning the Middle autoWindow Loop: adding Deferents to Epicycles.
- no. 54:
pdf Manual Peeling in Obit.
- no. 55:
pdf Deep High Dynamic Range Imaging: A Case Study at S Band.
- no. 56:
pdf Confusion limited surveys with the ngVLA spiral configuration.
- no. 57:
pdf Efficacy of Double Buffered I/O.
- no. 58:
pdf Swimming Against the Current: DFT Imaging Revisited.
- no. 59
pdf The Ionosphere at L Band: MeerKAT.
- no. 60
pdf Source Finding in Crowded Fields.
- no. 61
pdf Notes on icc and AVX.
- no. 62
pdf MeerKAT L Band Polarimetric Calibration.
- no. 63
pdf Wide-band, Wide-field Imager MFImage.
- no. 64
pdf Distributed Processing in c in Obit.
- no. 65
pdf EVLA Calibration at High Frequency.
- no. 66
pdf Continuum Phase Referencing from Masers.
- no. 67
pdf AVX512: First look.
- no. 68
pdf Wide-band Polarization CLEAN.
- no. 69
pdf Calibration, Self Calibration and Astrometry.
- no. 70
pdf Beam Corrections and Heterogenous Arrays I: Total Intensity.
- no. 71
pdf Beam Corrections and Heterogenous Arrays II: Polarization.
- no. 72
pdf Multisource Peeling in Obit
- no. 73
pdf GPU-Based Visibility Gridding for Faceting.
- no. 74
pdf Parallel Spectral Line Imaging in Obit.
- no. 75
pdf Comparison of Vector and GPU Implementations.
- no. 76
pdf Faraday Synthesis of Unequally Spaced Data and Faraday Complex Deconvolution.
- no. 77
pdf MultiGPU-Based Visibility Gridding for Faceting.
- no. 78
pdf Broadband Polarimetry with Radio Synthesis Arrays.
- no. 79
pdf Averaging over Baseline with Position Shift.
- no. 80
pdf Primary Beam Corrections of MeerKAT Reference Pointed Data.
- no. 81
pdf Polarization Calibration of Linear Feeds – Keeping Linear Feed Basis
- no. 82
pdf Primary Beam Corrections of MeerKAT, Getting it Right
- no. 83
pdf Ionospheric Faraday Rotation Correction
- no. 84
pdf Multiband Spectral Analysis and Faraday Synthesis of Abell 3395
- no. 85
pdf EVLA Polarization Calibration in Low SNR
Presentations related to Obit
-
pdf W. Cotton, Presentation giving high level description of Obit
and a discussion of the autoWindow feature.
-
pdf ,
ppt
J. Uson, Application of the Squint beam squint correction to
VLA HI observations of super thin galaxies.
-
pdf ,
ppt
J. Uson, Steps towards a VLA or ALMA pipeline.
Obit Components
There are several components of Obit and related software.
This and required third party software can be obtained as described above.
Obit
This is the basic Obit package supporting astronomical images and
radio interferometry data and applications.
ObitSD
Ths is a single dish "On-the-fly" (OTF) imaging addon to Obit.
Only FITS format files are supported.
ObitSD requires Obit.
ObitView
This is a Unix/X-Windows program that serves as an Image display
server.
Communications is through the xmlrpc protocol.
It is currently usable by Obit and ObitSD to display images and
interactively select CLEAN windows.
ObitView can browse and display FITS images or local AIPS images can
be displayed if requested via the xmlrpc interface.
ObitView requires Obit.
ParselTongue
ParselTongue is a python-based scripting and interactive command line
interface to astronomical data processing packages.
ParselTongue can execute AIPS or Obit tasks (compiled programs) and use the
Obit python interface in a script.
ParselTongue is an EU funded component of RadioNet and is being
developed by the Joint Institute for VLBI in Europe (JIVE).
Information on ParselTongue is available
here
ObitTalk
ObitTalk is derived from ParselTongue but with more interactive
enhancements.
User documentation is available
here
as well as in extensive on-line documentation.
The (USA) National Radio Astronomy Observatory
(NRAO)
is operated by Associated Universities, Inc. and is a Facility of
the (USA) National Science Foundation.
Comments? Questions? Problems?