PlanetPlots: Difference between revisions

From CASA Guides
Jump to navigationJump to search
Thunter (talk | contribs)
Thunter (talk | contribs)
 
(27 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;">
<code><pre style="background-color: #fffacd;">
au.planetPlots(objects='Venus,Ceres,Vesta,Pallas,Juno,Jupiter,Callisto,Europa,Ganymede,Io,Titan,Uranus,Neptune',  
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], standard = 'Butler-JPL-Horizons 2012',  
               date='2013-01-01', freqs = [100,230,345,690], pixels=800, standard = 'Butler-JPL-Horizons 2012',  
               alma_cycle=1,configs=None)
               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 (see help setjy)
objects: comma-delimited string of planetary bodies  
date: observing date, all plots are a 1-second snapshot at transit
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
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)
alma_cycle: 0 or 1 (will automatically fill in the configs offered)
configs: alternative to alma_cycle, specify a list of configurations, such as: ['alma_cycle1_1.cfg','alma_cycle1_2.cfg']
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>
</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==
==Examples==
<source lang="python">
<source lang="python">
CASA <3>: au.planetPlots(date='2012-10-20')
CASA <3>: au.planetPlots(date='2013-01-01')
</source>
</source>
[[File:2012-11-20.pdf]]
[http://casaguides.nrao.edu/images/a/a7/2013-01-01.pdf complete PDF]
Single page for Neptune:
<BR><BR>
[[File:Neptune.2012-11-20.labeled.png|800px|thumb|left|alt text]]
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 16: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