PlanetPlots: Difference between revisions

From CASA Guides
Jump to navigationJump to search
(Created page with "'''Return to Analysis Utilities''' This page documents the '''planetPlots''' function of Python module analysisUtils. This function will create uv...")
 
 
(35 intermediate revisions by the same user not shown)
Line 3: Line 3:
This page documents the '''planetPlots''' function of Python module [[Analysis Utilities|analysisUtils]].
This page documents the '''planetPlots''' function of Python module [[Analysis Utilities|analysisUtils]].


This function will create uv amplitude vs. uvdistance visibility plots
By calling [http://casa.nrao.edu/stable/docs/TaskRef/predictcomp-task.html predictcomp],
for the specified objects, date, frequencies and ALMA configurations. The
this function will create uv amplitude vs. uvdistance visibility plots for a specified date
for the specified objects, frequencies and ALMA configurations. The
output is a multipage collection of a grid of plots, one
output is a multipage collection of a grid of plots, one
page per object, where rows are configurations and columns are frequencies.
page per object, where rows are configurations and columns are frequencies.


==Usage==
==Usage==
<code><pre style="background-color: #fffacd;">
au.planetPlots(objects='Venus,Mars,Ceres,Vesta,Pallas,Juno,Jupiter,Callisto,Europa,Ganymede,Io,Titan,Uranus,Neptune',
              date='2013-01-01', freqs = [100,230,345,690], pixels=800, standard = 'Butler-JPL-Horizons 2012',
              alma_cycle=1, longitude=-67.7549, configs=None, showbl0flux=True, keepcl=False, keeppngs=False,
              gs='gs, pdftk='pdftk', repotable='')


au.planetPlots(objects='Venus,Ceres,Vesta,Pallas,Juno,Jupiter,Callisto,Europa,Ganymede,Io,Titan,Uranus,Neptune',
objects: comma-delimited string of planetary bodies  
              date='2013-01-01', freqs = [100,230,345,690],
date: observing date, all plots are a 1-second snapshot at transit  
              standard = 'Butler-JPL-Horizons 2012', alma_cycle=None,
              configs = ['aca_cycle1.cfg','alma_cycle1_1.cfg',
                          'alma_cycle1_2.cfg','alma_cycle1_3.cfg',
                          'alma_cycle1_4.cfg','alma_cycle1_5.cfg',
                          'alma_cycle1_6.cfg'])
objects: comma-delimited string of planetary bodies (see help setjy)
date: observing date, all plots are a 1-second snapshot at transit
freqs: a list of frequencies, in GHz
freqs: a list of frequencies, in GHz
pixels: the width of each individual image in pixels (the smallest fonts are easily readable at 800)
standard: the model in casa to use
standard: the model in casa to use
alma_cycle: 0 or 1  
longitude: the longitude of the observatory in degrees East of Greenwich (default = ALMA)
configs:
alma_cycle: 0 or 1 (will automatically fill in the configs offered)
configs: uses this if alma_cycle=None, specify a configuration or a list of configurations, such as: ['alma_cycle1_1.cfg','alma_cycle1_2.cfg'], or 'aca_cycle1.cfg'
showbl0flux: True/False, list the zero-baseline flux density in the legend
keepcl: True/False, keep or remove the component lists generated by predictcomp
keeppngs: True/False, keep or remove the individual pngs (leaving only the PDFs)
gs: full path to ghostscript (in case it is not found in your path, but only used if pdftk is not found)
pdftk: full path to pdftk (in case it is not found in your path)
repotable: specify a non-default location for the repository table (../data/alma/simmos)
 
Pre-defined lists of configurations:
    alma_cycle=0:  configs=['alma.cycle0.compact.cfg',
                            'alma.cycle0.extended.cfg',
                            './alma.cycle0.hybrid.cfg',
                            ]
    alma_cycle=1:  configs=['aca_cycle1.cfg','alma_cycle1_1.cfg',
                            'alma_cycle1_2.cfg','alma_cycle1_3.cfg',
                            'alma_cycle1_4.cfg','alma_cycle1_5.cfg',
                            'alma_cycle1_6.cfg']
 
    alma_cycle=2:  configs=['aca.cycle2.i.cfg','aca.cycle2.ns.cfg','alma.cycle2.1.cfg',
                            'alma.cycle2.2.cfg','alma.cycle2.3.cfg',
                            'alma.cycle2.4.cfg','alma.cycle2.5.cfg',
                            'alma.cycle2.6.cfg','alma.cycle2.7.cfg]
 
</pre></code>
 
See [http://casa.nrao.edu/stable/docs/TaskRef/setjy-task.html setjy] for a list of bodies.  The ALMA
configurations listed above are distributed with casa, except for alma.cycle0.hybrid.cfg, which is available
[https://safe.nrao.edu/wiki/pub/Main/ALMABaselinesTable/alma.cycle0.hybrid.cfg here].
 
==Examples==
<source lang="python">
CASA <3>: au.planetPlots(date='2013-01-01')
</source>
[http://casaguides.nrao.edu/images/a/a7/2013-01-01.pdf complete PDF]
<BR><BR>
Single page extracted for Neptune:
[[File:Neptune.2013-01-01.labeled.png|800px|thumb|left|generated by casa-4.0.0]]

Latest revision as of 12:36, 6 September 2013

Return to Analysis Utilities

This page documents the planetPlots function of Python module analysisUtils.

By calling predictcomp, this function will create uv amplitude vs. uvdistance visibility plots for a specified date for the specified objects, frequencies and ALMA configurations. The output is a multipage collection of a grid of plots, one page per object, where rows are configurations and columns are frequencies.

Usage

au.planetPlots(objects='Venus,Mars,Ceres,Vesta,Pallas,Juno,Jupiter,Callisto,Europa,Ganymede,Io,Titan,Uranus,Neptune', 
               date='2013-01-01', freqs = [100,230,345,690], pixels=800, standard = 'Butler-JPL-Horizons 2012', 
               alma_cycle=1, longitude=-67.7549, configs=None, showbl0flux=True, keepcl=False, keeppngs=False, 
               gs='gs, pdftk='pdftk', repotable='')

objects: comma-delimited string of planetary bodies 
date: observing date, all plots are a 1-second snapshot at transit 
freqs: a list of frequencies, in GHz
pixels: the width of each individual image in pixels (the smallest fonts are easily readable at 800)
standard: the model in casa to use
longitude: the longitude of the observatory in degrees East of Greenwich (default = ALMA)
alma_cycle: 0 or 1 (will automatically fill in the configs offered)
configs: uses this if alma_cycle=None, specify a configuration or a list of configurations, such as: ['alma_cycle1_1.cfg','alma_cycle1_2.cfg'], or 'aca_cycle1.cfg'
showbl0flux: True/False, list the zero-baseline flux density in the legend
keepcl: True/False, keep or remove the component lists generated by predictcomp
keeppngs: True/False, keep or remove the individual pngs (leaving only the PDFs)
gs: full path to ghostscript (in case it is not found in your path, but only used if pdftk is not found)
pdftk: full path to pdftk (in case it is not found in your path)
repotable: specify a non-default location for the repository table (../data/alma/simmos)

 Pre-defined lists of configurations:
    alma_cycle=0:  configs=['alma.cycle0.compact.cfg',
                            'alma.cycle0.extended.cfg',
                            './alma.cycle0.hybrid.cfg',
                            ]
    alma_cycle=1:  configs=['aca_cycle1.cfg','alma_cycle1_1.cfg',
                            'alma_cycle1_2.cfg','alma_cycle1_3.cfg',
                            'alma_cycle1_4.cfg','alma_cycle1_5.cfg',
                            'alma_cycle1_6.cfg']

    alma_cycle=2:  configs=['aca.cycle2.i.cfg','aca.cycle2.ns.cfg','alma.cycle2.1.cfg',
                            'alma.cycle2.2.cfg','alma.cycle2.3.cfg',
                            'alma.cycle2.4.cfg','alma.cycle2.5.cfg',
                            'alma.cycle2.6.cfg','alma.cycle2.7.cfg]

See setjy for a list of bodies. The ALMA configurations listed above are distributed with casa, except for alma.cycle0.hybrid.cfg, which is available here.

Examples

CASA <3>: au.planetPlots(date='2013-01-01')

complete PDF

Single page extracted for Neptune:

generated by casa-4.0.0