Documentation of tasks in analysisUtils (including some from analyzemscal and analyzemsimage)

The analysisUtils python package provides numerous analysis utilities written in python that are useful for ALMA (and in many cases VLA) data reduction. All the commands listed below exist in the current package, and there are links for pages that contain help and (sometimes) example usage. If the link is not found, it simply means that I have not created a help page yet. The commands are simply shown alphabetically, though they should really be sorted into categories at some point. Commands preceded by amc are inside analyzemscal, while commands preceded by ami are inside analyzemsimage. The rest are in analysisUtils.py. A subset of these commands is included in the help text at the CASA guide for analysis utilities (which contains a download link for the analysis_scripts tarball). As a quick mental reminder, a list of a superset of these commands can be obtained at any time from inside CASA (or python) by typing au.help(). Also, to find all functions containing a specified string in the name, use the au.help command. For, example: au.help('asdm'). The argument is case-insensitive. There is a companion python file that contains more generic, non-ALMA-specific code, called toddTools, which is not yet publicly available.

Jump to letter: A B C D E F G H I J K L M N O P Q R S T U V W X Y

          A
  1. accumulateImfitResults -- Appends the results from a multi-component imfit result into a dictionary list
  2. addAxesToImage -- Adds a Stokes and (optionally) a frequency axis to an existing CASA image
  3. addDateToPlot -- Adds the current date/time to the bottom right of a plot
  4. addDoubleQuotesToFieldList -- Converts ['src0','src1'] or 'src0,src1' into '"src0","src1"', which is needed for the field parameter of pipeline PPRs
  5. addFrequencyAxisAbove -- Adds an upper x-axis label in frequency units to an existing plot
  6. addGaussianToFITSImage -- Adds a source with a 2D Gaussian profile to a 2D FITS image
  7. addGaussianToImage -- Adds a source with a 2D Gaussian profile to a 2D CASA image
  8. addLabelToPng -- Adds a text label to the top of a png.
  9. addToStateTable -- Adds a row to the STATE table of a measurement set
  10. adjustStartTimeInSysCal -- adjusts the TIME column in the SYSCAL table
  11. airmassToElevation -- Convert an airmass to elevation in degrees
  12. alignFunctions -- Takes any two functions and returns spline-fit versions sampled onto a common grid
  13. almaAntennaDiameter -- Converts an ALMA antenna name to a diameter (in meters)
  14. almaAntennaDiameters -- Converts a list of ALMA antenna names to a list of diameters (in meters)
  15. almaCycles -- Converts a date to ALMA observing cycle
  16. almaPadnameToObservatoryName -- Returns ALMAOSF if padname begins with 'TF' (for test facility pad)
  17. almaPrimaryBeamCorrection -- Computes the ratio of the current CASA primary beam correction scheme (10.7m Airy disk) to the current best ALMA Gaussian primary beam model
  18. almaToGeo -- Convert the local (horizontal) coordinates for ALMA pads into geocentric coordinates
  19. alternateRefantInPipelineTask -- Searches CASA log for use of an alternate refant in a specified pipeline task
  20. amendMaskForCube -- For channels with no clean mask, generates a clean mask from the pb and a specified intensity limit
  21. analyzecontsub -- Compares line-free cubes generated in two ways: imsub and uvcontsub
  22. amc.analyzemscal -- Generates the Cycle 0 QA2 plots for a pipeline-reduction and displays on a webpage side-by-side with the manual reduction
  23. ami.analyzemsimage -- Compares images created by the pipeline with their manually-generated counterparts
  24. angleToSun -- Compute the angle between the Sun and another object at a specified time (default=now) or within a measurement set
  25. angularOffsetUncertainty -- Computes the uncertainty in the angular separation of two positions
  26. angularScaleBaseline -- Computes the baseline length corresponding to the specified angular scale at the specified frequency.
  27. angularSeparation -- Computes the angular separation of two RA/Dec coordinates entered as four decimal values in degrees
  28. angularSeparationOfAllPlanetsFromSun -- Computes the angular separation of all major planets from the sun
  29. angularSeparationOfDirections -- Accepts two direction dictionaries and returns the separation in radians.
  30. angularSeparationOfDirectionsArcsec -- Accepts two direction dictionaries and returns the separation in arc seconds.
  31. angularSeparationOfFields -- Computes the angular separation of all (or specified) fields in an ms
  32. angularSeparationOfFieldsFromASDM -- Computes angular separation of the first source of two intents
  33. angularSeparationOfFieldsFromSource -- Computes the angular separation of all fields associated with a source ID from the source positions
  34. angularSeparationOfPB -- Computes the angular separation between the peak of the primary beam image and the phase center of the specified field name
  35. angularSeparationOfPlanets -- Computes the current separation of two planets or a planet and a fixed target, at the specified date/time, or at the time of a particular scan in an ms
  36. angularSeparationOfScans -- Computes the slew angle (both on-the-sky, and in each antenna axis) between scans of a measurement set
  37. angularSeparationOfStrings -- Computes the angular separation of two RA/Dec coordinates entered as single strings
  38. angularSeparationOfStringsFromFile -- Computes the angular separation of a list of RA/Dec coordinate pairs in a file
  39. angularSeparationRadians -- Computes the angular separation of two RA/Dec coordinates entered as four decimal values in radians
  40. angularSeparationRadiansTuples -- Computes the angular separation of two RA/Dec coordinates entered as two tuples in units of radians
  41. angularSeparationOfTwoFields -- Computes the angular separation of two field IDs of a measurement set
  42. antennaEfficiency -- Computes efficiency equation from page 114 of the ALMA technical handbook
  43. antennaEllipsoidalHeight -- Returns the height above the Earth ellipsoid model in meters of the pad of an antenna in a specific measurement set
  44. antennaEllipsoidalHeightFromASDM -- Returns the height above the Earth ellipsoid model in meters of the pad of an antenna in a specific ASDM
  45. antposcorrmm -- Converts a list of antenna position corrections for gencal into human-readable millimeters
  46. antposFromCasalog -- Reads number of antenna position corrections in a CASA log
  47. antposFromPipelineCasalog -- Reads number of antenna position corrections in a pipeline CASA log (after finding it)
  48. applyProperMotion -- Subtracts the proper motion of a source in a measurement set to infer its position in the J2000 epoch
  49. applyQA0FlagsToCaltable -- Creates a list of flag commands from the FLAG_CMD column of a measurement set and applies them to a caltable
  50. applySetjyToPipelineRestoration -- Applies the setjy commands from a casa_commands.log to a pipeline measurement set
  51. approximateBarycentricCoordinatesOfEarth -- computes approximate coordinates of Earth for the specified date
  52. asdmbits -- Computes the percentage of data in an ASDM that is 16 bits vs. 32 bits
  53. asdmbitsHistogram -- Plots a histogram from the dictionary created by asdmbits
  54. asdmExport -- Sets up the correct bash path and runs asdmExportLight on an NRAO CV Lustre node on one (or more) ASDMs
  55. asdmExportFromPPR -- Reads all ASDMs from a PPR and exports them from the archive using asdmExport
  56. asdmExportImport -- Sets up the correct bash path and runs asdmExportLight followed by importasdm and listobs on an NRAO CV Lustre node for one (or more) ASDMs
  57. asdmsFromPPR -- Gets the list of ASDMs from a PPR
  58. asdmspwmap -- Generate a list that maps the spw number in an MS to the corresponding value in the ASDM xml files
  59. Atmcal -- A class that examines the atmospheric calibration scans and can re-compute Trx and Tsys
  60. atmcalScansFromASDM -- Gets list of scans with CALIBRATE_ATMOSPHERE intent
  61. availableMasks -- Returns the list of values in the masks keyword of a CASA image header
  62. averageAntPosResults -- Takes multiple results from tc_antpos and generates a new XML file with weighted mean corrections
  63. averageTheRepeatedValues -- Accepts paired lists and averages the entries that have the same x value
  64. azelSeparation -- Computes azimuth and elevation separation between scans of different intents
    B
  65. baarsTaperFactor -- Converts a taper in dB to the constant X in the formula FWHM=X*lambda/D for a parabolic illumination pattern.
  66. bandforspw -- Determines the ALMA receiver band for a specified spw of a measurement set (or msmd instance)
  67. bandpasscalScansFromASDM -- Gets list of scans with CALIBRATE_BANDPASS intent
  68. bandpassPreAverage -- Computes the recommended frequency solint for bandpass calibration
  69. bandToFreqRange -- Converts ALMA band number to frequency range (in integer GHz)
  70. bandwidthsForField -- Returns the bandwidths of all spws used to observe the specified field
  71. beamCorrectionFactor -- Equation 14 and 15 of Gordon, Baars and Cocke
  72. beamSolidAngle -- Computes the effective solid angle of a Gaussian beam.
  73. blcTrcToLineSegments -- converts a BLC and TRC pixel to a list of line segments that outline the rectangle sides
  74. build_amc_exec_list -- Builds a list of analyzemscal commands corresponding to a list of ms's in a pipeline test results area
  75. build_ms_list -- Builds a list of ms's in a pipeline test results area for use in scripting additional casa commands
  76. buildConfigurationFile -- Creates a .cfg file of antenna pad positions (useful for simobserve) for the specified ALMA or VLA ms.
  77. buildHybridMask -- Takes a 3D mask and a flat mask, and puts the flat mask into any channels that are blank
  78. buildMinorPlanetPlot -- queries JPL Horizons (or CASA) for the position of a list of solar system bodies and creates a Gildas ASTRO script to plot their elevation vs. LST at ALMA, EVLA, GBT, CARMA or Mauna Kea
  79. buildPdfFromPngs -- takes a list of .png files and concatenates them into a multi-page PDF
  80. buildtarfile -- builds a tar file of the minimum number of files needed to distribute analysisUtils for use in casa
    C
  81. calcAndPlotAtmosphere -- simply way to overlay atmospheric curve an any plot that is vs. frequency
  82. calcAtmTransmissionforImage -- given an image, computes the atmospheric transmission vs channel
  83. calibratorService -- Accesses the prototype JAO calibrator flux density server
  84. casaEphemeris -- Reads information about an specified ephemeris table in the CASA data repository
  85. casalogClockTime -- Reads the timestamps from first and final line of a casa log and computes interval
  86. casaVersionFromCaltable -- Reads the CASA version string from the keywords of a caltable
  87. casaVersionFromLogfile -- Reads the CASA version string from the top of a CASA log file
  88. casaVersionFromWeblog -- Reads the CASA version string from a pipeline weblog
  89. celsiusToKelvin -- Adds 273.15 to the value
  90. centralObstructionFactor -- Computes the scale factor of an Airy pattern as a function of the central obscuration of an antenna
  91. channelAverageChannels -- Computes the channels used by ALMA to define the channel-average spws
  92. channelSelectionArrayToRangeString -- Converts a list of channels into a CASA channel selection range string
  93. channelSelectionRangesToIndexArray -- Converts a CASA channel selection range into a list of channels
  94. channelsForPreBandpass -- Compute the channel range corresponding to the central bandwidth of an spw
  95. checkALMALogs -- Downloads and searches the ALMA computing logs over a specified time range or dataset execution
  96. checkAntennaPositionFiles -- Shows the most recent entries in the antennaMoves.txt and almaAntPos.txt
  97. checkDelays -- Checks for delay jumps and large delays on an integration-by-integration basis by running gaincal('K')
  98. checkFieldTable -- Checks whether any fields in the FIELD table are associated with multiple source IDs
  99. checkGeodetic -- Checks the final date in the Earth Rotation Service files stored in CASA
  100. checkLogsForDelayJumps -- Runs checkALMALogs in search of late-arriving delay commands
  101. checkLogsForSubarrays -- Runs checkALMALogs in search of Array creation events
  102. checkOrder -- Takes two lists, and if the first list is in decreasing order, then it inverts both lists
  103. checkSamplers -- Compares channel 0 to adjacent channels in the TDM spectral windows and reports large ratios
  104. checkScienceSpwIFRanges -- Compares spw edges to baseband edges and returns dictionary of those within a threshold
  105. checkScienceSpws -- Compares science spw ID numbers between multiple measurement sets and reports if any differ
  106. checkScienceSpwSamplerRanges -- Returns a dictionary of all spws that lie within 30 MHz of the 2 or 4 GHz edge of the baseband
  107. checkScienceSpwsFromASDM -- Compares science spw ID numbers between multiple ASDMs and reports if any differ
  108. checksourceOffset -- Examines an ALMA pipeline working directory for check source images and draws their offset vectors on an RA/Dec plot centered on science target
  109. checksourceOffsetUncertainty -- Computes uncertainty in the position offset of the check source (or any point source whose image has been fit)
  110. checksourcePresent -- Returns True or False depending on presence of checksource observation in a dataset
  111. checkSourceTimeRatio -- Returns the fraction of time on check source intent compared to phase intent
  112. checkVirtualSpwsNeeded -- returns a list of pipeline runs in specified directory that require virtual spw mechanism in at least one EB
  113. check_for_time_gaps -- Checks for time gaps in the ALMA TMC database for a specified monitor point on a specified date
  114. clearPointingTable -- Removes all rows from the POINTING table of a measurement set.
  115. clearSpwFlags -- Clears channel-based flags in a specified spw and field ID
  116. clearTable -- Removes all rows from the specified table of a measurement set.
  117. columnStatistics -- Computes basic statistics on one column from an ASCII file
  118. combineConfigs -- Concatenates multiple antenna config files, discarding duplicate entries
  119. commonAntennas -- Find the antenna names common to two (or more) measurement sets
  120. compareAntennaPositionCorrections -- computes the difference between two sets of antenna position corrections meant for gencal
  121. compareAntPosResults -- compiles results from a bunch of baseline runs onto per-antenna plots
  122. comparedASDMSizeToCalibratedMS -- computes the size ratio of *.ms to ASDMs in a pipeline run
  123. compareFlagFiles -- Prints differences between two files
  124. compareFlags -- Compares the count of flags in two similar measurement sets
  125. compareFluxcsv -- Compares the contents of flux.csv file between two pipeline runs
  126. compareHanning -- Compares online-Hann window weighting in correlator with offline hanningsmooth function
  127. compareHeaders -- Compares two dictionaries, key by key
  128. comparePdfs -- Compares each individual pair of pages of two multi-page PDFs using the ImageMagick compare command
  129. comparePipelineTaskExecutionTimes -- Compares the task split time and running elapsed time of two pipeline runs
  130. comparePipeRuns -- Compare information about pipeline runs pickled with picklePipeRun (R. Indebetouw)
  131. comparePngs -- Compares two pngs images using the ImageMagick compare command.
  132. compareScanTimesWithSysCal -- Makes a summary plot of scan times and validity intervals of Tsys scans
  133. compareTables -- Compares two CASA tables, column-by-column and reporting if they differ
  134. compareTAIUTC -- Compares the contents of the TAIUTC tables of two different CASA builds
  135. compareTimesFromAnnotationTableToBandpassPreAverage -- Computes change in SNR if SSR determined times were to be used
  136. compareTimesFromCaltables -- Checks number of rows in two caltables and if equal, does statistics on the time differences
  137. compareTMCDB -- Gets current pad and antenna position values from the TMCDB, compares to what is in the ASDM and compute gencal command
  138. compareTsysSpectralWindowTableChanFreqsWithMS -- Compares the frequency grid in a Tsys table to its parent ms spectral_window table
  139. compareWeights -- Compares the weights between two measurement sets.
  140. complexToAmplitude -- converts a complex image into its amplitude
  141. complexToImaginary -- converts a complex image into its imaginary component
  142. complexToReal -- converts a complex image into its real component
  143. complexToSquare -- converts a complex image into its square (amplitude**2)
  144. computeAggregateBandwidth -- Computes the aggregate bandwidth for a specific list of spws of a measurement set.
  145. computeAvgchannel -- Computes the avgchannel values to use (e.g. in plotms) to display multiple spws smoothed to a common sensitivity bandwidth
  146. computeAzElFromRADecHourAngle -- Computes the Az/El for a specified Declination, hour angle, and observatory
  147. computeAzElFromRADecLST -- Computes the Az/El for a specified J2000 RA/Dec, LST, and observatory
  148. computeAzElFromRADecMJD -- Computes the az/el for a specified J2000 RA/Dec, MJD and observatory
  149. computeAzElForMS -- Computes the min/max/mean or median az/el for the aggregate of scans of a measurement set (optionally ignoring certain calibration scans)
  150. computesAzElForScan -- Computes the azimuth and elevation for the first integration of a specified scan in a measurement set
  151. computeClockTimeOfMS -- computes the elapsed time from the first through last scan
  152. computeDurationOfScan -- computes the number of subscans in a particular scan and their duration
  153. computeExpectedFWHM -- given a Gaussian beam and the diameter of a uniform disk, computes the expected observed FWHM
  154. computeIntervalBetweenTwoDays -- computes number of days between two YYYY-MM-DD strings
  155. computeITRFCorrection -- Computes the corrections to make to absolute geocentric coordinates XYZ (i.e. pad position) from an offset position given in local coordinates (i.e. antenna position).
  156. ComputeJulianDayFromUnixTime -- converts a unix time (in seconds) to Julian date
  157. ComputeLST -- Computes the LST time in hours for a specified MJD seconds and longitude
  158. computeLSTForElevation -- Computes the LST that an object passes the specified elevation
  159. ComputeLSTDay -- Computes the LST day, time, Julian day and time for a specified date/time and longitude
  160. computeMeanSpectrumFromMask -- Given a cube and a mask, returns the mean spectrum using ia.getprofile
  161. ALMA.ComputeNRAODopsetLST -- Computes the line of text that specifies the LST needed in an input file to NRAO dopset for a specific measurement set
  162. computePercentiles -- Computes the requested percentiles for an array and returns a dictionary
  163. computeRADecFromAzElMJD -- computes the J2000 ra/dec for a specified az/el, MJD and observatory
  164. computeRADecFromAzElUnixtime -- Reads an ASCII file with unixtime, azimuth and elevation and produces a new file with UT, RA, Dec, HA
  165. ComputeSolarAzEl -- Computes the azimuth and elevation of the sun for the specified time and observatory
  166. ComputeSolarRADec -- Computes the RA, Dec of the sun (in units of hours and degrees)
  167. ComputeSolarRADecRadians -- Computes the RA, Dec of the sun (in units of radians)
  168. computeStdDevMonteCarlo -- Computes Y and its uncertainty given uncertainties on a fitted slope and intercept, and a value of X
  169. computeTskyForSpw -- computes the sky temperature for the specified spw of a measurement set, using its PWV value.
  170. computeUTForElevation -- Computes the UT times that a specified source passes the specified elevation at your observatory
  171. computeUVThreshold -- Runs getCorrectedData and computes median and mad in uv bins
  172. computeYLimitsForXLimits -- Computes the Y-axis limits to autorange over the specified x-axis range
  173. computeYStatsForXLimits -- Computes the Y-axis statistics (mean, std, median, min, max) over the specified x-axis range, rather than over the whole range
  174. concatenateFiles -- Concatenates a list of text files and (optionally) deletes them
  175. configs -- List the .cfg files in the data/alma/simmos CASA directory
  176. configurationNearestNeighbors -- Finds the nearest neighbor antenna and distance for each antenna in a configuration file
  177. convertAntennaDictionaryToPad -- Converts a dictionary keyed by antenna name to one keyed by pad name
  178. convertColonDelimitersToHMSDMS -- Converts HH:MM:SS.SSS, +DD:MM:SS.SSS to HHhMMmSS.SSSs,+DDdMMmSS.SSSs
  179. convertPadDictionaryToAntenna -- Converts a dictionary keyed by pad name to one keyed by pad antenna
  180. convertImageToDirectionType -- Converts a CASA image with Linear coordinate system type (e.g. ALMA astroholography) to Direction type
  181. convertTimeStamp -- converts a makeTimeStamp string to Julian day number
  182. convertTimeStamps -- converts a list of makeTimeStamp strings to a list of Julian day numbers
  183. copyflags -- Copies the flag and flag_row columns from one dataset to another
  184. copyTsys -- copies some or all of the Tsys values in a Tsys caltable from one antenna to another
  185. copyweights -- Copies the weights from the WEIGHT column (scalar) to the WEIGHT_SPECTRUM column (vector)
  186. countChannels -- Counts the number of channels in a CASA channel selection string
  187. countChannelsInRanges - Counts the number of channels in each subrange of a single spw selection string
  188. countflags -- count the percentage of flagged data in an MS
  189. countMaskedPixels -- returns the number of pixels in a CASA image that are masked
  190. countUnmaskedPixels -- returns the number of pixels in a CASA image that are not masked
  191. countrows -- count the number of rows associated with each spectral window in an MS
  192. countPagesInPDF -- counts the number of pages in a PDF
  193. countVisibilities -- counts the number of visibilities in a measurement set
  194. createTsysTable -- Creates a blank Tsys table using the cb tool
  195. crossCaiSelection -- Finds baseline names that cross the CAI=32 boundary for a specified measurement set (see also lowCaiSelection)
  196. cubeInfoFromWeblog -- Reads information on cubes from the hif_makeimages weblog
  197. cubeLSRKToTopo -- Convert cube's frequency range back to TOPO
  198. cycleTime -- Computes median time between visits to a specified intent (default: PHASE)
    D
  199. dataratesForASDM -- Computes data rates for an ASDM
  200. dateFromDoy -- computes the date (time) string from a year and a day-of-year
  201. datasetsForMOUS -- gets the EBs for an MOUS, filtering by array type
  202. datasetsForProjectCode -- gets the EBs for a project code, filtering by array type
  203. dateStringListToMJDSecList -- converts a list of date strings ("yyyy/mm/dd hh:mm:ss") to a list of MJD seconds
  204. dateStringListToPlotDate -- converts a list of date strings ("yyyy/mm/dd hh:mm:ss") to a list of datetime structures suitable for pylab.plot_date
  205. dateStringDifference -- computes the number of minutes between two datestrings, as from a CASA log
  206. dateStringToMJD -- converts "yyyy/mm/dd hh:mm:ss" to MJD
  207. dateStringToMJDSec -- converts yyyy/mm/dd hh:mm:ss to MJD seconds, which is needed to specify plotrange for time in plotms
  208. dateStringToUnixTime -- converts a UT date/time string to unixtime in seconds
  209. dateTimeListToMJDSeconds -- converts a list of datetime structures to a list of MJD seconds (inverse of mjdSecondsListToDateTime)
  210. decimate3DArrayByMean -- reduces the length of one axis of a 3D array
  211. deconvolveDiskFromBeam -- the inverse function of computeExpectedFWHM
  212. decrad2dms -- Convert radians of declination to sexagesimal DD:MM:SS
  213. defaultSBGainsForBand -- Returns the default sideband gains for the signal and image bands used by TelCal
  214. deg2radec -- Convert a single RA/Dec position from degrees to a sexagesimal string
  215. degfile2radec -- Convert a list of RA/Dec positions in a file from degrees to sexagesimal strings
  216. detectNegativeTrx -- searches the SYSCAL table of the ms for negative receiver temperatures and reports them
  217. detectNegativeTsys -- searches the SYSCAL table of the ms for negative system temperatures and reports them
  218. differencePhaseSolutions -- takes the phase difference between two CASA gaincal tables
  219. differencePipelineContDat -- takes the difference between two cont.dat files (must match in number of ranges)
  220. directionList2radecDegrees -- convert a list of CASA direction dictionaries into a list of RA, Dec values in degrees
  221. direction2rad -- extracts the direction as a radian list from a CASA direction dictionary
  222. direction2radec -- converts a CASA direction dictionary to RA, Dec string in sexagesimal format
  223. direction2radecForSimobserve -- converts a direction dictionary to RA, Dec string in sexagesimal format that simobserve expects
  224. directorySize -- computes the size of a directory tree in bytes
  225. dminfo -- prints the contents of tb.getdminfo into a text file
  226. doubleIntervalInSysCal -- adjusts the INTERVAL and TIME columns of the SYSCAL table
  227. doyFromDate -- gets the day of year from the specified date time string
  228. DrawAntennaLegend -- writes colorized antenna names just outside the right side y-axis edge of a plot
  229. dutyCycle -- computes duty cycle of observing the science target in ALMA measurement set (ignoring subscan latency)
    E
  230. editFieldname -- Change a field name in a measurement set (FIELD and SOURCE tables)
  231. editFieldnameASDM -- Change the field name in the ASDM (in all 4 xml files where it appears)
  232. editIntents -- change the intents for a specified field in an ms (based on John Lightfoot's pipeline script)
  233. editIntentscsv -- change the intents in a list of measurement sets based on a csv-text file
  234. effectiveAntennas -- converts a number of baselines into the equivalent number of antennas for sensitivity purposes
  235. effectiveBandwidth -- Reads the effective bandwidth of a channel of an spw from a measurement set
  236. effectiveBandwidthASDM -- Reads the effective bandwidth of a channel of an spw from an ASDM
  237. effectiveResolution -- Reads the effective resolution of a channel of an spw from a measurement set
  238. effectiveResolutionASDM -- Reads the effective resolution of a channel of an spw from an ASDM
  239. effectiveTaper -- Converts an observed value of the constant X in the formula FWHM=X*lambda/D into an edge taper in dB
  240. elevaitonSeparationOfFields -- computes global or per-scan mean elevation separation between all combinations of fields in a dataset
  241. elevationSeparationPhaseScience -- computes mean separation in elevation between first phase calibrator and each science target
  242. elevationToAirmass -- Converts an elevation in degrees to airmass
  243. emulateLowGainFlag -- Computes antenna/spw combinations that will be flagged by hif_lowgainflag
  244. equivalentDiskDiameter -- Computes size of top-hat disk that would reproduced the measured size of a marginally-resolved object in an image
  245. estimateMRS -- Computes the MRS=LAS for a specified measurement set
  246. estimateMRSForConfig -- reads an antenna config file and computes the expected maximum recoverable scale for a specified frequency
  247. estimateOpacity -- converts a value of PWV and frequency to opacity as a function of observatory site
  248. estimateSynthesizedBeam -- reads a measurement set and computes expected beamsize
  249. estimateSynthesizedBeamForConfig -- reads an antenna config file and computes the expected beamsize for a specified frequency
  250. estimateSynthesizedBeamFromASDM -- read the max baseline and representative frequency from an ASDM and compute beamsize
  251. everOccupied -- determines if a specific ALMA pad has ever been occupied (as indicated by antennaMoves.txt)
  252. examineContext -- prints the science goal values from a pipeline context file
  253. exportAndGetWeatherStationPositionFromASDM -- exports ASDM if necessary, then returns the position of the first weather station containing the specified string
  254. extendIntervalInSysCal -- increases the value in the INTERVAL column in all rows of the specified caltable
  255. extractAzimuthalAverageFromImage -- uses azimuthalAverage to compute and write out the radial profile of 1..3 images
  256. extractCutFromImage -- extra a single row or column from a CASA image, and optionally run a Gaussian fit on it
  257. extractPipelineStage -- extracts the pipeline stage number from a pipeline-generated file
  258. extractPngListFromCSVFile -- extracts all the png filenames from a CSV-format file
  259. extractSetJyCommandsFromCasaCommandsLog -- extracts all setjy calls from a casa_commands.log
  260. extractSpatialAxisValues -- extracts the array of RA or Dec values from a CASA or FITS image
    F
  261. extractTcleanCommands -- extracts the tclean commands for a specified intent from a pipeline CASA log
  262. extractTcleanCommandsAndModify -- extracts the tclean commands for a specified intent from a pipeline CASA log, modifies them and writes them into a script
  263. farfieldDistance -- Computes the Fraunhofer distance for a specified observation or combination of baseline length and frequency
  264. fieldsfornames -- Extends the msmd method fieldsforname to a list of names
  265. fillAsdmList -- Takes a list of ASDMs from the same array/night and fills in the missing leading characters where missing
  266. fillZerosInDate -- Add leading zeros to month and day in a date string
  267. filterAndDecimate -- Runs a low-pass filter and decimates a signal by an even factor
  268. filterAndDecimateFromFile -- Reads a 2-column ascii file and runs filterAndDecimate on the signal it contains
  269. filterDictionary -- Filters a dictionary so that it only has keys that are present in a second dictionary
  270. filterOutLines -- Removes all lines from a file that match a string
  271. findAzimuthOfNearestPadToPad -- Computes the azimuth vector from an ALMA pad to its nearest neighbor
  272. findChannel -- Finds the channel in a cube that is nearest in frequency to a specified channel in a different cube
  273. findConfigurationFile -- Searches for an antenna configuration file in the current directory, then the CASA repository
  274. findDaytime -- Finds the range of date values corresponding to daylight hours suitable for marking a pylab.plot_date plot
  275. findFindcontPlot -- Finds the findContinuum png in an ALMA imaging pipeline weblog for the specified science target cube
  276. findFindcontResidualCubes -- Finds the list of findcont cubes from a pipeline run
  277. findFindcontResidualJointMasks -- Finds the list of findcont joint masks from a pipeline run
  278. findFindcontStageDir -- Finds the html/stage26,28 directory for the hif_findcont stage of an ALMA imaging pipeline weblog
  279. findFindcontStageNumber -- Returns the stage number for the hif_findcont stage of an ALMA imaging pipeline run using its weblog
  280. findFWHM -- Finds the full-width at a specified fraction of the maximum from two lists (x,y)
  281. findImageSpwsFromCasalog -- Examines a pipeline CASA log file and finds the spws images on the science target
  282. findLineNumber -- Finds the line number of the first occurrence of a string in a file
  283. findLineNumberAndTimestamp -- Finds the line number and timestamp of the first occurrence of a string in a CASA log file
  284. findNearestField -- Find the entry in a list of RA,Dec's nearest to a specified RA,Dec
  285. findNearestFieldInVis -- Find the field in a measurement set nearest to a specified RA,Dec
  286. findNearestPadToPad -- Find the nearest neighboring pad to a specified ALMA pad
  287. findNearestPadToXYZ -- Finds the nearest ALMA pad to a specified ITRF position
  288. findNearestVLBISources -- Searches the Petrov catalog around a specified direction
  289. findNull -- Find the baseline length corresponding to a specified fractional peak amplitude of a uniform disk source
  290. findOffsetAxis -- Find which axis (or the length thereof) of a CASA image contains the name 'Offset' (as created by impv)
  291. findPipelineAmpCalTable -- Finds the name of the timegaincal amplitude table
  292. findPipelineCalibratorTcleanCommand -- Extracts the tclean command from casa_commands.log for specified calibrator intent
  293. findPipelineCalTable -- Finds a file matching a specified wildcard string
  294. findPipelineCasaCommandsLog -- returns the path to the casa_commands.log in a pipeline run
  295. amc.findPipelineCasaLogfile -- searches the specified directory tree for the newest casa log file, optionally containing an applycal call on a specified ASDM
  296. findPipelineCasaVersion -- Searches either the CASA log or the pipeline weblog to get the pipeline version string
  297. findPipelineCubes -- finds a list of all cleaned cubes in a pipeline working directory
  298. findPipelineImage -- finds the name of the image file in a pipeline working directory corresponding to the specified field and spw
  299. findPipelineImages -- finds all the image names made by the pipeline
  300. findPipelineRunCasaLogs -- Searches a pipeline execution directory and returns a list of casa log files, optionally containing a call to one of a list of tasks
  301. findPipelineTaskExecutionTimes -- Assembles a list of time intervals from a CASA log of a pipeline run
  302. findPipelineTsysCalTable -- Finds the path of the tsys caltable
  303. findPipelineTsysCalTablePlot -- Finds the path of the weblog plot for the tsys caltable for a specified spw and antenna
  304. findPixel -- Takes an image and converts a pixel to an RA,Dec and (optionally) the separation from a reference position
  305. findPixels -- Takes an image and converts a list of pixels to a list of RA,Decs and (optionally) the separation from a reference position
  306. findRADec -- Takes an image and converts an RA, Dec value to pixel value
  307. findSpectralAxis -- Finds the number of the spectral axis of an image cube
  308. findStokesAxis -- Finds the number of the Stokes axis of an image cube
  309. findWeblog -- Uses the unix find command to locate a weblog in a directory tree (i.e. faster if you start from /working)
  310. fitFitsBeam -- Fits a PSF image, which is useful if the header contains no beam
  311. fitLapseRate -- fits the temperature lapse rate measured by the oxygen sounder
  312. fitLapseRateAndScaleHeightASDM -- fits the lapse rate and scale height measured by the oxygen sounder for the start time of an ASDM
  313. fitLapseRateAndScaleHeightASDMs -- fits the lapse rate and scale height measured by the oxygen sounder for the start time of a list of ASDMs
  314. fitScaleHeight -- fits the water vapor density scale height measured by the oxygen sounder
  315. fixASDM -- Restores the missing newline character at the end of every .xml file of an ASDM
  316. fixBandwidthsInASDM -- Fixes the effective resolution and effective bandwidth of pre-Cycle-3 ASDMs
  317. fixBandwidthsInMOUS -- Fixes the effective resolution and effective bandwidth of a list of pre-Cycle-3 ASDMs
  318. fixConcatSigmaSpectrum -- Fix for CAS-9238 (concat not copying the sigma_spectrum column for subsequent ms)
  319. fixFeedTableTimes -- Copies the time in the first row of the FEED table to all rows
  320. fixMyDelays -- read the Delay solutions from the ASDM, and compute a caltable to correct them
  321. fixpointing -- converts the MS POINTING table from commanded positions to encoder positions (from CSV-2878)
  322. FixPosition -- a class with various methods to fix problems with the direction of sources in an ms
  323. fixReceptorAngles -- Changes the value of the receptor angle in the FEED table of a measurement set
  324. fixScanNumbers -- Detects times when the field name changes, and increments the scan number (for SMA data read with sma2casa).
  325. fixuvw -- Runs calcuvw of the imtool toolkit to recalculate the UVW coordinates of a measurement set
  326. fixvisPermissions -- Runs chmod on all subdirectories of a specified directory
  327. flagcmdplot -- Runs flagcmd(action='plot') for each reason code, one at a time, and builds a multi-page PDF
  328. flagDurations -- Computes the durations of all flag commands in the FLAG_CMD table of a measurement set
  329. amc.flagMatrix -- Runs the agent flagger on each baseline and generates a display of baselines that are fully (or mostly) flagged
  330. flagReasons -- Returns a unique list of flag reasons from an ASCII flag commands file
  331. flagReasonStats -- Returns a dictionary of the percentage of data flagged by online flags for each reason
  332. flagTsysFeature -- Flags the SYSCAL table for a specified antenna, field, spw, which can be done at the pipeline pause after import
  333. flagTsysTable -- Flags a Tsys cal table by antenna, spw or time
  334. flattenMask -- Builds a 2D image mask from a 3D cube mask
  335. flipSignDeclination -- Flips the sign of declination for a source ID in the FIELD and/or SOURCE tables of a measurement set
  336. flipSignDeclinationSourcexml -- Flips the sign of declination for a source ID in the Source.xml file of an ASDM
  337. fluxCalibrationAccuracy -- Prints the percent accuracy per band claimed in the ALMA Cycle 6 technical handbook
  338. fluxcalScansFromASDM -- Gets list of scans with CALIBRATE_FLUX intent
  339. fluxscaleMean -- Compute the uncertainty-weighted mean of the flux density measurements in a fluxscale dictionary
  340. fluxscaleLogMean -- Compute the mean and standard deviations of flux densities reported in a sequence of fluxscale log outputs
  341. fluxscaleParseLog -- Extract the spectral index fit parameters from the ASCII file produced by the casa task fluxscale as needed by setjy.
  342. frames -- convert an optical velocity into different optical and radio frames (LSRK, TOPO)
    G
  343. gaincalMosaic -- Computes a list of field IDs that have a fraction of solutions above a threshold SNR
  344. gaincalSNR -- Computes the per-antenna SNR expected for gaincal(solint='inf') on a per-spw basis
  345. gaussianBeamOffset -- Computes the radius at which the response of a Gaussian beam drops to the specified level
  346. gaussianBeamResponse -- Computes the gain at a radial offset from the center of a Gaussian beam
  347. genImageName -- Generates an image name that follows the ALMA archive convention; used by NA manual imaging script template
  348. geoToAlma -- convert geocentric coordinates into local (horizontal ones)
  349. getAllBaselineLengthsFromASDM -- returns a list of the baseline lengths in an ASDM, by default sorted by length, with option to create a histogram
  350. getALMAFlux -- contacts ALMA calibrator catalog, computes the spectral index between Bands 3 & 7 and interpolates/extrapolates
  351. getALMAFluxcsv -- reads the initial pipeline-produced flux.csv file (and measurement set) and updates the flux densities into a new flux.csv file
  352. getALMAFluxForMS -- runs getALMAFlux for all fields in a measurement set
  353. getALMAFluxSMA -- Compare a list of SMA calibrator flux densities with the ALMA catalog and compute the statistics of the ratio.
  354. getALMASpectralIndex -- looks through history of calibrator catalog, computing spectral index for the closest Band 3/7 measurement(s)
  355. getALMASpectralIndexCycle6 -- looks through history of calibrator catalog, computing spectral index for the closest (with settable tolerance) Band 3/7 measurement(s)
  356. getAntennaIdsFromCaltable -- gets a list of unique antenna IDs that have solutions in a caltable
  357. getAntennaNames -- Returns the list of antenna names in the ANTENNA table of a dataset
  358. getAntennaNamesForObsID -- Returns the list of antenna names in a particular obsid of a dataset
  359. getAntennaNamesFromCaltable -- Returns the list of unique antenna names from a caltable
  360. getAntennaPadXYZ -- Gets the geocentric position of the pad holding the specified antenna ID in the specified measurement set
  361. getAntennaStationsFromCaltable -- Returns the list of unique antenna stations from a caltable
  362. getAntennaPads -- Returns a list of antenna station names from a measurement set
  363. getAntennaPadsForObsID -- Returns list or dictionary of pads for one portion of a concatenated measurement set
  364. getAntennaPadsFromASDM -- returns a dictionary of antenna/pad association for the specified ASDM
  365. getApexWeather -- retrieves weather for a whole day from the APEX telescope station
  366. getArrayIDs -- gets the list of ARRAY_ID for a measurement set
  367. getAtmcalStateIDsFromASDM -- reads the State.xml file of an ASDM and returns a dictionary
  368. getBand -- Converts a frequency in Hz to the ALMA band number (ambiguity in bands 2/3 overlap)
  369. getBandwidthFromCaltable -- Reports the bandwidth of an spw from the SPECTRAL_WINDOW table of a caltable
  370. getBasebandNumber -- Obsoleted by msmd.baseband
  371. getBasebandNumberFromASDM -- Gets the baseband number for an spw in an ASDM
  372. getBasebandNumbers -- Gets an array containing the baseband number of each spw in a measurement set
  373. getBaselineLength -- compute the baseline length between 2 antennas in an ms and its percentile for the configuration
  374. getBaselineLengthForStations -- compute the baseline length between 2 stations in an antenna config file
  375. getBaselineLengths -- returns a list of the baseline lengths in your ms, by default sorted by length, with option to create a histogram
  376. getBaselineLengthsMultiVis -- returns an aggregated list of the baseline lengths in a list of ms, by default sorted by length, with option to create a histogram
  377. getBaselineLengthsMultiVisMultiOUS -- runs getBaselineLengthsMultiVis for a list of pipeline runs in a directory
  378. getBaselinesInMainTable -- returns an array of tuples containing the antenna IDs of each baseline contained in the main visibility table
  379. getBaselineStats -- Compute statistics on the baseline lengths of the specified ms.
  380. getBaselineStatsFromASDM -- Compute statistics on the baseline lengths of the specified ASDM.
  381. getBaselineTsysFromCaltable -- returns a scalar value of Tsys for a baseline
  382. getCalibrationIntents -- Returns a list of calibration intents for a specified measurement set and field ID
  383. getCalibratorFromASDM -- Returns the name of the calibrator(s) observed for a specified intent from an ASDM
  384. getCalibratorFromASDMs -- Returns a dictionary of the calibrator(s) observed for a specified intent from a list of ASDMs
  385. getCalibrators -- Returns a list of calibrator names or source IDs from a measurement set.
  386. getChanFreqFromCaltable -- Returns the frequency of the specified channel in the specified spw of a caltable
  387. getChannelAveragedScienceSpws -- Returns a list of channel averaged spws corresponding to the science spws
  388. getChannelAveragedSpw -- Finds the channel-averaged spw corresponding to a specified full resolution spw
  389. getChannelsWithBlankCleanMask -- Finds the list of cube channels with a mask and the list without a mask
  390. getChanWidths -- Return the channel widths of a specified ms and spw
  391. getChanwidthASDM -- Returns the physical channel width in Hz for an spw in an ASDM
  392. getChanWidthFromCaltable -- gets the width of a channel from one or all spws in a caltable
  393. getCOFA -- returns the center of the array for the specified ms, in XYZ and in longitude/latitude
  394. getCOFAForASDM -- returns the center of the array for the specified ASDM, in XYZ and in longitude/latitude
  395. getCOFAForObservatory -- returns the center of the array for the specified observatory name, in XYZ and in longitude/latitude
  396. getConfig -- Reads the configName value from the ASDM_EXECBLOCK table of an ms
  397. getConfigFromASDM -- Reads the configName value from the ExecBlock.xml file of an ASDM
  398. getCorrectedData -- Reads uvdist and corrected amplitudes
  399. getCorrelatorName -- reads the correlator name from the CorrelatorMode.xml file of an ASDM
  400. getCorrelatorNameFromMS -- reads the correlator name for the ASDM_CORRELATORMODE table, if it was imported
  401. getCurrentDate -- gets the current date in local time in the format 'YYYY/MM/DD'
  402. getCurrentMJDSec -- gets the current MJD in seconds
  403. getCurrentUnixTime -- gets current unix time from the system clock
  404. getDataColumnName -- gets the name of the data column of a measurement set
  405. getDiameterForObservatory -- convert an observatory name to an antenna diameter
  406. getDistanceFromMedianPadLOCFromASDM -- gets the distance of each antenna from the median of all the pad locations in an ASDM
  407. getElevationStatsForIntentFromASDM -- gets the min/median/max elevation observed for a specified intent in an ASDM
  408. getEphemeris -- reads the ephemeris from the ASDM_EPHEMERIS table of a measurement set
  409. getEphemerisFields -- gets a list of ephemeris field names in a measurement set
  410. getEphemerisFieldsFromASDM -- gets a dictionary of ephemeris fields and their initial direction from an ASDM
  411. getEquinoxForField -- Gets the reference frame name for specified field in an ms (i.e. 'J2000' or 'ICRS')
  412. getExtremeBaselinePerAntenna -- computes min, mean, median, or max baseline length per antenna on an ASDM
  413. getExtremeSpws -- returns the spw ID for the spw containing the minimum and maximum frequency for the specified intent
  414. getFeedTableTimes -- Gets the unique values of the TIME column of the FEED table
  415. getFieldIDsForEphemerisID -- Returns a list of all field IDs that correspond to one ephemeris ID
  416. getFieldnameFromPipelineImageName -- Gets field name from an ALMA pipeline image name
  417. getFieldTime -- Gets the TIME for one cell of the FIELD table of an ms
  418. getFieldTimes -- Gets the TIME column of the FIELD table of an ms
  419. getFieldsFromASDM -- gets field IDs and names from an ASDM, as two dictionaries
  420. getFieldsFromCaltable -- gets a list of unique field IDs (of fields that have a solution) from a caltable
  421. getFitsBeam -- Extract the beam information from a FITS or CASA image.
  422. getFitsBeams -- Runs getFitsBeam for a list of images and prints a wiki table
  423. getFitsDate -- Extract the date information from a FITS or CASA image.
  424. getFlagdict -- Extract flagging dictionary using the af tool
  425. getFlagsFromCaltable -- Extract the number of flags from a caltable, or a dictionary of them
  426. amc.getFlagStatistics -- Uses the af tool to compute percentage of flagged data
  427. getFluxesFromAquaReport -- Used by plotGfluxscale to read derived and catalog flux from pipeline-generated aquareport.xml
  428. getFreqType -- Returns string TOPO or LSRK, etc. for a CASA image
  429. getFrequenciesFromASDM -- Get a list of the frequencies of each spw in the ASDM (extraneous WVR spws are skipped)
  430. getfwhm -- Directly estimate the actual FWHM of the CASA image provided, with no assumption about shape (Brian Mason)
  431. getfwhm2 -- An alternative to getfwhm which solves for radially-averaged zero crossing of (data-halfmax)
  432. getgain -- extract gain curve coefficients for a specified VLA antenna and band and make a plot vs. elevation
  433. getImfitEstimatesFixedString -- Reads the fixed parameter from each line of an imfit estimates file
  434. getIntegrationTime -- use the ms and msmd tools to get the integration time in a measurement set
  435. getIntegrationTimeFromASDM -- reads the Main.xml file to find the longest integration time
  436. getIntensityForPixel -- Gets the intensity at a single pixel of a CASA image.
  437. getIntentsForFieldID -- gets all the intents for which a field was observed
  438. getIntentsFromASDM -- Makes a dictionary with field name as key and intents as the value.
  439. getIterFromPipelineImageName -- Gets the iter value (0,1,2) from an ALMA pipeline image name
  440. getLineFromFile -- Returns the contents of the specified line number from the specified text file
  441. getListOfFilesFromFile -- Reads a list of ASDM or measurement set names from a text file and returns a list of names
  442. getLO1 -- Returns the LO1 frequency in Hz for first science spw of a measurement set
  443. getLOs -- returns a list of four lists containing the LO information from the ASDM_RECEIVER table of a measurement set
  444. getLOsFromASDM -- Returns a dictionary of the LO values for every spw in the specified ASDM
  445. getLoadTemperatures -- Reads the load temperatures from the ASDM_CALDEVICE table (if present).
  446. getLongestProjectedBaselineInMainTable -- Reads the UVW column from main table and computes largest value of specified coordinate combination
  447. getMajorIntentsForFieldID -- gets all the major intents for which a field was observed
  448. getMaxBaselineInUnitsOfL80 -- Returns dictionary of max baseline in units of L80 for specified measurement set(s)
  449. getMaxBaselineInUnitsOfL80FromASDM -- Returns dictionary of max baseline in units of L80 for specified ASDM
  450. getMeanFreqFromASDM -- gets the number and mean frequency of the spws for each sideband
  451. getMeanFreqOfSpwlist -- gets the mean of the mean frequency of a list of spws
  452. getMeanFreqOfSpwSelection -- gets the mean frequency of an arbitrary spw/channel selection string
  453. getMeanPosition -- computes the mean RA and mean Dec of a list of positions
  454. getMeanPositionFromOTPointings -- gets the mean RA and Dec direction of a list of pointings output by the Cycle 4 OT
  455. getMeanScienceFreqOfSidebands -- computes the bandwidth-weighted mean of the spws in each sideband
  456. getMeanWeights -- gets the mean of the WEIGHT column from a measurement set
  457. getMeanWeightsPerAntenna -- gets the mean of the WEIGHT column from a measurement set on a per-antenna basis
  458. getMeasFreqRef -- reads the MEAS_FREQ_REF column of a SPECTRAL_WINDOW table of an ms, which encodes whether the frequency frame is TOPO or LSRK, etc.
  459. getMeasurementSetFromCaltable -- get the name of the measurement set associated with a caltable
  460. getMedianBaselinePerAntenna -- computes median baseline length per antenna on an ASDM
  461. getMedianPadLOCFromASDM -- gets the median location (in ENU coordinates) of all the pads in an ASDM
  462. getMedianPWV -- computes median and standard deviation of PWV for the specified ms (or the CalWVR.xml file in the pwd)
  463. getMedianTsys -- gets the median Tsys from one or more datasets
  464. getMedianTsysForChannel -- Computes the median over all antennas of a single Tsys channel in one spw in one ASDM
  465. getMedianTsysPerSpw -- Computes the median Tsys value per spw in a measurement set
  466. getMedianWeatherFromAIV -- Computes the median weather from weather.aiv.alma.cl for a specific time range
  467. getMedianWeatherFromAIVForASDM -- Computes the median/Mad of weather values from weather.aiv.alma.cl per scan of an ASDM
  468. getMedianWeatherFromTMCDB -- Computes the median weather from the TMCDB for a specific time range or ASDM
  469. getMemorySize -- gets the total memory of the current machine
  470. getMJD -- computes the current MJD
  471. getMJDSec -- computes the current MJD in units of seconds
  472. getMJDSecFromCaltable -- computes the mean MJD in units of seconds of the solutions in a caltable
  473. getMostRecentMove -- searches the antennaMoves.txt file for the most recent move for a specified antenna
  474. getNChanFromCaltable -- gets the number of channels from one or all spws in a caltable
  475. getNominalObservatoryPressure -- computes the nominal barometric pressure for the tabulated height of a specified observatory
  476. getNonScienceTimeRanges -- Gets a list of time ranges of the scans NOT of a specified field or intent
  477. getNumChanFromASDM -- gets the number of channels for each spw
  478. getObservationDateRangeFromASDM -- gets the start and stop date and time of an ASDM
  479. getObservationEndDateFromASDM -- Reads the stop time of the observation from an ASDM and report it in date + UT time and MJD seconds
  480. getObservationIDs -- gets a list of the unique observation IDs from a measurement set
  481. getObservationLength -- gets length of measurement set observations in minutes
  482. getObservationLengthFromASDM -- gets length of ASDM observation in minutes
  483. getObservationMJDSecRange -- gets beginning and end time of an ms in MJD seconds
  484. getObservationMJDSecRangeFromASDM -- gets beginning and end time of an ASDM in MJD seconds
  485. getObservationStart -- Read the start time of the observation from an ms and report it in MJD seconds.
  486. getObservationStartDate -- Read the start time of the observation from an ms and report it in date and UT time.
  487. getObservationStartDates -- Read the start time of the observation from a list of measurement sets and report a list of dates and UT times.
  488. getObservationStartDateFromASDM -- Read the start time of the observation from an ASDM and report it in date + UT time and MJD seconds.
  489. getObservationStartDateFromASDMs -- Runs getObservationStartDateFromASDM on a list of ASDMs and writes a text file
  490. getObservationStartDay -- Read the start time of the observation from an ms and report only the UT date (YYYY-MM-DD).
  491. getObservationStop -- Read the stop time of the observation from an ms and report it in MJD seconds
  492. getObservationStopDate -- Read the stop time of the observation from an ms and report it in date and UT time
  493. getObservationSummaryFromASDM -- gets the start and stop date and time, and a list of antennas from an ASDM (or a list of them)
  494. getObservatoryFromConfig -- reads the telescope name from an antenna configuration file
  495. getObservatoryLatLong -- reads the latitude and longitude of an observatory from the CASA repository
  496. getObservatoryName -- reads the observatory name from the OBSERVATION table of an ms
  497. getObservatoryNameFromASDM -- reads the observatory name from the ExecBlock.xml file of an ASDM
  498. getOUS -- read the OUS for an ASDM from the ExecBlock.xml file (note: it is not possible to get the project code from an ASDM)
  499. getOUSForUID -- retrieves the OUS name for an ASDM or measurement set without requiring that file
  500. getPadHeight -- gets the geocentric distance for one or all pads in a measurement set
  501. getPadHeightFromASDM -- gets the geocentric distance for one or all pads in an ASDM
  502. getPadLOC -- reads the local tangent plane coordinates for the specified pad name from the file AOS_Pads_XYZ_ENU.txt
  503. getPadLOCsFromASDM -- reads the pad position in ENU coordinates from an ASDM
  504. getPadPosition -- Gets a measures.position instance for the specified ALMA pad name
  505. getPadPositions -- reads the pad positions in geocentric XYZ coordinates from an ms
  506. getPadPositionsFromASDM -- Reads the pad positions in geocentric XYZ coordinates from an ASDM
  507. getPadsForConfig -- gets a list of pad names for the specified antenna configuration file
  508. getPadXYZ -- computes the XYZ geocentric coordinates any specified ALMA pad name in the file AOS_Pads_XYZ_ENU.txt
  509. getPadXYZFromASDM -- reads the XYZ geocentric coordinates for the specified ALMA pad name from the ASDM
  510. getPhaseCalibrators -- gets the field IDs of the phase calibrators in a measurement set
  511. getPhaseCenterForField -- calls getRADecForField and returns result in form amenable to tclean phasecenter parameter
  512. ami.getPipelinePBAndMask -- given the name of a pipeline image, determines the expected name for the corresponding pb and mask, returns them, and prints a warning if either one does not exist
  513. getPointingScans -- Gets a list of scans with pointing intent
  514. getPolarizationsFromASDM -- Reads the Polarization.xml file and reports the polarization products in each ID
  515. getPrimaryIntent -- Given a list of intents, return the fundamental intent
  516. getProjectedBaselines -- Uses ms tool to build a dictionary of mean projected baseline length, keyed by baseline name
  517. getProjectedBaselineStats -- Uses visstat to compute statistics of the projected baselines
  518. getProjectMOUSFromDir -- Gets the project name and MOUS from a pipeline execution directory path
  519. getRADecForField -- Returns the RA,Dec in radians for the specified field in the measurement set
  520. getRADecForFieldFromASDM -- Returns the RA,Dec in radians for the specified field ID in an ASDM
  521. getRADecForSource -- Returns the RA,Dec in sexagesimal for the specified source in the measurement set
  522. getRadialVelocityAtStart -- Reads RadVel from ephemeris attached to measurement set and returns entry nearest to start of measurement set
  523. getReceiverId -- Reads the ASDM_RECEIVER table of a measurement set and returns a single integer ID or list of IDs present
  524. getResampledWeatherFromDatabase -- Gathers and resamples weather values onto a common time series
  525. getSB -- Gets the UID of the schedule block for a measurement set
  526. getSBGain -- read the sideband ratio gains from the SYSCAL table of a measurement set
  527. getScanNumbersFromASDM -- Returns a list of scan numbers in an ASDM that have the specified intent
  528. getScansFromCaltable -- Gets the list of unique scan numbers from a caltable
  529. getScienceBasebandFrequencies -- Gets the center frequencies of the science basebands of an ALMA dataset (via the SQLD spws)
  530. getScienceBasebandIFRanges -- Gets the IF range of the science basebands of an ALMA dataset (via the SQLD spws)
  531. getScienceBasebandRFRanges -- Gets the RF range of the science basebands of an ALMA dataset (via the SQLD spws)
  532. getScienceBasebandSamplerRanges -- Gets the location of the science basebands in the sampler range (should always return 2-4 GHz if metadata are correct)
  533. getScienceChannelsInSameBaseband -- Returns the total number of channels in science spws in the same baseband as the specified spw
  534. getScienceFrequencies -- Gets a list of the central frequencies of science spws in a measurement set
  535. getScienceScans -- Gets a list of scans with specified intent
  536. getScienceSpwBandwidths -- Gets a list or dictionary of the bandwidths of the science spws
  537. getScienceSpwBasebands -- Gets a dictionary keyed by spw with values equal to their respective basebands numbers (1..4)
  538. getScienceSpwChanwidths -- Gets a list or dictionary of the channel widths of the science spws
  539. getScienceSpwIFRanges -- Gets the IF ranges of the science spws in an ALMA measurement set
  540. getScienceSpwNChannels -- Gets a list or dictionary of number of channels in the science spws
  541. getScienceSpws -- Uses msmd to get a list of (full-resolution) science spws in a measurement set
  542. getScienceSpwSamplerRanges -- gets the location in the sampler range of 2-4 GHz of all science spws
  543. getScienceSpwTypes -- returns dictionary with number of 'FDM' and 'TDM' science spws
  544. getScienceSpwsForFrequency -- Gets a list of spws whose channels contain a specified frequency
  545. getScienceSpwsForScan -- gets a list of science spws recorded in a specific scan
  546. getScienceSpwsFromASDM -- Gets a list of spws that observed the science target (i.e. those with a velocity reference code)
  547. getScienceSpwSidebands -- Gets a dictionary keyed by science spws with values of 'LSB' or 'USB'
  548. getScienceSpwsInSameBaseband -- Gets a list of science spws that occupy the same baseband as the specified spw
  549. getScienceSpwsInSameBasebandFromASDM -- Gets a list of science spws that occupy the same baseband as the specified spw
  550. getScienceSpwTransitionsFromASDM -- Gets a dictionary of spectral line transition names for the science spws of an ASDM
  551. getScienceTargetFieldIDsFromASDM -- Returns a list of science field IDs for the nth science source of an ASDM
  552. getScienceTargetRADecsFromASDM -- Returns a list or dictionary of RA, Decs for the science fields of an ASDM
  553. getScienceTargetsFromASDM -- Gets an array of science targets from an ASDM
  554. getScienceTimeRanges -- Gets a list of time ranges of the scans of a specified field or intent
  555. getShadowedBaselines -- Gets list of projected baselines that are smaller than the antenna diameter during a scan
  556. ami.getSourceNameFromPipelineImageName -- Parses the source name from an ALMA pipeline image name
  557. getSourceTypeFromPipelineImageName -- Gets source type (bp,ph,flux,sci,chk) from ALMA pipeline image name
  558. getStyleFromPipelineImageName -- Gets style (mfs,cont,cube) from ALMA pipeline image name
  559. getSpwFromPipelineImageName -- Gets single spw ID from a single-spw ALMA pipeline image name
  560. getSpwImageSidebandFrequencyRange -- Computes the image sideband frequency range of a specified spw
  561. getSpwMeanFreqFromCaltable -- Gets the mean frequency for an spw from a caltable using its SPECTRAL_WINDOW subtable
  562. getSpwsForBaseband -- gets the spws associated with a specific baseband number
  563. getSpwsForBasebandFromASDM -- gets the spws associated with a specific baseband number
  564. getSpwsFromCaltable -- gets a list of the unique spws from a caltable
  565. getSpwsFromASDM -- Returns a dictionary of the spw information for an ASDM
  566. getSpwsFromSysCal -- gets a list of the unique spws in a SYSCAL table of a measurement set
  567. getStandardTemperature -- computes the 1976 U.S. Standard atmosphere barometric pressure for a specified height
  568. getStandardTemperature -- computes the 1976 U.S. Standard atmosphere temperature for a specified height
  569. getStartTimeForFieldFromASDM -- gets a list of start times (in MJD) for a specified field name in an ASDM
  570. getStyleFromPipelineImageName -- Given a pipeline image name, returns 'mfs', 'cont', or 'cube'
  571. getSubscanTimesFromASDM - reads the subscan information from the ASDM and returns a dictionary including integration time, and computes latency
  572. getTargetsForIntent -- gets the target names observed for a specified intent in a measurement set (using msmd)
  573. getTargetsForIntentFromASDM -- gets the target names observed for a specified intent in an ASDM
  574. getTelescopeNameFromCaltable -- reads the observatory name from the caltable's OBSERVATORY subtable
  575. getTimesFromCaltable -- gets a list of the unique timestamps from a caltable
  576. getTPSampling - computes the spatial sampling of a single dish measurement set containing a total power raster map
  577. getTsysBands -- gets the band numbers that have Tsys scans
  578. getTsysFromCaltable -- returns an array of Tsys spectra
  579. getTsysFromSysCal -- reads the Tsys values from a SysCal.xml table into a dictionary
  580. getTsysScans -- gets the list of unique scans contained in a caltable
  581. getTsysSpws -- gets a list of spws that measured Tsys
  582. getTsysSpwsForBand -- gets a list of spws of a specific band that have measured Tsys
  583. getTsysSpwsForScan -- gets a list of Tsys spws recorded in a specific scan
  584. getUnflaggedAntennas -- Uses the af tool to determine the list of unflagged antennas in a measurement set
  585. getUnflaggedScans -- Uses the af tool to determine list of unflagged scans for a specific spw and field
  586. getUT -- gets the current Universal Time in hours
  587. getvisdensity -- returns the average density of visibility points for the specified ms
  588. getxyFromFile -- Gets two columns of data from an ASCII file, as numpy arrays
  589. getWeather -- Gets weather information from a measurement set
  590. getWeatherFromAIV -- Retrieves weather values from weather.aiv.alma.cl
  591. getWeatherFromASDM -- Extracts weather values from an ASDM
  592. getWeatherFromTMCDB -- Extracts weather values from the TMCDB
  593. getWeatherStationNames -- Gets the weather station names from a measurement set
  594. getWeatherStationNamesFromASDM -- Gets the ALMA weather station names from an ASDM
  595. getWeatherStationPositions -- Gets the weather station positions from a measurement set
  596. getWeatherStationPositionsFromASDM -- Gets the weather station positions from an ASDM
  597. getWeightedMeanScienceFrequency -- Computes the weighted mean science spw frequency for a list of measurement sets, weighted by data weights on a per-spw, per-vis basis
  598. gfluxscaleMockup -- Generates plots of gfluxscale results and image peak and rms for each non-flux calibrator in each ms of a pipeline run
  599. gjincBeam -- compute the effective restoring beam obtained from the casa command sd_imaging using the GJinc gridding function
  600. goldsmithTaperFactor -- Converts a taper in dB to the constant X in the formula FWHM=X*lambda/D for a Gaussian illumination pattern
  601. grep -- Runs grep on a file in a subprocess 1 getExtremeBaselinePerAntenna -- computes min, mean, median, or max baseline length per antenna on an ASDM
  602. grepAntennaMoves -- Runs grep for a specific antenna on the antennaMoves.txt file distributed with analysisUtils
  603. gridSourceReport -- Builds a report of the age of the most recent measurement of the grid sources in each band
    H
  604. headerToArcsec -- Convert any CASA angle quantity to arc seconds
  605. headerToDegree -- Convert any CASA angle quantity to degrees
  606. headerToRadian -- Convert any CASA angle quantity to radians
  607. help -- prints a list of all the functions defined at the top level of analysisUtils.py
  608. hmsToDegrees -- Converts string of "HH", "HH:MM" or "HH:MM:SS" into floating point degrees
  609. hmsToHours -- Converts string of "HH", "HH:MM" or "HH:MM:SS" into floating point hours
  610. hmsToInterval -- Converts string of "00d01h02m03s" to integer (or floating point) number of seconds
  611. hourAngleForField -- Computes the range and mean hour angle for a field in a measurement set
  612. hourAngleRangeFromWeblog -- Computes range of hour angle for a science target in a weblog
  613. hoursToHMS -- converts decimal hours to HH:MM:SS string
  614. hours2radec -- converts decimal RA hours and decimal Declination degrees to a sexagesimal string
    I
  615. ICRSToJ2000 -- Converts an ICRS direction to J2000
  616. imageAntennaDiameter -- Attempt to infer antenna diameter for an image from its header
  617. imageAreaAbovePB -- Computes area of pixels above a specified level of an image
  618. imageBandwidth -- Reports total bandwidth in GHz for an image cube
  619. imageCenter -- returns the RA/Dec center of an image
  620. imageCenterVsFieldCenter -- Computes angular separation of phase center pixel from field direction in measurement set
  621. imageCentroid -- Computes statistics and centroid of a CASA image
  622. imageCentroids -- Runs imageCentroid for a list of images
  623. imageChannel -- Finds the channel in a cube that corresponds to a specified velocity
  624. imageChannelVelocity -- Finds the velocity of a specified channel in a cube
  625. imageChannelVelocityWidth -- Finds the velocity width of the first channel in a cube
  626. imageChannelFrequency -- Uses the ia tool to get the frequency of a specified channel of a cube
  627. imagesChannelFrequency -- Uses the ia tool to get the frequency of a specified channel of a list of cubes
  628. imageChannelFrequencyWidth -- Finds the frequency width of the first channel in a cube
  629. imageClip -- Clip an image at a specified intensity level
  630. imageClipAndRemove -- Clip and image at a specified intensity level and remove the result from the image
  631. imageCRValues -- Gets the axis reference values from a CASA image
  632. imageDate -- Reads the observation date of an image from its header
  633. imageEquniox -- Reads the equinox (ICRS/ J2000) from a CASA image
  634. imageFitFluxAtPhaseCenter -- fits a Gaussian to the central 30 pixels of an image and reports flux density and uncertainty
  635. imageFluxSNR -- Uses imstat to compute the ratio of flux / scaledMAD
  636. imageFrequencyChannel -- determines the nearest channel to the specified frequency for a cube, with findcont ceil/floor option
  637. imageGaussianFilter -- Smooth an image by a circular Gaussian kernel
  638. imageHeaderToICRS -- Uses CASA imhead to set the equinox in a CASA image to ICRS
  639. imageHeaderToJ2000 -- Uses CASA imhead to set the equinox in a CASA image to J2000
  640. imageHistogram -- Plots a histogram of a CASA image
  641. imageHistory -- Prints the history records of a CASA or FITS image
  642. imageImstat -- Runs the CASA imstat command on an image/region and returns the specified keyword from the dictionary
  643. imageImstats - Runs imageImstat on a list of images and returns a list of values
  644. imageMaxBaseline -- Infers the maximum baseline based on the resolution and frequency of an image
  645. imageMedian -- Uses imstat to compute median of an image
  646. imageMin -- Returns the minimum pixel value of a CASA image
  647. imageModelResidual -- Given an image and a model image, compute the residual and plot all three side-by-side
  648. imageObservatory -- Attempt to read the observatory name from the header of an image
  649. imagePeak -- Returns the peak pixel value of a CASA image
  650. imagePeakPerChannel -- Returns an array of the peak pixel in each channel of a CASA cube
  651. imagePeaks -- Runs imagePeak on a list of images
  652. imagePercentile -- Computes pixel value corresponding to a specified pixel value
  653. ami.imagePixelsInMask -- counts number of pixels that are masked in an image
  654. imagePrimaryBeam -- Attemp to infer the primary beam size for an image from the telescope name in its header
  655. imageRegister -- Runs imfit on a list of position in two images of the same field and finds the median pixel shift to bring them into alignment
  656. imageRegisterImfitDictionaries -- same as imageRegister but accepts a user-supplied pair of imfit dictionaries
  657. imageRestFrequency -- Reads the rest frequency stored in a CASA or FITS image header
  658. imageRotate -- Runs ia.rotate on a CASA image
  659. imageShape -- Returns an array of the shape of a CASA image
  660. imageSmooth -- Runs imsmooth on a list of images
  661. imageSNR -- Uses imstat to measure (peak-median)/scaledMAD in a CASA image, optionally on a channel-by-channel basis
  662. imageSnr -- Uses python to measure the peak/std in a CASA image
  663. imageSnrs -- Measures the peak signal to noise ratio in each image in a list of CASA images
  664. imageSource -- Gets the name of the source from a CASA image
  665. imageStd -- Measures the standard deviation (or MAD) in a CASA image
  666. imageStdPerChannel -- Measures and plots the standard deviation, rms, MAD, min and max in a list of channels in a CASA image
  667. imageStds -- Measures the standard deviation in each image in a list of CASA images
  668. imageStdsPerChannel -- Measures and plots the standard deviation, rms, MAD, min and max in a list of channels for each image in a list of CASA images
  669. imageStdVariation -- Measures how the image standard deviation varies across the image
  670. imageStokes -- Reads which Stokes parameters are contained in a CASA image
  671. imageSum -- Sums a list of CASA images into a new image using immath
  672. imfitparseDict -- Simplifies an imfit dictionary for a specified component to have just 6 keys
  673. imfitparse -- converts a dictionary returned by imfit into a formatted string (for a single component)
  674. imfitparseCLB -- alternative version of imfitparse
  675. imfitparseCLBs -- Runs imfitparseCLB on all the components that were fit
  676. imfitplot -- Calls the casa task imfit, then plots the model and residual images side-by-side on the same intensity scale.
  677. imheadlist -- Emulates imhead(mode='list') but is faster because it avoids looking through binary data for the min/max/minpos/maxpos values
  678. importandlist -- Calls the casa task importasdm followed by listobs on one ASDM, or a list of ASDMs.
  679. importasdm2 -- Runs importasdm but only for scans that match a specified intent
  680. insertBracketsIntoFlaglist -- Inserts square brackets around all the timerange entries in a file containing flag statements
  681. imshift -- Shifts a CASA image header in RA/Dec
  682. imstatCompare -- Runs imstat on 2 images and compares all the result for equality
  683. imstat_cas6745 -- Runs imstat using a work-around for CAS-6745
  684. imsubimageOnePlane -- Takes one plane from a 3-axis image, even if the type of the 3rd axis is undefined, as in SOFIA FORCAST images
  685. imviewField -- Plots a square portion of a CASA image specified in arcseconds using imview
  686. imviewFieldCubeEdges -- builds a multi-panel png of the edge channels of a cube
  687. imviewFields -- Calls imviewField for a list of images and builds a multi-page PDF
  688. imviewGaussianModels -- Overlay the 50% contour of one or more Gaussian models overtop an image
  689. intentsforfield -- Workaround for the bug in msmd.intentsforfield (CAS-12164)
  690. interpolateSpectrum -- Interpolates a spectrum onto a finer grid of frequencies.
  691. interpolateTable -- Performs a spline interpolation of any two columns in an ASCII data table
  692. interpretLOs -- returns the LO1 (and optionally LO2) information for each spw (assuming the ASDM_RECEIVER table is present)
  693. intervalToHMS -- converts a number of seconds into a string interval of format 00h00m00s
  694. inverseTsysspwmapWithNoTable -- Determines a list of science spws that use a specified Tsys spw
  695. invertChannelRanges -- Inverts a CASA channel selection string (i.e. from line-free to line-full)
  696. isMosaic -- Determines if any science target was observed with multiple fields with science intent
  697. isSingleContinuum -- Checks if an spw in an ALMA measurement set was defined as Single Continuum in the OT by looking at the transition name for the first science spw
  698. isSingleContinuumASDM -- Checks if an ASDM contains a tuning that was defined as Single Continuum in the OT (by looking at Source.xml file)
  699. isSingleDish -- Checks if an ALMA measurement set is a single dish dataset
  700. isSingleDishASDM -- Checks if an ALMA ASDM is a single dish dataset
  701. isSpectralScan -- Checks if a measurement set was defined as spectral scan in the OT, by looking at the transition name for the first science spw
  702. isSpectralScanASDM -- Checks if an ASDM contains a tuning that was defined as spectral scan in the OT (by looking at the Source.xml file)
    J
  703. J2000ToICRS -- Convert a J2000 direction to ICRS
  704. J2000ToICRSgrid -- Runs J2000ToICRS for a grid of positions on the celestial sphere and computes statistics
  705. janskyPerKelvin -- Computes the theoretical Jy/K for an ALMA single dish image based on its measured beamsize
  706. jdToMJD -- converts JD to MJD
    K
  707. kelvinToCelsius -- Adds 273.15 to the value
    L
  708. lightcurve -- Produce a light curve of an ALMA calibrator from the calibrator database extrapolated to a specified frequency
  709. lineSeparation -- computes IF location for simultaneous observations of a line in LSB and another line in USB
  710. linfit -- Uses scipy.optimize.leastsq to perform a linear fit to data accounting for measurement uncertainties in the dependent variable
  711. linfitFromFile -- A wrapper for linfit which will read column data from a text file and then fit it
  712. listazel -- Extracts the mean azimuth and elevation for the specified scan of an ms
  713. listBlankChannelsInImage -- Returns an array of channels of a cube whose min==max
  714. listconditions -- lists average weather, PWV and opacity (tau) during your ms
  715. listConditionsFromASDM -- lists average weather during your asdm
  716. listflagsSlow -- list all row numbers in an ms that have flagged data, and report statistics (slow!!)
  717. es.listobs2 -- ALMA qa2 function that produces a more readable listobs and antenna configuration plot
  718. listobsasdm -- Performs casa-like listobs on an ASDM
  719. listobslist -- Runs listobs on a list of measurement sets, which can be alternately be specified by a string containing wildcard characters
  720. listPhaseSolutions -- list phase solutions by antenna, sorted by absolute value (useful for examining selfcal solutions)
  721. listscans -- lists the summary (time and intents) of each scan in an ASDM and the total time on each source
  722. long2xyz -- Wrapper for simutil.long2xyz to convert a longitude,latitude,elevation to an ITRF position
  723. longs2xyz -- Converts a list of longitude,latitude,elevation to a list of ITRF positions
  724. ami.lookForFile -- Accepts a file path with wildcards and returns the newest file
  725. ami.lookForNewestFileContainingStrings -- Accepts a file path with wildcards and a list of strings and finds the newest matching file
  726. lowCaiSelection -- Finds baseline names that reside below the CAI=32 boundary for a specified measurement set (see also crossCaiSelection)
  727. lowTransmissionChannels -- Finds ranges of channels that are below a specified atmospheric transmission level in a specified spw (see CASR-520)
  728. lstrange -- lists the range of LST, UT, MJD for the whole ms, and for scans with ON_SOURCE intent (including the elevation range)
  729. lstToUT -- converts LST and date to UT
    M
  730. MAD -- compute the median absolute deviation of a list
  731. MADoutliers -- finds outlier values and their locations in a list or array
  732. makeDirtyCube -- picks an appropriate cell and image size and makes a dirty cube
  733. makeFixEphem -- makes a fixEphem.py script for a multi-execution ephemeris observation
  734. visbilityOutliers.makeFlagTemplates -- The development version of hifa_bandpassflag and hifa_gfluxscaleflag
  735. makeGaussianForImage -- Take a CASA image as a template, and build an image with a single 2D Gaussian component at the specified location
  736. makeGaussiansForImage -- Take a CASA image as a template and a dictionary from imfit, and build images of each of the 2D Gaussian components and their sum
  737. makeNoiseCube -- fills a cube's pixels with Gaussian noise
  738. makePSF -- uses imagehelper toolkit to determine PSF for 1 or a group of measurement sets (to emulate hifa_imageprecheck)
  739. makePtgfile -- Builds a pointing file from a measurement set suitable for use in simobserve
  740. makeSimulatedImage -- use simobserve/simanalyze to generate a simulated image of a point source or uniform disk in a specified direction and with a specified flux density
  741. makeTimeStamp -- builds a current timestamp string like '2017-05-06T17:15:37'
  742. mapSpwChannelToTsysChannel -- Finds Tsys channel that corresponds to a specified spw and channel
  743. maskBlankChannelsInImage -- Sets the mask for all channels of a cube whose min==max
  744. maskChannel -- Masks the specified channel(s) in a cube
  745. maxBandwidthWithoutSmearing -- Computes widest bandwidth for averaging that will not cause smearing
  746. maxBaselineForRequestedResolutionFromASDM -- computes the maximum baseline required to achieve the requested resolution of the science targets in an ASDM, accounting for elevation projection
  747. maxTimeWithoutSmearing -- Computes longest time averaging that will not cause smearing
  748. meanAirmassForScan -- Computes mean airmass for (the first field in) one scan in a measurement set
  749. meanAirmassForSource -- Computes mean airmass that a source was observed at in a measurement set
  750. meandate -- Computes mean day of a list of YYYYMMDD's
  751. meanepoch -- Computes mean epoch floating point value of a list of YYYYMMDD's
  752. meanObliquity -- compute the mean obliquity for the specified date
  753. meanVisibility -- Computes vector average visibility for a field/intent/spw combination in one EB
  754. medianFrequencyOfIntent -- Returns the median of the mean frequencies (in Hz) of the spws observed with the specified intent (default = OBSERVE_TARGET#ON_SOURCE)
  755. medianTsysForFieldFromTsysCaltable -- computes median Tsys spectrum a Tsys caltable
  756. medianTsysForFieldFromSyscalTable -- computes median Tsys spectrum from measurement set
  757. medianTsysForRestFrequency -- Returns the median Tsys for the spw that contains the label for the specified rest frequency
  758. mergeConfigs -- Merge two or more antenna configuration files, registering them using pads in common
  759. mjdListToDateTime -- Takes a list of MJD values and converts it to a list of python datetime structures.
  760. mjdNanosecondsToMJDandUT -- convert MJD in nanoseconds to MJD in days and the UT date and time string
  761. mjdSecondsToMJDUT -- converts MJD in seconds to MJD in days and a UT date/time string
  762. mjdSecondsListToDateTime -- Takes a list of MJD seconds and converts it to a list of python datetime structures.
  763. mjdsecToDate -- Converts MJD seconds to the date string that contains it (YYYY-MM-DD)
  764. mjdsecToDateString -- Converts MJD seconds to the equivalent date/time string that appears in a CASA log
  765. mjdsecToDDMonthYYYY -- Converts MJD seconds to DD-MonthName-YYYY
  766. mjdsecToTimerange -- Converts two value of MJD seconds into a UT date/time string suitable for the plotms timerange argument
  767. mjdsecToTimerangeComponent -- Converts a value of MJD seconds into a UT date/time string suitable for one component of the plotms timerange argument
  768. mjdsecToUT -- converts MJD in seconds to a string of format "YYYY-MM-DD HH:MM:SS UT"
  769. mjdsecToUTHM -- converts MJD in seconds to a string of format "HH:MM"
  770. mjdsecToUTHMS -- converts MJD in seconds to a string of format "HH:MM:SS"
  771. mjdToChileTime -- converts MJD to a datetime structure in Chile/Continental timezone (ALMA)
  772. mjdToDate -- Converts MJD to the date string that contains it (YYYY-MM-DD)
  773. mjdToDatestring -- Converts MJD to a date and time string
  774. mjdToEasternTime -- converts MJD to a datetime structure in Eastern time
  775. mjdToJD -- converts MJD in day to JD in days
  776. mjdToLocalTime -- converts MJD to a datetime structure in any specified timezone
  777. mjdToMountainTime -- converts MJD to a datetime structure in US/Mountain timezone (VLA)
  778. mjdToPredictcomp -- Converts an MJD into a string suitable for the epoch parameter of predictcomp
  779. mjdToUnixtime -- Converts an MJD into unix time in seconds
  780. mjdToUT -- converts MJD to date and UT
  781. mjdToYear -- converts MJD to floating point year
  782. modifyAntennaDiameter -- Change the dish diameter column in the ANTENNA table of a measurement set
  783. modifyImfitEstimates -- Modifies a line in an existing imfit estimates text file
  784. modifyIntents -- replace all appearances of one intent in the STATE table of an ms with another
  785. modifyPPR -- modifies a pipeline processing request xml file (PPR) in a variety of ways
  786. modifyReferenceFrequency -- Modifies the REF_FREQUENCY column of the SPECTRAL_WINDOW table of a caltable
  787. montage -- runs the ImageMagick command montage on a list of images
  788. montagePngs -- takes 2, 3 or 4 pngs (or other single-page image types) and puts them onto one page as a new png
  789. montageTwoPdfs -- takes two multi-page PDFs and places their corresponding page numbers onto the same page
  790. montageTwoPngLists -- take two lists of png files (or other single-page image types) and pair them side-by-side, on successive pages
  791. mosaicFieldOrder -- Returns the mosaic target field IDs in time order of first OBSERVE_TARGET observation
  792. mosaicSensitivity -- computes the sensitivity at the center of a hexagonal mosaic relative to a single pointing
  793. mosaicOverlapFactor -- computes the peak sensitivity of a arbitrary pattern mosaic relative to a single pointing
  794. mostRecentMoves -- checks the antennaMoves.txt file for the most recent move of each antenna in an ms
  795. mostRecentPipelineParentDirectory -- finds the parent directory of the most recent pipeline run of a NA user
  796. mostRecentPipelineWorkingDirectory -- finds the working directory of the most recent pipeline run of a NA user
  797. mousExport -- Exports first or all EBs from the archive for a science MOUS
  798. multiTaskExecutionTimes -- calls taskExecutionTimes for a list of tasks and returns a dictionary
  799. multiTaskExecutionTimesGlob -- calls multTaskExecutionTimes for all the directories in a pipeline execution area
    N
  800. nameforspw -- Reads the spw name from the spectral window table (obsoleted by msmd.namesforspws in casa>4.2.2)
  801. nearestCalibratorToScienceTargets -- Computes the nearest calibrator to each science target in a measurement set
  802. nearestCalScanForTime -- Determines the calibrator scan which has the nearest central time to the specified time
  803. nearestScanForTime -- Determines the scan which has the nearest start or end time to the specified time
  804. nextHighestIntegerEvenlyDivisible -- Finds a number of channels that is evenly divisible into the total number of channels in an spw
  805. nodeFromLogfile -- Reads the Lustre node name used by a pipeline run from its CASA log file
  806. nonPointingNonAtmosphereScans -- Returns list of scan numbers that do not have pointing or atmosphere intents (or other specified combinations of intents)
  807. nonzeroGainPhase -- Looks for deviations from zero phase for a specified antenna in a caltable (all spws)
  808. nonzeroPixels -- Counts the number of non-zero pixels in a CASA image
  809. normalizeImage -- normalize the intensity scale of a CASA image to a specified value
  810. numberOfChannelsInCube -- returns the number of channels in a CASA image cube
  811. numberOfPolarizationsInSyscalTable -- returns the number of polarizations in the first row of the SYSCAL table
  812. numberOfPolarizationsInSyscalXML -- returns the number of polarizations in the first antenna, spw, scan combination in the SysCal.xml file
    O
  813. observatories -- Returns a list of all observatory names in the CASA repository
  814. obslist -- prints the antenna station coordinates in local offsets from the Center of Array, and computes longest/shortest baselines
  815. onlineChannelAveraging -- infers the channel averaging factor for ALMA data from Cycle 3 and beyond
  816. orthogonalDistanceRegression -- perform linear fit accounting for uncertainties in both axes
  817. outlierChannelsInPSF -- Returns a list of channels in a cube that are outliers in beam area or axial ratio
  818. overlayCuts -- Extract a single row or column from two CASA images and overlay them.
  819. overlayHolographyCuts -- Extract a single row through the peak of a list of images and overlay them
  820. overlayTrx -- Overlay the Trx spectra from two different datasets for the same antenna/spw/pol
  821. overlayTsys -- Overlay the Tsys spectra from two different datasets for the same antenna/spw/pol
  822. o2sounder -- Loads a CSV file from the O2 sounder and generates profiles, plot or movie
    P
  823. padEllipsoidalHeightFromASDM -- Returns the height above the Earth ellipsoid model in meters of the pad in a specific ASDM
  824. padHeightRange -- finds the range of pad heights in the local tangent plane for a measurement set or configuration file
  825. padPlotLimits -- Expands the current pylab plot limits by specified fraction on each edge
  826. padSeparation -- Computes the separation of two ALMA pads, in meters
  827. padToPadPositionAngle -- Computes the azimuth in degrees from one ALMA pad to another (in the local tangent plane)
  828. padUsageHistogram -- Draws histogram of number of times an antenna has been placed on each pad
  829. parallacticAngle -- Compute the instantaneous parallactic angle for a source
  830. parallacticAngleForField -- Compute the range and mean parallactic angle for a field in a measurement set
  831. parallacticAngleForFieldAcrossMOUS -- Compute the range of parallactic angle for a field in a list of measurement sets
  832. parallacticAngleForPipelineRun -- Compute the range of parallactic angle for a pipeline run (does not separate multiple sessions)
  833. parseAntenna -- given an antenna argument and a measurement set, returns a list of selected antenna IDs
  834. parseAntennaArgument -- called by parseAntenna
  835. parseAntennaASDM -- given an antenna argument and an ASDM, returns a list of selected antenna IDs
  836. parseBasebandArgument -- takes a scalar, integer list or string list of baseband IDs and returns an integer list
  837. parseCalibratorServiceWarning -- translate warning code from calibrator web service into readable text
  838. parseFieldArgument -- Takes a field specification, converts to names, then find all field IDs associated with those names.
  839. parseFitpsf -- Parses the beamsize from the tuple returned by imager.fitpsf
  840. parseFrequencyArgument -- converts a frequency string with units into floating point value in Hz
  841. parseFrequencyArgumentToMHz -- converts a frequency string with units into floating point value in MHz
  842. parseFrequencyArgumentToGHz -- converts a frequency string with units into floating point value in GHz
  843. parseGencalAntpos -- reads a text file, locates the first gencal antpos command, and returns the values of the antenna and parameter
  844. parseImadvise -- Parses the cell size from the tuple returned by imager.advise
  845. parseImfitShape -- returns 6 values from a 'shape' dictionary returned by imfit
  846. parseSpw -- Parses the spw argument (integer or string or list) and returns an integer list of spw IDs
  847. parseTimerangeArgument -- Converts 'HH:MM HH:MM' to [MJDsec1, MJDsec2] for a measurement set
  848. parseUvrange -- converts a uvrange string (in meters or klambda) into min and max baseline length (in meters)
  849. peakJanskyPerPixel -- finds the peak intensity of an image in Jy/beam and converts to Jy/pixel (for simobserve)
  850. pickCellSize -- Computes the recommended image cell size (and total size) for a dataset's science spws
  851. pickDishDiameter -- Returns a statistical value of the dish diameter in a measurement set (min, max, median)
  852. picklePipeRun -- Save information about a pipeline run (R. Indebetouw)
  853. pickPixelSize -- Returns the best pixel size to use with the specified convsupport parameter for the SF option of sdimaging
  854. pickTicraImage -- Picks the TICRA model image to use for a specified frequency and antenna type
  855. pipelineAntpos -- Counts number of positions corrections in a pipeline run's antennapos.csv file
  856. pipelineBandpassSolint -- Finds the frequency solint used per spw per ms in a pipeline MOUS
  857. pipelineCheckCaltable -- Checks for presence of reference and target fields for fluxscale
  858. pipelineCubeRMS -- Emulates the rms calculation shown in the pipeline weblog
  859. amc.pipelineDuration -- Computes the duration based on the calibPipeIF*.log file
  860. pipelineEBs -- Returns list of EBs from a weblog main page
  861. pipelineFindIndexHtml -- Finds the index.html file in a pipeline weblog
  862. amc.pipelineHostname -- Pulls the hostname from the casa log (available in casa 5.1p1 and beyond)
  863. pipelineImageRms -- Emulates the pipeline's calculation of image (or cube) rms
  864. pipelineImageTheFluxCalibrator -- Attempts to image the flux calibrator in a pipeline working directory
  865. pipelineImview -- Generates png of CASA image in the same color palette and layout as the ALMA pipeline
  866. pipelineIsMosaicAndTimePerPointing -- parses weblog for whether an MOUS contains mosaics, computes observing time per pointing, and number of pointings
  867. pipelineMakeRequest -- Sets up the correct bash path and runs pipelineMakeRequest on an NRAO CV Lustre node
  868. pipelinePointingsFromHtml -- Returns number of science target pointings from a weblog
  869. pipelineRobust -- Pulls the robust value from the CASA log as written by hifa_imageprecheck
  870. pipelineScienceBand -- Extracts the receiver band number from a pipeline weblog
  871. pipelineSevere -- Checks a casalog for a specified string and returns matching lines
  872. pipelineSpwTypes -- Returns dictionary keyed by spw ID with values of 'TDM' or 'FDM'
  873. pipelineTaskExecutionTimes -- Assembles and prints a list of time intervals from a CASA log of a pipeline run
  874. pipelineTimeOnSource -- Returns observing time on source from a pipeline weblog
  875. pipelineTsysFlags -- Parses casa log for number of flags found for a specified hifa_tsysflag metric
  876. pipelineVersionFromLogfile -- Reads the pipeline version used by a pipeline run from its CASA log file
  877. pipelineVersionFromWeblog -- Reads the pipeline version from a pipeline weblog
  878. pipelineWvrgcalFlaggedAntennas -- Reads the wvrgcal generated messages in a pipeline casa log file and returns a dictionary
  879. pixelsPerBeam -- Computes the number of pixel areas per resolution beam area of an image
  880. planet -- queries the JPL Horizons telnet server (or CASA) for the position, rate and angular diameter of a solar system body, with an option to run predictcomp
  881. planetFlux -- calls Bryan Butler's solar_system_setjy module to compute flux density vs. time or frequency
  882. planetPlots -- generates plots of uv amplitude vs. uv distance for a grid of ALMA configurations and frequencies for each planetary body
  883. planetTemperature -- Estimates the expected antenna temperature of a planet based on its model in casa
  884. plotAllPads -- Plots all ALMA pads on a radially-logarithmic scale, with colorization and orientation options for the labels
  885. plotAntennaAmbientTemperatures -- retrieves antenna temperatures from TMCDB and plots them vs. time and height
  886. es.plotAntennas -- plots the ALMA antenna configuration of a measurement set, including pad names
  887. plotantsFromASDM -- plots the ALMA antenna configuration of an ASDM (and optionally the weather stations) in linear and/or logarithmic fashion
  888. plotantsLogarithmic -- plots the antenna configuration of a measurement set in a logarithmic polar fashion
  889. plotantsTwoPanel -- Creates a 2-panel plot of the antenna configuration, with a zoom to the central array
  890. plotApexPWV -- retrieve and plot PWV measured at APEX
  891. plotAtmosphere -- plots the model atmospheric transmission, opacity or sky temperature vs. frequency for specific observatory and/or weather condition using matplotlib
  892. plotAtmosphereAcrossScienceSpws -- plots the model atmospheric transmission across all spws using plotms showatm option
  893. plotAzimuth -- plot the azimuth vs. time for a specific antenna in a dataset
  894. plotbandpass -- faster version of plotcal for bandpass tables, with useful overlay capabilities
  895. plotbandpassStats -- runs plotbandpass(channeldiff=5) several times and plots the MAD vs. channel averaging factor
  896. plotBaselinesOneScan -- makes multi-panel plotms plots of all requested spws on a per-baseline basis
  897. plotBaselinesPerScan -- makes multi-panel plotms plots of all baselines with specific antenna(s)
  898. plotBaselinesSorted -- makes single-panel plotms plots of all baselines, sorts them by baseline length and builds a big PDF
  899. plotcalCompare -- places two sequences of plotcal plots side-by-side onto each page of a multi-page PDF
  900. plotCalibratedData -- a wrapper for plotms that plots calibrated data
  901. plotCalibratedDatasets -- a wrapper for plotCalibratedData that runs it for multiple measurement sets in succession
  902. plotCalibratedSpectrum -- a wrapper for plotms that plots the calibrated uv spectrum of the bandpass calibrator (or other intent)
  903. plotconfig -- plot any standard telescope configuration of observatories known to casa, or custom config file
  904. plotconfigs -- overlay telescope configuration files
  905. plotDailyWeather -- runs plotWeatherFromDatabase on a series of days and generates a movie and multi-page PDF
  906. plotDecorrelation -- plot the decorrelation vs. baseline length from the CalPhase.xml file of an ASDM
  907. plotElevation -- plot the elevation vs. time for a specific antenna in a dataset
  908. plotElevationSummary -- uses plotms to create a field-color-coded summary of elevation vs. time for a measurement set
  909. plotExtremeBaselinePerAntenna -- plots the extreme (min, mean, median, or max) baseline length per antenna on an ASDM or config file
  910. plotFluxcsv -- plots the contents of a pipeline-generated flux.csv file
  911. plotGfluxscale -- Reads a pipeline-generated aquareport.xml and plots the derived flux densities and assumed catalog values for first derived calibrator
  912. plotLowGains -- Plots GainAmp vs. antenna name on a per-spw basis
  913. plotMedianTsysForFieldFromTsysCaltable -- computes and plots the median Tsys spectrum of a Tsys caltable
  914. plotmosaic -- shows relative location of pointings in an .ms
  915. plotmosaics -- runs plotmosaic on a list of datasets
  916. plotmsGrid -- plots values on a per-antenna average basis in a grid
  917. plotmsPhaseAmplitude -- uses plotms to make a 2-panel plot of amplitude and phase (or any 2 quantities)
  918. plotmsSpwOverlay -- uses plotms to overlay multiple spws, optionally smoothed to a common channel width
  919. plotmsTargetflag -- makes the same plotms plot for 2 versions of the same measurement set
  920. plotmsTwoColumnsVsTime -- uses plotms to make a multi-panel plot
  921. plotObservatories -- plots the IRTF X,Y coordinates on a polar projection of all observatories in the CASA repository table
  922. plotOxygenSounder -- gathers and plots the level zero products from the oxygen sounder by querying weather.aiv.alma.cl
  923. plotParallacticAngle -- Plot the parallactic angle vs. time across the sky for an radec
  924. plotParallacticAngleAcrossMOUS -- Plot the parallactic angle vs. time across the sky for a calibrator in a list of measurement sets
  925. plotParallacticAngleForPipeline -- Plot the parallactic angle coverage of the polcal for a pipeline run (does not separate multiple sessions)
  926. plotParallacticAngleSummary -- Plot the parallactic angle vs. time for all sources in a measurement set
  927. plotParallacticAngleSummarys -- Plot the parallactic angle vs. time for all sources in a list of measurement sets
  928. plotPhaseCheckTargetOnSky -- plots the relative positions of the phasecal, check source, and first science target of an ASDM
  929. plotPhaseSolutions -- plot a series of selfcal solutions to explore phase vs angular separation of target and calibrator
  930. plotPointingResults -- plot the pointing results written by TelCal to the ASDM_CALPOINTING table
  931. plotPointingResultsFromASDM -- plot the pointing results written by TelCal to the CalPointing.xml table
  932. plotPointingTable -- plots the azimuth and elevation vs. timestamp for one antenna from the MS POINTING table
  933. plotPointingTableAngleVsAngle -- plots a map of the DIRECTION or TARGET column of the MS POINTING table
  934. plotPWV -- plot PWV vs. time for your ms (from each antenna's WVR)
  935. plotPWVFromADSM -- plot PWV vs. time for your ASDM (median of all antennas over specified time interval)
  936. plotPWVFromASDMs -- plot PWV/medianPWV vs. pad height for a list of ASDMs
  937. plotPWVHistogram -- plots a histogram of the antenna-based PWV measurements for an ALMA dataset
  938. plotRefantScore -- plots a histogram of the refant total score from the CASA log of a pipeline run
  939. plotResampledWeatherFromTMCDB -- gets and plots weather from the TMCDB from specified range of days
  940. plotSamplersWithTsys -- plot autocorrelation of ATM Cal sky subscan and corresponding Tsys vs. channel on a per-antenna, per spw basis
  941. plotSBGain -- plot the sideband gain ratios from the SYSCAL table of a measurement set.
  942. plotSBGainFromASDM -- plot the sideband gain ratios for your ASDM
  943. plotSensitivityImprovement -- plots a grid of results from sensitivityImprovement
  944. plotSpectrumFromMask -- generates summary spectrum plot added to pipeline weblog in PIPE-198 for Cycle 7
  945. plotspw -- Like plotspws, but for showing only one spw across multiple measurement sets
  946. plotspws -- Makes a plot summarizing the location of the non-channel-averaged TDM and FDM spws in an ALMA dataset.
  947. plotSunDuringTrack -- plot the solar location during the specified dataset
  948. plotTcal -- plot the Tsys, Tsky or Trx columns of the SYSCAL table of an ALMA ms
  949. plotTrx -- plot the Trx column of the SYSCAL table of an ALMA ms (wrapper for plotTcal)
  950. plotTsky -- plot the Tsky column of the SYSCAL table of an ALMA ms (wrapper for plotTcal)
  951. plotTsys -- plot the Tsys column of the SYSCAL table of an ALMA ms (wrapper for plotTcal)
  952. plotWeather -- plot weather conditions vs. time for your ms
  953. plotWeatherFromASDM -- plot weather conditions vs. time for your asdm
  954. plotWeatherFromDatabase -- gathers and plots weather conditions from weather.aiv.alma.cl or from the TMCDB
  955. plotWeightsPerAntenna -- generates per-antenna plots of data weights
  956. plotWVRSolutions -- plot WVR caltable phase solutions on a baseline basis for a specified spw
  957. pngWidthHeight -- Gets the width and height of a png image (in pixels)
  958. pointingTableMedian -- Computes the median value of a tuple column in the POINTING table
  959. popularPadHistogram -- Makes a histogram after calling popularPads
  960. popularPads -- Determines the number of notional 12m configurations that each non-ACA pad appears in
  961. primaryBeamArcsec -- compute the primary beam in arcseconds from an ms and spw, or by specifying frequency or wavelength
  962. primaryIntentLetter -- translate a single scan intent into a single character
  963. printBaselineAngularScale -- converts a baseline length into an angular scale at the specified frequency
  964. printBaselineUVDistance -- converts a baseline length into a uv distance at the specified frequency
  965. printFluxesFromASDM -- calls readFluxesFromASDM and prints the results in a table
  966. printLOs -- print the values of LO1, LO2 and YIG for each spw in an ms
  967. printLOsFromASDM -- print the values of LO1 and LO2 frequencies and compute TFB LO and YIG frequency for each spw in an ASDM, and show the window function used for each spw (i.e. Hanning vs. uniform)
  968. printPngListFromCSVFile -- prints all png files whose names are present in a CSV-format file
  969. printSwVersionFromASDM -- Reads and prints the contents of the ASDM's Annotation.xml table
  970. printTsysFlags -- prints the flags found in a Tsys table (ignoring the N edge channels)
  971. projectCodeForMOUS -- looks up the project code for an MOUS
  972. projectCodeFromSB -- looks up the project code, MOUS, EB, and ALMA region from an SB uid
  973. projectCodeFromDataset -- looks up the project code, SB name and ALMA region from an ASDM or measurement set name
  974. ami.projectCodeFromWorkingDir -- extracts the project code and pipeline start time from a pipeline working directory
  975. properMotion -- reads the proper motion from the SOURCE table of a measurement set
  976. properMotionASDM -- reads the proper motion from the Source.xml of an ASDM
    Q
  977. properMotionConversion -- converts between arcsec/yr and rad/s
  978. psfDynamicRange -- computes ratio of peak to highest sidelobe in central channel of cube
  979. qa0flags -- Summarize the QA0 flags in the FLAG_CMD table of a measurement set
    R
  980. radecOffsetFileToRadec -- converts an absolute position and a file of relative offsets into a file of absolute positions
  981. radecOffsetToRadec -- converts an absolute position and offset into a new absolute position
  982. radecToEcliptic -- uses CASA measures tool to convert from equatorial to ecliptic coordinates
  983. radec2deg -- converts an RA, Dec string in sexagesimal format to degrees
  984. radec2direction -- converts an RA, Dec string in sexagesimal format to a casa direction dictionary
  985. radec2ra -- convert an RA/Dec string in sexagesimal format to just the RA part
  986. radec2rad -- convert an RA/Dec string in sexagesimal format to radians
  987. radialVelocity -- reads the SYSVEL column of the SOURCE table for the specified source and spw
  988. rad2direction -- converts an RA, Dec from a radians tuple or list into a casa direction dictionary
  989. rad2radec -- convert an RA/Dec (or component0 from an imfit dictionary) from radians to sexagesimal
  990. rads2radec -- convert a list of RA/Dec from radians to sexagesimal
  991. rarad2hms -- Convert radians of right ascension to sexagesimal HH:MM:SS
  992. ratioImageStdPerChannel -- runs imageStdPerChannel for two cubes and plots the spectral ratio of the selected imstat statistic
  993. readAntennaPositionFromASDM -- returns a dictionary of antenna positions read from an ASDM
  994. readAntennasFromASDM -- returns a list of antenna names (and optionally their stations) in the Antenna.xml file of an ASDM
  995. readAntennasFromCalPosition -- returns a list of antenna names from a CalPosition.xml file as written by tc_antpos
  996. readCalData -- Provides the mapping from cal data ID to scan number by reading the ASDM_CALDATA table of a measurement set
  997. readCalDataFromASDM -- Builds a dictionary relating the calDataId to the scan number of an ASDM.
  998. readNonStandardHeader -- Reads the pixel information from a CASA image that does not have a spectral axis (workaround for CAS-5901)
  999. readpwv -- assembles the dictionary returned by readwvr into arrays containing the PWV measurements
  1000. readSeeingFromASDM -- returns a dictionary containing information from the Seeing.xml file
  1001. readwvr -- reads the CalWVR.xml table from the ASDM and returns a dictionary
  1002. readFitsMultiBeamTable -- reads the CASA beam table from a FITS cube and computes the median shape and position angle
  1003. readFluxCSV -- reads the flux.csv file of a pipeline run and returns a dictionary
  1004. readFluxesFromASDM -- Read the flux densities from the Source.xml file of an ASDM.
  1005. readPipelineContDat -- Reads a cont.dat file and returns a dictionary keyed by spw ID
  1006. readPointingModelFromASDM -- Reads the pointing model for one (or all) antennas of an ASDM
  1007. readRefantScoresFromCasalog -- Reads refant flagging and total scores from a CASA log for a specific ms and returns dictionaries
  1008. readStationFromASDM -- Reads one or all stations from the ASDM, dictionary keyed by station number
  1009. readStationsFromASDM -- Reads one or all stations from the ASDM, dictionary keyed by station name
  1010. readStationFromASDMKeyedByAntennaName -- Reads one or all stations from the ASDM, dictionary keyed by antenna name
  1011. readSysCal -- Reads the SysCal.xml file of an ASDM searching for duplicate entries
  1012. readTcal -- Read the Tcal, Trx, or Tsys spectrum from the ASDM for a specific antenna, spw, and time
  1013. readTimesFromAnnotationTable -- Reads the parameter optimization entries for integration time from ASDM Annotation.xml
  1014. readTMCDBVersionAntennaHistory -- Reads the history of updates for an antenna
  1015. readTMCDBVersionPadHistory -- Reads the history of updates for a pad
  1016. rebuildWeblog -- Regenerates the weblog from a pipeline execution
  1017. receiverTrxSpec -- Returns the Trx specification for the specified ALMA band
  1018. receiverTrxOT -- Returns the Trx used by the OT for the specified ALMA band
  1019. recenterOTPointings -- takes a Cycle 4 format OT pointings file and recenters it on a new direction
  1020. receptorAngles -- Prints the receptor angles associated with each antenna in the FIELD table of a measurement set.
  1021. recoverImfitEstimates -- Extracts estimates used by imfit from the CASA log into a text file (in case you changed it in the meantime)
  1022. refantScoreHistogram -- Builds histogram of refant total score and flagging score from a CASA log (see also plotRefantScore
  1023. refraction -- Computes the refraction angle for the specified elevation and weather
  1024. removeLines -- Removes all lines of an ASCII file that contain a specific string
  1025. removeAntennaFromCaltable -- Removes all rows in a caltable associated with an antenna
  1026. removeFieldFromTsysTable -- Removes all rows in a Tsys table associated with a specific field ID or field name
  1027. removeImageIfPresent -- Removes a file or directory if it is present
  1028. removePhasecalsFromSyscalTable -- Removes the rows from a SYSCAL table associated with phase calibrators (or other specified intent or specified scans)
  1029. removePhasecalsFromTsysTable -- Removes the rows from a Tsys table associated with the phase calibrators
  1030. removeScanFromCaltable -- Removes all rows from a caltable associated with a specified scan number
  1031. removeTargetMSfromList -- Removes all _target.ms from a list of measurement sets
  1032. removeTsysSpike -- interpolate a Tsys table across a spike or other unwanted feature
  1033. removeWhiteSpace -- removes spaces, tabs and newlines from a string
  1034. renameAntennas -- renames all, or a list of, antennas in a measurement set (helpful for simulations)
  1035. renameMsInCalTable -- Change the name of the MSName keyword in the header of a caltable
  1036. repairAtmcalStateIDs -- Repairs the stateId entries in the Main.xml file of an ASDM for all the AtmCal scans
  1037. repairSidebandRatio -- prepares an ASDM for running casapy-telcal's tc_sidebandratio() command to recompute SB gains and then runs it
  1038. repairSysCal -- prepares an ASDM for running casapy-telcal's tc_atmosphere() command to recompute Trx/Tsys and then runs it
  1039. replaceFinalAppearanceOfSubstringInString -- replace the final appearance of a substring with a different string
  1040. replaceMonth -- Replaces a 3-character month string with its 2-character integer string
  1041. replacePipelineStage - replaces the stage number string in a pipeline-generated filename
  1042. replaceTsys -- copy a scaled version of the Tsys values for one antenna, one spw, one polarization, to another
  1043. replaceTsysScan -- copy the Tsys values for one antenna, one spw, one polarization, one scan to a different scan
  1044. replaceTsysScanFromSQLD -- replaces existing Tsys values in a caltable with those from the SQLDs (located in an ASDM SysCal.xml table)
  1045. representativeFrequency -- gets the representative frequency for an ALMA measurement set
  1046. representativeFrequencyFromASDM -- gets the representative frequency for an ALMA ASDM
  1047. representativeSpw -- gets the spw that contains (and whose center frequency is closest to) to the representative frequency of a measurement set
  1048. requestedResolution -- gets the min/max acceptable angular resolution from a measurement set
  1049. requestedResolutionFromASDM -- gets the min/max acceptable angular resolution from an ASDM
  1050. resetVisibilities -- Sets the visibilities (data column) of a measurement set to a single user-supplied value
  1051. resetweights -- Set the data weights in a measurement set to a user-supplied factor
  1052. restFrequencies -- Returns a dictionary of spw rest frequencies for an ms
  1053. restFrequenciesASDM -- Returns a dictionary of spw rest frequencies for an ASDM
  1054. restFrequency -- read the spectral line rest frequency for the source and spw (originating in the OT)
  1055. visibilityOutliers.restoreCorrectedAmpFlagStage -- Prints commands to prepare a pipeline calibrated ms for testing with vo.makeFlagTemplates
  1056. restToLSRK -- convert rest frequency to LSRK frequency
  1057. roundFigures -- Rounds a value to N significant digits and outputs a float
  1058. roundFiguresToString -- Rounds a value to N significant digits and outputs a string
  1059. roundMeasurementToString -- Rounds two values to the same number of significant figures and generates a string
  1060. roundRadec -- Rounds a sexagesimal RA, Dec string to a specified precision (number of digits after the seconds decimal)
  1061. ami.runImstat -- Runs imstat with simultaneous mask and annulus options
  1062. runPipeline -- Generates a small script to run the pipeline from PPR, pausing and running correctMyAntennaPositions and getALMAFluxcsv before restarting
  1063. runPredictcomp -- A convenient wrapper for running the casa task predictcomp
  1064. ruzeEfficiency -- Computes Ruze efficiency for wavelength, surface rms
    S
  1065. sbnameForMOUS -- Looks up the SB name for a science MOUS
  1066. scaleChanwidth -- Scales the channel width of an spw in a measurement set
  1067. scaleEffectiveBandwidth -- Scales the effective bandwidth of an spw in a measurement set
  1068. scaleEffectiveBandwidthASDM -- Scales the effective bandwidth of an spw in an ASDM
  1069. scaleEffectiveResolution -- Scales the effective resolution of an spw in a measurement set
  1070. scaleEffectiveResolutionASDM -- Scales the effective resolution of an spw in a measurement set
  1071. scaleweights -- Scale the data weights in the WEIGHT column in a measurement set by a factor
  1072. scaleWeightSpectrum -- Scales the data weights in the WEIGHT_SPECTRUM column in a measurement set by a factor
  1073. scaleWeightsPerAntenna -- Scales the data weights individually on each antenna in a measurement set by an individual factor
  1074. scansForIntent -- Returns a list of scans for a specific intent in a measurement set
  1075. scienceScanTimeFromWeblog -- Reads the scan start/end times for science targets from weblog
  1076. searchFlux -- Search the ALMA calibrator catalog for a specific source to get its measured flux densities
  1077. searchFluxForMS -- Search the ALMA calibrator catalog for all non-science targets in a measurement set
  1078. searchFluxPolarization -- Search the ALMA calibrator catalog for recent observations of polarization calibrators
  1079. sensitivity -- Calculate sensitivity of various telescopes (this is a wrapper for simutil's calculator which matches the ALMA OT)
  1080. sensitivityAdjustment -- Computes the formula from CAS-8534
  1081. sensitivityImprovement -- Computes the expected improvement in sensitivity from making ALMA images with combined channels
  1082. setBeam -- Set the restoring beam in the header of a CASA image
  1083. setFieldTime -- Sets a cell in the TIME column of the FIELD table of an ms
  1084. setImageUnits -- Sets the units of the first two axes of an image to the specified angular unit using imhead 'put'
  1085. setMeasFreqRef -- modifies the MEAS_FREQ_REF column of a SPECTRAL_WINDOW table of an ms, which encodes whether the frequency frame is TOPO or LSRK, etc.
  1086. setObject -- Sets the OBJECT (and FIELD) keywords in a FITS image
  1087. sevenMeterAntennasMajority -- returns True if the majority of antennas are <= 7m diameter
  1088. sevenMeterAntennasOnly -- Checks for 'CM' in antenna names, and returns False if at least one is not
  1089. sevenMeterAntennasMajorityASDM -- returns True if the majority of antennas in an ASDM are <= 7m diameter
  1090. sevenMeterAntennasOnlyASDM -- Checks the antenna diameters in an ASDM and returns True if all are less than 8m
  1091. sfBeam -- compute the effective restoring beam obtained from the casa command sd_imaging using the SF gridding function
  1092. sharedPads -- finds pads that are shared by specified list of configurations
  1093. shiftChannelSelection -- shifts a CASA channel selection string by a specified number of channels
  1094. sidebandToNetSideband -- convert from the [-1,+1] convention to the measurement set convention [+1,+2]
  1095. sidebandToString -- converts -1, +1 to 'LSB', 'USB'
  1096. singleDishSpectrum -- computes calibrated spectra from a single dish measurement set in a variety of ways
  1097. smooth -- smooth data using a specified window and size
  1098. smoothbandpass -- smooths an existing bandpass table with options for window length and type (Ed Fomalont)
  1099. smoothSpectralWindowTable -- resamples the vector columns of a spectral window table by taking means
  1100. smoothTsys -- filters and decimates all spws in a Tsys caltable to emulate lower resolution measurements
  1101. smoothTsysSpw -- filters and decimates a single spw in a Tsys caltable to emulate lower resolution measurements
  1102. snrFromCaltable -- builds a dictionary of statistics of the SNR in a caltable
  1103. snrToPhaseRmsDegrees -- converts the S/N of a visibility into rms phase in degrees
  1104. sortByObservationDate -- sorts a list of measurement sets by their observation start date/time
  1105. spectralindex -- performs least-squares fit to the output from fluxscale, computes uncertainties, and produces a plot
  1106. splitListIntoContiguousLists -- Converts [1,2,3,5,6,7] into [[1,2,3],[5,6,7]], etc., and (optionally) trim and recombine
  1107. splitListIntoHomogeneousLists -- Converts [1,1,1,2,2,3] into [[1,1,1],[2,2],[3]], etc.
  1108. spwForRestFrequency -- Finds the spw that contains the defined rest frequency closest to a specified value
  1109. spwPhaseupFromWeblog -- Finds whether mapping or combine was used for each vis, and which spws have relevant solutions
  1110. spwsForFields -- calls msmd.spwsforfield for each field in a list and returns the union
  1111. spwsForNames -- returns a list of spw IDs corresponding to a list of spw names
  1112. spwsForScan -- returns a dictionary keyed by scan number, with values equal to the non-chanavg, non-WVR, non-SQLD spws
  1113. spwToLSRK -- converts TOPO frequencies in a measurement set to LSRK for a specified field
  1114. spwType -- Determines the type of ALMA spw based on the number of channels
  1115. SQLD -- a class to read the baseband total power detector coefficients from the computing logs web interface and apply them to a measurement set to convert from counts to dBm
  1116. strDate2MJD -- converts date in string format (YYYYMMDD or YYYY-MM-dd) to MJD
  1117. strongTsysLines -- returns dictionary containing number of strong features in each Tsys spw
  1118. strongTsysLinesInSpw -- returns number of strong features in the specified Tsys spw
  1119. subtractDays -- subtract a specified number of days from a date string
  1120. subtractGaussianFromImage -- Subtract a 2D Gaussian from an image
  1121. analyzemsimage.summarizeFindcont -- builds a multi-panel png for the findcont joint masks and mean spectra from a pipeline run, or pair of serial/parallel pipeline runs
  1122. analyzemsimage.summarizeFindconts -- runs summarizeFindcont for a list of pairs of pipeline runs
  1123. summarizeFlagFile -- Summarizes flag file per spw and per field
  1124. summarizeImfitResults -- Computes the median and MAD of a dictionary list of imfit fit results
  1125. sun -- computes the azimuth and elevation of the Sun at a specified time (or "now"), for any observatory known to CASA
  1126. sunrise -- computes the sunrise and sunset in mjd seconds for the specified date and observatory
  1127. surmiseConfiguration -- determine the most closely matching ALMA configuration from a measurement set (also works for VLA and other interferometers)
  1128. surmiseConfigurationFromASDM -- determine the most closely matching ALMA configuration from an ASDM (also works for VLA)
  1129. surmiseConfigurationFromImage -- determines nominal ALMA configuration that would produce the beam of the specified image
  1130. surmiseCycle -- determine the ALMA cycle from the date of a measurement set
  1131. surmiseCycleFromASDM -- determine the ALMA cycle from the date of an ASDM
  1132. surmiseCycleFromImage -- determine the ALMA cycle from the date of an image
  1133. surmiseEffectiveResolution -- determine the effective resolution of a channel in an ALMA measurement set
  1134. surmiseOnlineChannelAveraging -- determine the level of channel averaging in an spw of an ALMA measurement set
  1135. swapPhasecalChecksourceIntents -- swaps all appearances of CALIBRATE_PHASE with OBSERVE_CHECK_SOURCE
    T
  1136. amc.tailCalibPipeLogfile -- searches the specified directory tree for the newest calibPipeIF.*log file and runs "tail -f" on it
  1137. amc.tailPipelineCasaLogfile -- searches the specified directory tree for the newest casa log file, optionally containing an applycal call on a specified ASDM, and runs "tail -f" on it
  1138. ALMA.TargetRADecFromWeblogtargetRADecFromWeblog]] -- Reads the RA/Dec of all science targets from the weblog
  1139. taskExecutionTimes -- computes the time taken to execute a task in a casa log file
  1140. tcleanMemoryFromLogfile -- computes the median value of Available memory in a casa log containing tclean commands
  1141. tcleanMemoryFromLogfiles -- computes the median value of Available memory in several casa logs
  1142. tcleanVelocityParameters -- determines nchan, start, width, restfreq parameters for tclean for an MOUS
  1143. testFlagRowColumn -- Tests whether the FLAG_ROW column is consistent with the FLAG column
  1144. timeDifference -- compute the time difference between two observations (two .ms)
  1145. timeDifferenceASDM -- compute the time difference between two ASDMs
  1146. timeOnSource -- compute the total time spent integrating on-source for each specified field
  1147. timeOnSourceFromWeblog -- Reads time on science targets from weblog
  1148. timeOnSourceSD -- compute the total time spent integrating on-source and off-source on the science target in a single dish dataset
  1149. timePipelineImaging -- Parses the CASA log to build a dictionary of tclean run times
  1150. timeTargetflag -- Parses the CASA log to compare time required for various pieces of hifa_targetflag
  1151. timeTclean -- Times the various parts of tclean autoboxing for Major Cycle 2 from a CASA log file
  1152. topoChannelToLSRK -- convert a visibility channel TOPO frequency to LSRK frequency
  1153. topoToLSRK -- convert topocentric frequency to LSRK frequency
  1154. topoToRest -- convert topocentric frequency to rest frequency
  1155. transferWeights -- transfers the weights from one measurement set to another
  1156. transferWeightsWithinMS -- transfers the weights from one spw to one or more other spws (in the same measurement set)
  1157. transition -- read the spectral line transition name for the source and spw (originating in the OT)
  1158. transitions -- returns a dictionary of spectral line transitions keyed by spw of the science spws of a specified ms
  1159. transitTime -- Compute the time of transit on a certain date for an RA, or a field from a measurement set
  1160. transitTimeUnix -- Compute the unix time in seconds of transit on a certain date for an RA, or a field from a measurement set
  1161. es.tsysAverage -- computes and plots the average (per-spw) Tsys spectrum for an ALMA Tsys caltable
  1162. tsysFromListobs -- Returns the number of Tsys scans on phasecal and science targets from a listobs text file
  1163. tsysFromMOUSListobs -- Returns the number of Tsys scans on phasecal and science targets in each EB of a pipeline-reduced MOUS
  1164. tsysspwmapWithNoTable -- finds the Tsys spw corresponding to a specfied spw without the need for a tsys caltable
  1165. tunnel -- open an ssh tunnel to a server in Chile, e.g. for accessing the calibrator catalog
  1166. twoSourceDataset -- modifies the intents of a two-source measurement set so that it can be run through the script generator
    U
  1167. uidToUnderscores -- converts a colon/slash delimited uid to underscore-delimited, preserving any initial path
  1168. unifyFieldTimes -- Copies the time for a field in the FIELD table from one ms to a list of others
  1169. uniqueValuesInASCIIFileColumn -- reads in a list of ASCII files, parses 1 or 2 columns and returns a dictionary of the unique values in those columns
  1170. unixTimeToDateString -- converts a unix time (in seconds) to "YYYY-MM-DD HH:MM:SS UT"
  1171. unixtimeToSiderealTime -- converts a unix time in seconds to sidereal time at specified observatory
  1172. unpackWeblogs -- unpacks the tarball weblogs contained in a list of directories
  1173. unwrapCasaCommandLog -- Takes an ASCII file and unwraps the long lines (without breaking words)
  1174. updateImfitEstimates -- Reads logfile produced by imfit and updates an estimates file for peak intensity and x and y
  1175. updateSBSummary -- Changes values in the ASDM_SBSUMMARY table of a measurement set
  1176. updateSBSummaryASDM -- Change values in the SBSummary.xml file of an ASDM
  1177. updateSBSummaryMOUS -- Change values in the ASDM_SBSUMMARY table of a list of measurement sets according to a text file
  1178. uvcontfitCaltable -- Examine values in a caltable generated by uvcontfit
  1179. uvplot -- Makes a uv plot with points mirrored about the origin (similar but inferior to plotuv in casa)
  1180. uvplotHeterogeneous -- Makes a 4-panel Vwave vs. Uwave plot of heterogenous ALMA dataset
  1181. uvplotMultiEB -- Overlays the uv coverage of multiple EBs by calling plotms repeatedly
  1182. upsampleSpectralAxis -- Resample's the spectral axis of a cube by a specified factor (using imregrid)
  1183. uvtaperProtection -- Preliminary algorithm for tapering the effect of outlier antennas in an ms
  1184. uvtaperProtectionASDM -- Preliminary algorithm for tapering the effect of outlier antennas in an ASDM
  1185. uvwDifference -- compute the difference in uvw's between two (nearly) identical ms's
    V
  1186. validCalibration -- checks if all science spws were also observed with the specified calibration intent
  1187. velocityRange -- computes LSRK velocity range of the visibility data of an spw
  1188. velocityResolution -- computes the velocity resolution of spw(s) of a measurement set
  1189. version -- returns the CVS version number of analysisUtils.py
  1190. versionsFromWeblog -- reads the CASA and pipeline versions from the weblog main page
  1191. virtualSpwsNeeded -- returns the number of EBs that require virtual spw mechanism for a specified pipeline working directory
  1192. visHistory -- returns and/or searches the history of a measurement set
  1193. vislistFromWeblog -- reads list of measurement sets from weblog
  1194. visstatBinnedUVSpectrum -- calls visstat N times to build up an N-channel spectrum
  1195. visstatParse -- Computes mean timestamp of data selected by visstat
  1196. visstat2uvrange -- computes the global min/max uvrange over all spws from a dictionary returned by visstat2(axis='uvrange')
    W
  1197. waterPartialPressure -- converts relative humidity and temperature into partial pressure of water vapor
  1198. waterVaporPressure -- computes vapor pressure of water at a particular temperature using the Antoine equation
  1199. waveNumberPerAtmosphereToMHzPerMillibar -- converts air broadening coefficient to different units
  1200. waveNumberToFrequency -- converts wave number to frequency in GHz
  1201. weatherCorrelation -- plots one ALMA weather station quantity vs. another for one station.
  1202. weatherCorrelationMontage -- calls weatherCorrelation for all ALMA stations and assembles result into relative location on Chajnantor
  1203. amc.weblogDuration -- returns the duration string shown in the pipeline weblog main page
  1204. widestChanwidth -- returns the widest channel width for the specified list of spws in a measurement set
  1205. windowFunction -- returns the FWHM or effective bandwidth (in channels) for the chosen ALMA correlator window function
  1206. wvrAmplitudes -- returns the median and maximum values of each WVR channel per antenna, for a specified field
  1207. wvrCorrelation -- computes the covariance between the WVR data channels and the astronomical autocorrelation, scaled to the variance of the WVR data
  1208. wvrdata -- Looks in CalPhase.xml of an ASDM to determine if it contains WVR-corrected data or not
  1209. wvrgcalStats -- runs wvrgcal once for each source ID with --statsource set and generates a table of RMS and discrepancy statistics
  1210. es.wvr_stat_all -- runs es.wvr_stat once for each spw/pol combination, and assembles all the plots into a PDF
    X
  1211. xyz2long -- A convenient wrapper for simutil.xyz2long to convert the specified ITRF location to degrees of latitude and longitude
    Y
  1212. yearFraction -- computes the epoch (e.g. 2016.02344) for a specified date time string
  1213. yigHarmonic -- returns the YIG harmonic used in the WCA of the specified ALMA band
  1214. yigRange -- returns the required tuning range in Hz of YIG in the WCA of the specified ALMA band
  1215. ymdhmsToMJD -- converts the date and time specified via 3 to 6 integers into MJD

Additions from others

  • InterpolateTsys -- Stuartt Corder
    • related CASA recipes:
      • tsysspwmap
        • from recipes.almahelpers import tsysspwmap
        • tsysspwmap(vis='', tsystable='')
      • fixsyscaltimes
        • from recipes.almahelpers import fixsyscaltimes
        • fixsyscaltimes(vis='blah.ms')
  • stuffForScienceDataReduction -- a class containing methods to correct antenna positions, etc. (Eric Villard)
    • generateReducScript -- generate a script to reduce ALMA data
    • generateQA2Report -- generate a QA2 report for ALMA Cycle 0 or Cycle 1 data
    • correctMyAntennaPositions -- print out the exact gencal command you need to run to apply the most recent position offsets applicable to your array configuration
    • wvr_stat -- QA2 function to determine the phase rms before and after application of wvr
  • ValueMapping -- A class which provides details on the mapping of various parameters of an ms to each other, which is used by many of the functions above (Stuartt Corder)

Other utilities for EVLA, etc.

Easy access in Charlottesville or Socorro

  • create a file in your home area: ~/.casa/init.py which contains:
import sys
sys.path.append("/users/thunter/AIV/science/analysis_scripts/")
import analysisUtils as au
  • start casa
  • Now you can access all functions, for example: au.plotbandpass()

Easy access for users outside of NRAO

  • download the tar file analysis_scripts.tar
  • unpack it in a designated area, such as your home directory -- it will make a subdirectory called analysis_scripts
  • edit your file ~/.casa/init.py to contain the following lines:
import sys
sys.path.append("/your_parent_directory/analysis_scripts/")
import analysisUtils as au
  • start casa
  • Now you can access all functions, for example: au.plotbandpass()

-- ToddHunter - 2011-10-07

  • analysisUtils.py_history.png: generated by tt.plotLinesOfCodeVsTime(filename='analysisUtils.py')
    analysisUtils.py history.png
Topic attachments
I Attachment ActionSorted ascending Size Date Who Comment
analysisUtils.py_history.pngpng analysisUtils.py_history.png manage 61 K 2018-05-18 - 14:59 ToddHunter  
runspecfit.py.txttxt runspecfit.py.txt manage 5 K 2012-10-19 - 16:10 ToddHunter Example script using specfit to fit multiple Gaussians to multiple pixels in a cube
Topic revision: r860 - 2020-08-06, ToddHunter
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding NRAO Public Wiki? Send feedback