Next: Abstract

CURSA

Catalogue and Table Manipulation Applications
Version 6.4
User's Manual

Starlink User Note 190.11
A.C. Davenhall
4th November 2001

CCLRC / Rutherford Appleton Laboratory
Particle Physics & Astronomy Research Council

Starlink Project

Retrieve hardcopy

Abstract
CURSA Quick Reference
- Applications
- Catalogue formats
- Expressions
Preliminaries
- CURSA home page and on-line documentation
- Assistance and further information
- Acknowledgments
- Revision history
Introduction
Obtaining copies of catalogues
Getting started
Terminology
- Column attributes
  - NAME
  - DTYPE
  - DIMS
  - SIZE
  - UNITS
  - EXFMT
  - COMM
Null values
- Processing null values
- Displaying null values
Celestial coordinates
Target lists
Accessing catalogues
- FITS tables
- TST
- STL
Answering prompts in CURSA applications
Summary of applications
- Copying textual information
- Quiet mode
- Extra functionality
- Inter-operability with FTOOLS
- Inter-operability with Starbase
Browsing and selecting with an X display
- Statistics computed for individual columns
- Restarting xcatview after a crash
Browsing and selecting from the command line
- Running catview from a script
- Continuation lines for long lists of columns and expressions
  - Examples
Listing header details
Copying a catalogue
Sorting a catalogue
Selecting subsets from a catalogue
- Running catselect
- Types of selections
Converting between celestial coordinate systems
- Running catcoord
Plotting finding charts
- Suitable catalogues
  - Remote query
  - Local copies
- Running catchart
- Customising the plot
- Worked example
Plotting with other packages
Pairing two catalogues
- Requirements
- Running catpair
- Pairing criteria
- Rows in the output catalogue
- Multiple matches
- Pairing algorithm
Photometric calibration
- Description
- Assembling the input catalogues
  - Standard star catalogue
  - Programme object catalogue
- Applications for photometric calibration
- Running catphotomfit
- Running catphotomtrn
- Running catphotomlst
- Calculating the air mass
Binning columns in a catalogue into a grid
- Running catgrid
Importing CDS catalogues
- Running catcdsin
Importing regions of the HST GSC
Accessing remote catalogues
- Running catremote
- Environment variables
- Specifying the list of remote catalogues
  - Creating your own configuration file
- How remote access works
- Peculiarities and shortcomings
- Local or remote access?
Expression syntax
- Creating a new column
- Defining a new selection
- Details of expressions
- Mathematical functions provided
- Rules for expressions
- Operator precedence
Storing and representing columns of angles
- Angular format specifiers
Catalogue formats
- FITS
  - Textual information
- TST
  - Textual information
  - Null values
- STL
  - Textual information
  - Null values
STL description tutorial
- First example
- Second example
STL description reference
- Basics
- Columns
- Parameters
  - Mandatory items
  - Optional items
- Directives
KAPPA format STL
- Inter-operability with KAPPA
Inter-operability with PISA
Detailed description of applications
- CATCDSIN - Convert a CDS ReadMe file into a CURSA STL description file
- CATCHART - Plot a one or more target lists as a finding chart
- CATCHARTRN - Translate a target list into a graphics attribute list
- CATCOORD - Convert to a new celestial coordinate system
- CATCOPY - Generate a new copy of a CAT catalogue
- CATGRID - Generate an NDF grid from up to three columns in a catalogue
- CATGSCIN - Convert a GSC region to the preferred CURSA format
- CATHEADER - List various header information for a catalogue
- CATPAIR - Pair two catalogues
- CATPHOTOMFIT - Fit instrumental to standard magnitudes
- CATPHOTOMLST - List a file of photometric transformation constants
- CATPHOTOMTRN - Transform instrumental to calibrated mags. for programme stars
- CATREMOTE - A simple script to query remote catalogues
- CATSELECT - Generate a selection from a catalogue
- CATSORT - Create a copy of a catalogue sorted on a specified column
- CATVIEW - Application to browse and generate selections from a catalogue
Bibliography
About this document ...

Next: Abstract

CURSA Catalogue and Table Manipulation Applications
Starlink User Note 190
A.C. Davenhall
4th November 2001
E-mail:ussc@star.rl.ac.uk

Copyright © 2001 Council for the Central Laboratory of the Research Councils

CURSA Catalogue and Table Manipulation Applications Version 6.4 User's Manual

CCLRC / Rutherford Appleton Laboratory Particle Physics & Astronomy Research Council

Starlink Project

Contents

CURSA

Catalogue and Table Manipulation Applications
Version 6.4
User's Manual

CCLRC / Rutherford Appleton Laboratory
Particle Physics & Astronomy Research Council