GBUsage.text :

---------------------------------------------------------------------------
     Notes on Usage of Obit in Greenbank

   Running Obit first requires setting a few environmment variables.
From tcsh this is
 > source ~bcotton/ObitSystem/setup.csh
or from bash
 > ~bcotton/ObitSystem/setup.sh

  Then to run the image viewer:
 > ObitView &
and to start the interactive python interface:
 > ObitTalk
the python prompt is ">>>"
If you want access to AIPS, either to write images in AIPS data format
or to run AIPS tasks, you should do the standard setup for running
AIPS.  In this case, ObitTalk will prompt for your AIPS user number
when starting.

   Documentation for using ObitTalk is available on the Obit home
page (http://www.cv.nrao.edu/~bcotton/Obit.html), or directly from
ftp://ftp.cv.nrao.edu/NRAO-staff/bcotton/Obit/ObitTalk.pdf.

Email notes:

---------------------------------------------------------------------------
Frank,

   I think I have the Obit CCB software installed and working under my
account in GB.  I've put the test data set in
/users/bcotton/AGBT05C_032_01/
the documentation, such as it is, is in /users/bcotton/KaBand
You should think of this as like AIPS but with an object-oriented
interface in python.   There are several steps involved:
1) Converting the archive data to the Obit FITS format ("OTF").  This
is done using a python function that checks what data are already in
your file, what new scans are mentioned in the scanLog.fits file and
runs task (in the AIPS sense) CCBOTF to convert it.  This gives
everything in one big happy file.
   For the example data, ObitTalk script scriptCCBRead.py does this,
execute by
 > ObitTalk scriptCCBRead.py
In this script it leaves the OTF file in the current directory rather
than FITSData where everything else expects it.

2) Editing, Done using python functions, see scriptCCBCalImage.py for
examples, I use fv to examine the data and decide what to flag, klunky
but it works.  The editing calibration and imaging examples in
scriptCCBCalImage.py  want you to set the environment variable $FITS
to FITSData so:
 > setenv FITS /home/users/bcotton/KaBand/FITSdata
or whereever you put it before starting up ObitTalk.
The way I use the python in scriptCCBCalImage.py is to cut and paste
into the python interpreter (use ObitTalk to bring up).

3) Calibration.  Script scriptCCBCalImage.py has code to define cal,
the calibration task object and sets its parameters.

>>> cal.g

executes the program

>>> cal.h

gives the task explanation

4) Imaging.  Script scriptCCBCalImage.py has several examples.  If you
have ObitView running, it will display the intermediate results and
let you edit the CLEAN window interactively.  You can look at ObitView
to browse the final results.


Files in ~bcotton/KaBand

GBUsage.text           Notes on how to use Obit in GB from the
                       installation in my account
OTFNotes.text          Crude notes on general GBT OTF imaging in Obit
                       more detail for CCB
scriptCCBCalImage.py   python script with example editing, calibration
                       and imaging
scriptCCBRead.py       python script to update OTF data file
setup.csh              tcsh script to set environment variables needed
                       to run Obit
setup.sh               sh (bash) script to set environment variables
                       needed to run Obit
instructions.text      This text

This should get you started,
Bill