### CATSELECT

Generate a selection from a catalogue

#### Description:

Generate a selction from a catalogue using one of a number of a different type of selections. Optionally the rejected objects may be written to a separate catalogue. The following types of selections are available.

Arbitrary expression: objects which satisfy an algebraic expression which you supply.

Range within a sorted column: objects which lie within a given range for a specified column. This option only works on sorted columns. However, because it is not necessary to read the entire column it works essentially instantaneously, irrespective of the number of rows in the catalogue.

Rectangular area: objects which lie within a given rectangle. (If the columns are spherical-polar coordinates, such as Right Ascension and Declination, rather than Cartesian coordinates then the sides of the rectangle become parallels and great circles.)

Circular area: objects which lie within a given angular distance from a specified point. This type of selection is only likely to be used on columns of celestial coordinates.

Polygonal area: objects which lie inside (or outside) a given polygon.

Every Nth entry: every Nth object from the catalogue. This option is useful for producing a smaller, but representative, sample of a large catalogue. Such a sample might then be investigated interactively in cases where the original catalogue was too large to be studied interactively.

catselect

#### Parameters:

##### CATIN = CHARACTER (read)
Give the name of the input catalogue.
##### CATOUT = CHARACTER (read)
Give the name of the output catalogue of selected objects.
##### CATREJ = CHARACTER (read)
Give the name of the output catalogue of rejected objects.
##### SELTYP = CHARACTER (read)
Enter the required type of selection ("H" for a list).
##### TRNFRM = LOGICAL (read)
Transform criteria to catalogue system before selection?
##### TARGET = LOGICAL (read)
Output the selection as a target list?
##### REJCAT = LOGICAL (read)
Produce a second output catalogue containing the rejected objects?
##### EXPR = CHARACTER (read)
Enter an expression defining the required selection.
##### PNAME = CHARACTER (read)
Enter the name of column or parameter.
##### MINRNG = CHARACTER (read)
Enter minimum value of the required range.

If the column within which the range is being specified is not an angle then simply enter the required value.

If the column is an angle then the value can be entered as either a decimal value in radians or a sexagesimal value in hours or degrees, minutes and seconds. If a sexagesimal value is specified then the hours or degrees, minutes and seconds should be separated by a colon (’:’). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. An unsigned value is assumed to be in hours and a signed value in degrees (a negative angle cannot be specified in hours). That is, a positive angle in degrees must be preceded by a plus sign.

Examples: any of the following values could be entered to to specify an angle of 30 degrees:

2:00:00.0 hours (decimal point included in seconds) 2:00:00 hours (integer number of seconds)

$+$30:00:00.0 degrees (decimal point included in seconds) $+$30:00:00 degrees (integer number of seconds)

##### MAXRNG = CHARACTER (read)
Enter maximum value of the required range.

If the column within which the range is being specified is not an angle then simply enter the required value.

If the column is an angle then the value can be entered as either a decimal value in radians or a sexagesimal value in hours or degrees, minutes and seconds. If a sexagesimal value is specified then the hours or degrees, minutes and seconds should be separated by a colon (’:’). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. An unsigned value is assumed to be in hours and a signed value in degrees (a negative angle cannot be specified in hours). That is, a positive angle in degrees must be preceded by a plus sign.

Examples: any of the following values could be entered to to specify an angle of 30 degrees:

2:00:00.0 hours (decimal point included in seconds) 2:00:00 hours (integer number of seconds)

$+$30:00:00.0 degrees (decimal point included in seconds) $+$30:00:00 degrees (integer number of seconds)

##### FREQ = INTEGER (read)
Every FREQth object will be selected.
##### XCOL = CHARACTER (read)
Enter X coordinate column from input catalogue.
##### YCOL = CHARACTER (read)
Enter Y coordinate column from input catalogue.
##### CATPOLY = CHARACTER (read)
Give the name of the catalogue containing the polygon.
##### XPLCOL = CHARACTER (read)
Enter X coordinate column from polygon catalogue.
##### YPLCOL = CHARACTER (read)
Enter Y coordinate column from polygon catalogue.
##### INSIDE = LOGICAL (read)
The objects either inside or outside the polygon may be selected.
##### XMIN = DOUBLE (read)
Minimum X value for the required rectangle.

If the X column within which the minimum is being specified is not an angle then simply enter the required value.

If the column is an angle then the value can be entered as either a decimal value in radians or a sexagesimal value in hours or degrees, minutes and seconds. If a sexagesimal value is specified then the hours or degrees, minutes and seconds should be separated by a colon (’:’). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. An unsigned value is assumed to be in hours and a signed value in degrees (a negative angle cannot be specified in hours). That is, a positive angle in degrees must be preceded by a plus sign.

Examples: any of the following values could be entered to to specify an angle of 30 degrees:

2:00:00.0 hours (decimal point included in seconds) 2:00:00 hours (integer number of seconds)

$+$30:00:00.0 degrees (decimal point included in seconds) $+$30:00:00 degrees (integer number of seconds)

##### XMAX = DOUBLE (read)
Maximum X value for the required rectangle.

If the X column within which the maximum is being specified is not an angle then simply enter the required value.

If the column is an angle then the value can be entered as either a decimal value in radians or a sexagesimal value in hours or degrees, minutes and seconds. If a sexagesimal value is specified then the hours or degrees, minutes and seconds should be separated by a colon (’:’). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. An unsigned value is assumed to be in hours and a signed value in degrees (a negative angle cannot be specified in hours). That is, a positive angle in degrees must be preceded by a plus sign.

Examples: any of the following values could be entered to to specify an angle of 30 degrees:

2:00:00.0 hours (decimal point included in seconds) 2:00:00 hours (integer number of seconds)

$+$30:00:00.0 degrees (decimal point included in seconds) $+$30:00:00 degrees (integer number of seconds)

##### YMIN = DOUBLE (read)
Minimum Y value for the required rectangle.

If the Y column within which the minimum is being specified is not an angle then simply enter the required value.

If the column is an angle then the value can be entered as either a decimal value in radians or a sexagesimal value in hours or degrees, minutes and seconds. If a sexagesimal value is specified then the hours or degrees, minutes and seconds should be separated by a colon (’:’). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. An unsigned value is assumed to be in hours and a signed value in degrees (a negative angle cannot be specified in hours). That is, a positive angle in degrees must be preceded by a plus sign.

Examples: any of the following values could be entered to to specify an angle of 30 degrees:

2:00:00.0 hours (decimal point included in seconds) 2:00:00 hours (integer number of seconds)

$+$30:00:00.0 degrees (decimal point included in seconds) $+$30:00:00 degrees (integer number of seconds)

##### YMAX = DOUBLE (read)
Maximum Y value for the required rectangle.

If the Y column within which the minimum is being specified is not an angle then simply enter the required value.

If the column is an angle then the value can be entered as either a decimal value in radians or a sexagesimal value in hours or degrees, minutes and seconds. If a sexagesimal value is specified then the hours or degrees, minutes and seconds should be separated by a colon (’:’). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. An unsigned value is assumed to be in hours and a signed value in degrees (a negative angle cannot be specified in hours). That is, a positive angle in degrees must be preceded by a plus sign.

Examples: any of the following values could be entered to to specify an angle of 30 degrees:

2:00:00.0 hours (decimal point included in seconds) 2:00:00 hours (integer number of seconds)

$+$30:00:00.0 degrees (decimal point included in seconds) $+$30:00:00 degrees (integer number of seconds)

##### RACOL = CHARACTER (read)
Enter Right Ascension column from input catalogue.
##### DCCOL = CHARACTER (read)
Enter Declination column from input catalogue.
##### RACEN = CHARACTER (read)
The central Right Ascension.

The value may be specified as either a sexagesimal value in hours or a decimal value in radians. If the value is supplied as sexagesimal hours then the hours, minutes and seconds must be separated by a colon (’:’). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. A negative angle may be specified by preceding the value by a minus sign.

Examples: an angle of 10 hours, 30 minutes and 15.3 seconds may be specified by entering either of the following two values:

10:30:15.3 sexagesimal hours 2.7500062 radians

##### DCCEN = CHARACTER (read)
The central Declination.

The value may be specified as either a sexagesimal value in degrees or a decimal value in radians. If the value is supplied as sexagesimal degrees then the degrees, minutes and seconds must be separated by a colon (’:’). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. A negative angle may be specified by preceding the value by a minus sign.

Examples: a negative angle of 33 degrees, 30 minutes and 15.2 seconds may be specified by entering either of the following two values:

• 33:30:15.2 sexagesimal degrees

The value may be specified as either a sexagesimal value in minutes and seconds of arc or a decimal value in radians. If a sexagesimal value is supplied then the minutes and seconds of arc must be separated by a colon (’:’). Note that a colon must be present if the value is to interpretted as minutes of arc; if no colon is present it will be interpretted as radians. Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. A negative angle may be specified by preceding the value by a minus sign.

Examples: a radius of two minutes of arc may be specified by entering either of the following two values:

2:0 sexagesimal minutes of arc 5.8178E-4 radians

##### EQUINX = CHARACTER (read)
The equinox of the catalogue coordinates.

The equinox is specified as a time system followed by the value in that system in years. A single alphabetical character is used to identify each of the two time systems supported: B for Bessellian and J for Julian. Optionally decimal fractions of a year may be specified by including a decimal point followed by the required fraction.

Examples: J2000 Julian equinox 2000. B1950 Bessellian equinox 1950.

##### EPOCH = CHARACTER (read)
The epoch of the catalogue coordinates.

The epoch is specified as a time system followed by the value in that system in years. A single alphabetical character is used to identify each of the two time systems supported: B for Bessellian and J for Julian. Optionally decimal fractions of a year may be specified by including a decimal point followed by the required fraction.

Examples: J1996.894 Julian epoch of 1996.894. B1955.439 Bessellian epoch of 1955.439.

##### RAC = CHARACTER (read)
Enter the name of the Right Ascension column.
##### DECC = CHARACTER (read)
Enter the name of the Declination column.
##### PMRAC = CHARACTER (read)
Name of the proper motion in Right Ascension column (radians/year).
##### PMDEC = CHARACTER (read)
Name of the proper motion in Declination column (radians/year).
##### PLXC = CHARACTER (read)
Name of the parallax column (radians).
##### RVC = CHARACTER (read)
Name of the radial velocity column (Km/sec).

A positive value corresponds to an object which is red-shifted or receding and a negative value to one which is blue-shifted or approaching.

##### LABELC = CHARACTER (read)
Name of the column used to label objects on plots.
##### NOROWS = LOGICAL (read)
Flag indicating whether a selection which contains no rows is to be considered an error or not. Coded as follows: .TRUE. - consider an error, .FALSE. - do not consider an error (default). If NOROWS is set to .TRUE. then a selection with no rows will raise the status SAI__WARN.
##### TEXT = CHARACTER (read)
Flag indicating the textual header information to be copied to the output catalogues. The valid responses are: A - all; the output catalogue will contain a complete copy of the header information for the input catalogue, duplicated as comments, C - (default) copy only the comments from the input catalogue. In the case of a FITS table the COMMENTS and HISTORY keywords will be copied. N - none; no textual header information is copied.
##### QUIET = LOGICAL (read)
Operate in quiet mode where warnings are suppressed. The permitted values are: TRUE - quiet mode, FALSE - verbose mode.
##### NUMSEL = INTEGER (write)
Number of rows selected.

#### Examples:

catselect
The input and output catalogues and the type of selection required will be promted for. Additional prompts specifiy the details of the selection. Any comments in the input catalogue will be copied.
catselect text=all
The input and output catalogues and the type of selection required will be promted for. Additional prompts specifiy the details of the selection. All the header information in the input catalogue will be duplicated as comments in the output catalogue.
catselect text=none
The input and output catalogues and the type of selection required will be promted for. Additional prompts specifiy the details of the selection. Any comments in the input catalogue will not be copied.