This help page describes the input parameters available for
the GOODS cutout tool. The cutout tool allows users to
create a cutout image (in FITS format) from the GOODS data
sets based on
a target name or coordinates and a width in arcseconds.
Several qualifiers can be used to create image cutouts.
The tool can be used from either the HTML search form,
or as a Web service following the NVO SIAP cutout protocol.
Enter either a target name to be resolved by SIMBAD (by default)
or NED, or J2000 coordinates (RA and DEC separated by a comma).
An error message will be displayed if the position is outside the
region covered by GOODS.
The name resolver you want to use, if you want to resolve an object
into its coordinates. You can resolve an object name either before a
search, or you can redraw the form with the resolved coordinates in
place. You can also elect not to resolve the object name when doing
the search, and search the database on the object name instead.
The resolver services that may be chosen are NED and SIMBAD. NED is
the NASA Extragalactic Database at Caltech in Pasadena, California,
and SIMBAD is the Set of Identifications, Measurements, and
Bibliography for Astronomical Data at the Centre de Donn\351es
astronomiques in Strasbourg, France. The object name will be sent to
the chosen resolver, which will send back the coordinates. (If the
object name is not recognized by the resolver, or there is some other
problem with the SIMBAD or NED services, then the search form will be
redrawn with an error message at the top.) These coordinates will then
be used to search the database, along with whatever other query
qualifications you have given.
The width of the cutout region in arcseconds. The cutout
image is always square, so specifying a second parameter for the height
will be ignored. The default size is 5 arcseconds, and the maximum
size is currently set to 50 arcseconds.
The maximum number of cutout images to be generated. The
default is 50. (Note this currently applies to the file upload mode where
mulitple coordinates or targets can be specified in an uploaded file.)
The size (width) of the cutout in arcseconds.
Default = 5 arcsec. The maximum currently allowed
is 108 arcsec (0.03 degrees). Larger values will be
set to 108 arcsec. Note that no splicing of adjacent tiles is
The name of a local file containing a table or list of
parameters such as coordinates, targets names, or data IDs
to be uploaded to the server
and used to query the database. The file must be a plain ASCII text
file (e.g., not DOC or RTF files) with either one entry per line
(e.g., a target name, a Data ID,
or a set of coordinates), or a table separated with one
of the allowed delimiters, with targets, Data IDs, or RA and Dec values in the
designated columns. Note in either case, only one entry per line is
extracted. If, for example, a comma-separated list of target names
is downloaded in one line, only the value in the designated column
will be used.
For security reasons, there are many restrictions on file uploads.
If you have trouble please contact the help desk.
The search script will perform a separate cone search for each
extracted target name or set of coordinates contained in
the uploaded list, with a separate table of results for each.
Target names will be resolved to coordinates.
If a resolver error occurs with target names,
the search will abort and the compiled results displayed.
(Note unresolved target names are not considered an error.)
Coordinates may be given using sexigesimal notation or decimal degrees.
When Data IDs or Kepler IDs are specified, the results
are displayed in a single table.
If the output is requested in CSV or Excel spreadsheet
format, a blank line will be used to distinguish the results of
one cone search from another. VOTable format incorporates
separate RESOURCE tags for each cone search.
Use the other form entries to specify field delimiters,
RA, DEC, or Target column numbers (when the file contains a table
of values), and file contents (target names or coordinates).
The browse button allows users to seach local directories to
Warning: Since uploading long lists can take a while to run,
uploaded files are limited to 10,000 entries.
Specifies the contents of the local file to be uploaded.
The current choices are:
coordinates, target names, and Data IDs (or
for Kepler missions, Kepler IDs).
If "target name", or "coordinates" are specified,
each entry is treated as a
separate query. The results are displayed as each query is run. If
however "Data IDs" or "Kepler IDs" is specified, (up to 10,000 are allowed),
it is processed as a single query
(e.g., select * where data_id in (ID1,ID2,...).
Recently, Simbad has started adding Kepler IDs to its list of resolvable
This means that for Kepler (and perhaps eventually K2), an uploaded list
of IDs can be
treated as either "Target Names", which generate a set of cone searches,
or "Kepler IDs", which creates a single search result based on found IDs.
The advantage to the latter search is that all the search results are listed in
one table, and can be submitted for retrieval in one click.
To avoid displaying column names after each target name or coordinate
query, consider using the comma-separated values output format.
Also keep in mind that not all target names are resolvable. For example,
SIMBAD currently does not reolve most 2MASS IDs.
The column number containing either the Data ID, Right Ascension (decimal degrees or
sexagesimal), or target name (depending on how file_contents is set).
The default is to assume the first column is to be used.
For forms allowing coordinates as input, the
column number containing the Declnation (decimal degrees or sexagesimal).
The default is to assume the second column contains the DEC value.
If the file contents is set to Target Name or any Data ID, this
parameter is ignored.
The character used to delimit table entries in the uploaded
file. Allowed values include tabs( ), commas(,), vertical bar (|),
The default is to assume tabs are the delimiters.
If the file contains only a single column, use tabs as the delimiter.