How To create the Pointing Plot

Example Plot

NEW SQL powered version of the script

The pointFoc.py script now accesses the Tapas database directly via a MySQL search. Now all used pointing corrections between two dates, for one project, or one project between two dates can be display with one command. Please refer to the Usage instructions below.

On mrt-lx3 the script is available systemwide for all users via:

> pointFoc.py 

For help see

> pointFoc.py -h 

If you want to use the script on other machines, please download the up-to-date version as instructed below. Using the script on your machine the command is:

> python pointFoc.py 

You have to have: matplotlib, numpy, MySQLdb and getpass installed on your machine.

Important

Since the script accesses Tapas directly it is secured with a password, which is the same as for the iramstaff account of the Tapas database.

Usage Instructions

This script creates a plot of the 30m pointing and focus used for observations for:

• a) all scans between two dates
  b) one specific project
  c) one specific project between two dates.
  

Input variables are:

• -s, --start : reads in Start Date
  -e, --end : reads in End Date
  -p, --project : reads in Project Name
  -o, --output : reads file name to save the Plot and its format
  -l, --list : creates a list of the pointing results and timestamps
  -h, --help : print this help
  

The format for dates need to be 'Year-Month-Day', e.g. '2012-01-06'
optionally a time can be also given by 'Year-Month-Day Hour:Minute:Second',
e.g. '2012-01-06 21:56:45'; with a space in between the Date and the Time.

Projects names are the 30m names, e.g. '105-09' or 'monitoring' etc..

For a) give only start and end dates
for b) only Project Name
for c) all three parameters.

Defaults:
A plot of all pointings and focus values of the
last week is the Default if nothing is specified.

The default output file is 'plPoiFoc.eps' in eps format.
Via -o name and format can be changed respectively.
Possible formats are png, eps, pdf, jpg.

Usage Examples:
(on mrt-lx3 skip python before the script name)

Case a):

> python pointFoc.py -s '2012-01-06' -e '2012-01-16'

Case b):

> python pointFoc.py -p '145-11'

Case c)

> python pointFoc.py -s '2012-01-06' -e '2012-01-16' -p '145-11'

Change plot name/path (to newName) and format (to png):

> python pointFoc.py -p '145-11' -o 'newName.png'

Download the Python Script

First off all you need the up-to-date version of the python script "pointFoc.py" that creates the plot. This can be downloaded here:

http://bazaar.launchpad.net/~ascurion/+junk/plPoiFoc/files

If you want you can contribute to the code via launchpad or send me changes you made so that I can include them. Any suggestions and improvements are welcome.

In case of Problems

If you get error messages and/or fail to create the plot, please check if you have the latest code. If so you may contanct me (CB, buchbend AT iram.es).

OLD Instructions

Script Revisions 4 and earlier on launchpad.

Get the Pointing results from Projects

Enter the Tapas webpage: https://mrt-lx3.iram.es/tapas/ . You'll have to log in with staff permissions to see the information of all projects. Please ask the computer group or me (CB) for the login details in case you don't know.

After logging in, go to the search form and enter the time range you want to display the pointing results for:

Now you'll obtain a somewhat confusing list of scans and projects that have been observed during that time:

To get the pointing results and the data format the program reads you have to select one project like shown in the previous image (Project 266-11).

Clicking on a project name leads you to this page:

Here you have to select the link '#All Scans' like indicated in the previous image. Now you'll get a list of all scans made in this project:

Note, that the scans may exceed the time range you have selected at the beginning, since this page displays all scans of a project. Long projects like the flux-monitoring easily cover months.

On the top of the page you can adjust the number of scans shown by changing the number of Rows. This number should always be larger than the number of total scans to assure that all scans are displayed. Finally, to get the information in the format the python script accepts you have to change "Format" to CSV. This results in the pop-up that is also displayed in the previous image.

Creating the input File for the Python Script

The information and format displayed in the CSV pop-up is what the python script expects. To get the script to work you'll need to create a text file that is called exactly:

pointFocus.txt

Please then copy the output displayed in the pop-up created by TAPAS into this text file.

Creating the Plot

Important for the script to work is that the PC that you are using has numpy and matplotlib, two python packages, installed. At the moment, without gra-lx4 available, only gra-lx18, my machine, has the right preferences, as far as I know.

Update by AS: Now the script can also be used on the mrt-aod and mrt-lx3 computers.

To create the plot, once you have the text file ready, you have thus to log into gra-lx18 and having pointFoc.py and pointFocus.txt in the same directory you need to execute in a terminal:

python pointFoc.py

This will print out the mean pointing and focus corrections on the screen and create the pointing plot named: plPoiFoc.eps in the same folder.

Plotting more than one project

To plot more than one project you just have to add the content of the CSV pop-up of the all projects to the same pointFocus.txt. Just append the new scans to the bottom of the already existing text file. The script orders the scans in time on its own. Don't worry about empty lines or lines that have not the right format since they are filtered out by the script.