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 
WARNING: the linux binary distribution currently does not work with
python3.12 or later. 
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 (ObitBase), including
some third party software: 
%git clone https://github.com/bill-cotton/ObitBase/
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
 or 
 % make update.
  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
- no. 86 
pdf  Linear Image Mosaic Formation
- no. 87 
pdf  Broadband Image Effective Frequency
- no. 88 
pdf  Efficient Faraday Synthesis
- no. 89 
pdf  Cross Polarized Delay Calibration of Linear Feeds with XYDly.
- no. 90 
pdf  MeerKAT Continuum Scripts: Outline of Data Reduction and Heuristics
- no. 91 
pdf  Obit Imaging Tools
 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.
- ObitViewThis 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.
- ParselTongueParselTongue 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
- ObitTalkObitTalk 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?