| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> | 
|---|
| 2 | <html> | 
|---|
| 3 | <head> | 
|---|
| 4 | <?php include("base.inc"); ?> | 
|---|
| 5 | <title>ASAP - ATNF Spectral line Analysis Package</title> | 
|---|
| 6 | <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> | 
|---|
| 7 | <meta name="DC.Creator" lang="en" content="personalName=Marquarding,Malte" /> | 
|---|
| 8 | <meta name="ATNF.Maintainer" content="contactName=Marquarding,Malte" /> | 
|---|
| 9 | <meta name="DC.Title" lang="en" content="Homepage of Malte Marquarding" /> | 
|---|
| 10 | <meta name="DC.Title.alt" lang="en" content="" /> | 
|---|
| 11 | <meta name="DC.Subject" lang="en" content="spectral line" /> | 
|---|
| 12 | <meta name="DC.Description" lang="en" | 
|---|
| 13 | content="Just some links and conatact details" /> | 
|---|
| 14 | <meta name="DC.Date.created" scheme="ISO8601" content="2004-11-12" /> | 
|---|
| 15 | <meta name="ATNF.Site" content="Marsfield" /> | 
|---|
| 16 | <meta name="ATNF.AccessPermission" content="Public" /> | 
|---|
| 17 | <meta name="ATNF.MetaVersion" content="1.0" /> | 
|---|
| 18 | <?php standard_head(); ?> | 
|---|
| 19 | <STYLE TYPE="text/css"> | 
|---|
| 20 | <!-- | 
|---|
| 21 | B.asap { | 
|---|
| 22 | text-align: center; | 
|---|
| 23 | color: blue; | 
|---|
| 24 | } | 
|---|
| 25 | B.note { | 
|---|
| 26 | color: red; | 
|---|
| 27 | } | 
|---|
| 28 | PRE.commands { | 
|---|
| 29 | color: blue; | 
|---|
| 30 | font-size: smaller; | 
|---|
| 31 | } | 
|---|
| 32 | --> | 
|---|
| 33 | </STYLE> | 
|---|
| 34 | </head> | 
|---|
| 35 | <body bgcolor="#FFFFFF" text="#000000"> | 
|---|
| 36 | <?php | 
|---|
| 37 | title_bar("atnf"); | 
|---|
| 38 | title_crumbs("/computing/software/"); | 
|---|
| 39 | ?> | 
|---|
| 40 | <!-- Start Content --> | 
|---|
| 41 | <h1><a href="index.html">ASAP</a> 'commands'</h1> | 
|---|
| 42 | <pre class="commands"> | 
|---|
| 43 | ASAP> commands() | 
|---|
| 44 |  | 
|---|
| 45 | [The scan container] | 
|---|
| 46 | scantable           - a container for integrations/scans | 
|---|
| 47 | (can open asap/rpfits/sdfits and ms files) | 
|---|
| 48 | copy            - returns a copy of a scan | 
|---|
| 49 | get_scan        - gets a specific scan out of a scantable | 
|---|
| 50 | (by name or number) | 
|---|
| 51 | set_selection   - set a new subselection of the data | 
|---|
| 52 | get_selection   - get the current selection object | 
|---|
| 53 | summary         - print info about the scantable contents | 
|---|
| 54 | stats           - get specified statistic of the spectra in | 
|---|
| 55 | the scantable | 
|---|
| 56 | stddev          - get the standard deviation of the spectra | 
|---|
| 57 | in the scantable | 
|---|
| 58 | get_tsys        - get the TSys | 
|---|
| 59 | get_time        - get the timestamps of the integrations | 
|---|
| 60 | get_sourcename  - get the source names of the scans | 
|---|
| 61 | get_azimuth     - get the azimuth of the scans | 
|---|
| 62 | get_elevation   - get the elevation of the scans | 
|---|
| 63 | get_parangle    - get the parallactic angle of the scans | 
|---|
| 64 | get_unit        - get the current unit | 
|---|
| 65 | set_unit        - set the abcissa unit to be used from this | 
|---|
| 66 | point on | 
|---|
| 67 | get_abcissa     - get the abcissa values and name for a given | 
|---|
| 68 | row (time) | 
|---|
| 69 | set_freqframe   - set the frame info for the Spectral Axis | 
|---|
| 70 | (e.g. 'LSRK') | 
|---|
| 71 | set_doppler     - set the doppler to be used from this point on | 
|---|
| 72 | set_dirframe    - set the frame for the direction on the sky | 
|---|
| 73 | set_instrument  - set the instrument name | 
|---|
| 74 | get_fluxunit    - get the brightness flux unit | 
|---|
| 75 | set_fluxunit    - set the brightness flux unit | 
|---|
| 76 | create_mask     - return an mask in the current unit | 
|---|
| 77 | for the given region. The specified regions | 
|---|
| 78 | are NOT masked | 
|---|
| 79 | get_restfreqs   - get the current list of rest frequencies | 
|---|
| 80 | set_restfreqs   - set a list of rest frequencies | 
|---|
| 81 | flag            - flag selected channels in the data | 
|---|
| 82 | save            - save the scantable to disk as either 'ASAP' | 
|---|
| 83 | or 'SDFITS' | 
|---|
| 84 | nbeam,nif,nchan,npol - the number of beams/IFs/Pols/Chans | 
|---|
| 85 | nscan           - the number of scans in the scantable | 
|---|
| 86 | nrow            - te number of spectra in the scantable | 
|---|
| 87 | history         - print the history of the scantable | 
|---|
| 88 | get_fit         - get a fit which has been stored witnh the data | 
|---|
| 89 | average_time    - return the (weighted) time average of a scan | 
|---|
| 90 | or a list of scans | 
|---|
| 91 | average_pol     - average the polarisations together. | 
|---|
| 92 | The dimension won't be reduced and | 
|---|
| 93 | all polarisations will contain the | 
|---|
| 94 | averaged spectrum. | 
|---|
| 95 | convert_pol     - convert to a different polarisation type | 
|---|
| 96 | auto_quotient   - return the on/off quotient with | 
|---|
| 97 | automatic detection of the on/off scans | 
|---|
| 98 | (matched pairs and 1 off - n on) | 
|---|
| 99 | scale, *, /     - return a scan scaled by a given factor | 
|---|
| 100 | add, +, -       - return a scan with given value added | 
|---|
| 101 | bin             - return a scan with binned channels | 
|---|
| 102 | resample        - return a scan with resampled channels | 
|---|
| 103 | smooth          - return the spectrally smoothed scan | 
|---|
| 104 | poly_baseline   - fit a polynomial baseline to all Beams/IFs/Pols | 
|---|
| 105 | auto_poly_baseline - automatically fit a polynomial baseline | 
|---|
| 106 | recalc_azel     - recalculate azimuth and elevation based on | 
|---|
| 107 | the pointing | 
|---|
| 108 | gain_el         - apply gain-elevation correction | 
|---|
| 109 | opacity         - apply opacity correction | 
|---|
| 110 | convert_flux    - convert to and from Jy and Kelvin brightness | 
|---|
| 111 | units | 
|---|
| 112 | freq_align      - align spectra in frequency frame | 
|---|
| 113 | invert_phase    - Invert the phase of the cross-correlation | 
|---|
| 114 | swap_linears    - Swap XX and YY | 
|---|
| 115 | rotate_xyphase  - rotate XY phase of cross correlation | 
|---|
| 116 | rotate_linpolphase - rotate the phase of the complex | 
|---|
| 117 | polarization O=Q+iU correlation | 
|---|
| 118 | freq_switch     - perform frequency switching on the data | 
|---|
| 119 | stats           - Determine the specified statistic, e.g. 'min' | 
|---|
| 120 | 'max', 'rms' etc. | 
|---|
| 121 | stddev          - Determine the standard deviation of the current | 
|---|
| 122 | beam/if/pol | 
|---|
| 123 | [Selection] | 
|---|
| 124 | selector              - a selection object to set a subset of a scantable | 
|---|
| 125 | set_scans          - set (a list of) scans by index | 
|---|
| 126 | set_cycles         - set (a list of) cycles by index | 
|---|
| 127 | set_beams          - set (a list of) beamss by index | 
|---|
| 128 | set_ifs            - set (a list of) ifs by index | 
|---|
| 129 | set_polarisations  - set (a list of) polarisations by name | 
|---|
| 130 | or by index | 
|---|
| 131 | set_names          - set a selection by name (wildcards allowed) | 
|---|
| 132 | set_tsys           - set a selection by tsys thresholds | 
|---|
| 133 | reset              - unset all selections | 
|---|
| 134 | +                  - merge to selections | 
|---|
| 135 |  | 
|---|
| 136 | [Math] Mainly functions which operate on more than one scantable | 
|---|
| 137 |  | 
|---|
| 138 | average_time    - return the (weighted) time average | 
|---|
| 139 | of a list of scans | 
|---|
| 140 | quotient        - return the on/off quotient | 
|---|
| 141 | simple_math     - simple mathematical operations on two scantables, | 
|---|
| 142 | 'add', 'sub', 'mul', 'div' | 
|---|
| 143 | [Fitting] | 
|---|
| 144 | fitter | 
|---|
| 145 | auto_fit        - return a scan where the function is | 
|---|
| 146 | applied to all Beams/IFs/Pols. | 
|---|
| 147 | commit          - return a new scan where the fits have been | 
|---|
| 148 | commited. | 
|---|
| 149 | fit             - execute the actual fitting process | 
|---|
| 150 | store_fit       - store the fit parameters in the data (scantable) | 
|---|
| 151 | get_chi2        - get the Chi^2 | 
|---|
| 152 | set_scan        - set the scantable to be fit | 
|---|
| 153 | set_function    - set the fitting function | 
|---|
| 154 | set_parameters  - set the parameters for the function(s), and | 
|---|
| 155 | set if they should be held fixed during fitting | 
|---|
| 156 | set_gauss_parameters - same as above but specialised for individual | 
|---|
| 157 | gaussian components | 
|---|
| 158 | get_parameters  - get the fitted parameters | 
|---|
| 159 | plot            - plot the resulting fit and/or components and | 
|---|
| 160 | residual | 
|---|
| 161 | [Plotter] | 
|---|
| 162 | asapplotter         - a plotter for asap, default plotter is | 
|---|
| 163 | called 'plotter' | 
|---|
| 164 | plot            - plot a scantable | 
|---|
| 165 | save            - save the plot to a file ('png' ,'ps' or 'eps') | 
|---|
| 166 | set_mode        - set the state of the plotter, i.e. | 
|---|
| 167 | what is to be plotted 'colour stacked' | 
|---|
| 168 | and what 'panelled' | 
|---|
| 169 | set_selection   - only plot a selected part of the data | 
|---|
| 170 | set_range       - set a 'zoom' window [xmin,xmax,ymin,ymax] | 
|---|
| 171 | set_legend      - specify user labels for the legend indeces | 
|---|
| 172 | set_title       - specify user labels for the panel indeces | 
|---|
| 173 | set_abcissa     - specify a user label for the abcissa | 
|---|
| 174 | set_ordinate    - specify a user label for the ordinate | 
|---|
| 175 | set_layout      - specify the multi-panel layout (rows,cols) | 
|---|
| 176 | set_colors      - specify a set of colours to use | 
|---|
| 177 | set_linestyles  - specify a set of linestyles to use if only | 
|---|
| 178 | using one color | 
|---|
| 179 | set_histrogra,  - plot in historam style | 
|---|
| 180 | set_mask        - set a plotting mask for a specific polarization | 
|---|
| 181 |  | 
|---|
| 182 | [Reading files] | 
|---|
| 183 | reader              - access rpfits/sdfits files | 
|---|
| 184 | open            - attach reader to a file | 
|---|
| 185 | close           - detach reader from file | 
|---|
| 186 | read            - read in integrations | 
|---|
| 187 | summary         - list info about all integrations | 
|---|
| 188 |  | 
|---|
| 189 | [General] | 
|---|
| 190 | commands            - this command | 
|---|
| 191 | print               - print details about a variable | 
|---|
| 192 | list_scans          - list all scantables created bt the user | 
|---|
| 193 | list_files          - list all files readable by asap (default rpf) | 
|---|
| 194 | del                 - delete the given variable from memory | 
|---|
| 195 | range               - create a list of values, e.g. | 
|---|
| 196 | range(3) = [0,1,2], range(2,5) = [2,3,4] | 
|---|
| 197 | help                - print help for one of the listed functions | 
|---|
| 198 | execfile            - execute an asap script, e.g. execfile('myscript') | 
|---|
| 199 | list_rcparameters   - print out a list of possible values to be | 
|---|
| 200 | put into $HOME/.asaprc | 
|---|
| 201 | mask_and,mask_or, | 
|---|
| 202 | mask_not            - boolean operations on masks created with | 
|---|
| 203 | scantable.create_mask | 
|---|
| 204 |  | 
|---|
| 205 | Note: | 
|---|
| 206 | How to use this with help: | 
|---|
| 207 | # function 'summary' | 
|---|
| 208 | [xxx] is just a category | 
|---|
| 209 | Every 'sub-level' in this list should be replaces by a '.' Period when | 
|---|
| 210 | using help | 
|---|
| 211 | Example: | 
|---|
| 212 | ASAP> help scantable # to get info on ths scantable | 
|---|
| 213 | ASAP> help scantable.summary # to get help on the scantable's | 
|---|
| 214 | ASAP> help average_time | 
|---|
| 215 |  | 
|---|
| 216 | </pre> | 
|---|
| 217 | <!-- End Content --> | 
|---|
| 218 | <?php footer(); ?> | 
|---|
| 219 | </body> | 
|---|
| 220 | </html> | 
|---|