Help Page for the General Ring Data Catalog 1.1

The General Ring Data Catalog makes it possible to select ring data sets of all types based on a variety of geometric constraints. For example, you may quickly identify all the data sets that resolve a particular section of a ring system at radial resolution of finer than 10 km. You accomplish this by entering the appropriate values into the fields you see on the form and then clicking on the Submit Query button at the bottom of the page. After a short wait, you will see a listing of all the ring observations that match the constraints you have entered.

The Rings Node catalogs data at the level of a "ring observation," which is typically a single image, occultation profile or spectrum. Note that a single ring observation may correspond to more than one data file; for example, Voyager images are archived both in compressed and in uncompressed "browse" format. In this case, two different files would correspond to the same ring observation. On the other hand, a single image from from the Wide Field/Planetary Camera on HST contains four different images, each with its own field of view and spatial resolution. In this case, four different ring observations are archived in a single file.

Change History

1.0 (July 8, 1997) Original general catalog form on line.
1.1 (December 8, 2000) Any
ring observation ID in an output listing now serves as a link to a page containing an image preview and more information about the data, plus links to the data files.

INDEX

Query Options

Glossary


INSTRUCTIONS

The General Ring Data Catalog makes it possible to select ring data sets of all types based on a variety of geometric constraints. For example, you may quickly identify all the data sets that resolve a particular section of a ring system at radial resolution of finer than 10 km. You accomplish this by entering the appropriate values into the fields you see on the form and then clicking on the Submit Query button at the bottom of the page. After a short wait, you will see a listing of all the ring observations that match the constraints you have entered.

The fields on this form permit the user to enter many different kinds of constraints. Entering values in different fields results in an "and" operation. For example, if you select Planet=SATURN and Spacecraft=VOYAGER_1, you will see all the Saturn data from the Voyager 1 encounter. If you leave a field blank, that particular parameter is unconstrained. Since there are so many fields on the form, it is very common for most of them to be blank.

Use the Listing type box near the bottom of the page to choose among three possible ways to display the results of a query. Match Count simply counts the number of matching ring observations in the database but does not return a list. A Summary listing returns a table of the matching ring observations in addition to the match count. This is the default. A summary listing can return up to 1000 observations at a time. A Detailed listing returns a detailed summary of every parameter for each matching observation, in addition to the match count and summary listing. A detailed listing can return up to 100 observations at a time. If you exceed the limit for either a summary or detailed listing, you can see the remaining observations by entering a number to skip over into the Skip box.

Once you made your selections, click on the Search Catalog button at the bottom of the page to submit your query. If at any time you wish to erase all of your entries in the form and start over, click on the Reset Form button.

Ordering Data

The ordering of ring data is not currently integrated into this catalog. You may email a request for data to Neil Heather. We can fill requests CDROMs or for limited sets of data by electronic transfer.

Return to the index.


QUERY OPTIONS

Listing type

Three listing types are supported. A Match Count simply counts the number of matching ring observations in the database but does not return a list. A Summary listing returns a table of the matching observations in addition to the match count. A Detailed listing returns a detailed summary of every parameter for each matching observation, in addition to the match count and the summary listing.

Match Count

When the Match Count listing type is selected, the user only sees the number of unique ring observations in the database that match the given constraints.

Query listings always begin with a summary of the SQL query and the options selected, followed by the number of matches. SQL is the language used by the database; you do not need to understand it but, if a query fails, please report this text to the Rings Node to help us to diagnose the problem.

Summary listing

When the Summary listing type is selected, the user sees the typical Match Count listing followed by a table of the matching observations. This is the most common type of query and serves as the default. Only the Query record and Ring Observation ID are listed; if the user needs more information, repeat the same query while requesting a Detailed listing.

Note that a Summary listing query is limited to 1000 matches. If more matches are found, only the first 1000 will be shown. The Match Count section will list both the number of matches found and the (possibly smaller) number listed in the table. The user can repeat the query with a number entered into the Skip the first _____ matches field in order to see the additional observations.

Detailed listing

When the Detailed listing type is selected, the user sees the typical Match Count listing and Summary listing first. Following is a list of every database parameter for each matching ring observation. In addition, the Summary listing section has active links to each section of the Detailed listing; simply click on the record number in the summary to jump to the detailed information.

Return to the index.


Skip the first _____ matches

The number of matches returned from a query is limited to 1000 for a summary listing and 100 for a detailed listing. The user can view additional matches via the Skip the first _____ matches option. Just repeat the query with a number entered into this field, and that number of matches will be skipped. For example, a value of 100 will mean that matching observations 101-200 will be shown on a detailed listing (or 101-1100 on a summary listing).

Return to the index.


GLOSSARY

Data Set ID

The data set ID is a unique, PDS-wide identifier for a data set. These IDs are constructed according to standards described in Chapter 6 of the PDS Standards Reference. For example, "VG1/VG2-S-ISS-2-EDR-V1.0" is the ID for the Voyager image data set at Saturn.

In queries, four different types of matches are permitted:

Return to the index.


Earth Base

The Earth base is the name of the ground-based observatory at which the observation was acquired.

In queries, you may select an Earth base out of the given list or choose "none" to restrict your query to spacecraft data.

Return to the index.


Emission Angle

The emission angle is the angle between the ring surface normal vector (on the lit face) and the line of sight to the observer, in degrees. Values range between 0 and 90 for observations of a lit ring face and between 90 and 180 for observations of an unlit face. A single value of emission angle is associated with each ring observation, even though the value can vary slightly within an observation.

In queries, you may specify a numeric range for the emission angle. Only observations for which the angle is greater than or equal to the first value and less than or equal to the second will be returned.

Return to the index.


Incidence Angle

The incidence angle is the angle between the ring surface normal vector and the direction to the light source, in degrees. Values range between 0 and 90. A single value of incidence angle is associated with each ring observation.

In queries, you may specify a numeric range for the incidence angle. Only observations for which the angle is greater than or equal to the first value and less than or equal to the second will be returned.

Return to the index.


Instrument

The instrument is the name of the instrument used for an observation, typically abbreviated.

In queries, you may select the name of the instrument if you only want observations from a single instrument returned. If you leave the field blank, observations from all instruments will be returned.

Return to the index.


Ring Target?

In the Rings Node catalog, observations are flagged as ring targets if the intended target of the observation was a ring. Possible values are YES and NO. For purposes of cataloging, observations of the planet Saturn are treated as having a ring target, because so many Saturn images also show rings. However, this is not the case for observations of Jupiter, Uranus or Neptune.

In queries, use the ring targets only? field to specify whether the query should include data specifically targeted at a planetary ring system, or else any observation that satisfies the specified constraints.

Return to the index.


Note

The note field often contains a brief textual description of the obnservation.

On the query form, you may enter a variety of different constraints on the note field. The common theme is that you use these constraints to match text in the field. For example, if you have reason to believe that "F RING" appears in the note field for the observations you are interested in, you can select the observations whose notes contain this text. Simply enter the text you wish to match in the field, without quotes. Note that the search is not case-sensitive.

Four different types of matches are permitted:

Return to the index.


Observation Time

The observation time gives the time UTC at which the given observation was obtained, as measured at the instrument. Ring observations are associated with two different times, indicating when the observation began and when it ended. Times are given by default in PDS format, of the form "yyyy-mm-ddThh:mm:ss.sss". Note that the observation time differs from the ring event time because of light travel time.

In queries, you can specify a range of observation times, and the query will return any observations that were being carried out during the interval given. Times can be entered in a broad range of formats; click here for the gory details.

Return to the index.


Observation Type

The observation type gives the category of the ring observation. Possible values include IMAGE, SPECTRUM and OCCULTATION.

In queries, you can select a particular type from the given list, and only observations of that type will be returned. If you leave the field blank, all observation types will be returned.

Return to the index.


Phase Angle

The phase angle is the angle between the direction to the light source and the direction to the observer, in degrees. Values range between 0 and 180. A single value of phase angle is associated with each ring observation, even though the value can vary slightly within an observation.

In queries, you may specify a numeric range for the phase angle. Only observations for which the phase angle is greater than or equal to the first value and less than or equal to the second will be returned.

Return to the index.


Planet

The planet indicates the central body for a particular observation. Possible values are JUPITER, SATURN, URANUS and NEPTUNE.

Using the planet field on the query form, the user can specify which of the four planets is of interest. This is probably the common field on the form to constrain. If it is left blank, observations of all four planets will be listed.

Return to the index.


Query record

The query record is a temporary identifier for each of the matching observations found by the most recent query. Values range from 001 to the total number observations found.

Note that the query record number counts all matching records, regardless of the particular query options selected. For example, if the user has chosen to skip the first 100 matches, then query record values on the listing will begin with 101.

Query record values appear as the first column in a summary listing, under the heading #. When a detailed listing is requested, each # in the summary table serves as a hypertext link to the detailed information for the same observation.

Return to the index.


Ring Data Only?

In the Rings Node catalog, observations are flagged as ring targets if the intended target of the observation was a ring. Possible values are YES and NO. For purposes of cataloging, observations of the planet Saturn are treated as having a ring target, because so many Saturn images also show rings. However, this is not the case for observations of Jupiter, Uranus or Neptune.

In queries, select YES if you only want observations flagged as ring observations to be returned. Select NO if this flag should be ignored in the query.

Return to the index.


Ring Event Time

The ring event time gives the time UTC at which the photons associated with a given observation left the ring plane. Ring observations are associated with two different times, indicating when the first and last observed photons left the ring. Times are given by default in PDS format, of the form "yyyy-mm-ddThh:mm:ss.sss". Note that the ring event time differs from the observation time because of light travel time.

In queries, you can specify a range of ring event times, and the query will return any observations corresponding to the interval given. Times can be entered in a broad range of formats; click here for the gory details.

Return to the index.


Ring Observation ID

The ring observation ID is a unique identifier used by the Rings Node to specify a ring observation. The ID consists of a sequence of fields separated by slashes, as follows: Here Using this standard, the user can typically glance at a ring observation ID and know fairly quickly what data it refers to.

In queries, you may select observations whose IDs match a particular pattern. Four different types of matches are permitted:

Any Ring observation ID in an output listing serves as a link to a page containing a preview and more information about the data, plus links to the data files.

Return to the index.


Ring Radius

The ring radius gives the range of distances from the center of the planet, measured in the ring plane, detected in a given observation. Units are km. A pair of values specifying the minimum and maximum are associated with each ring observation. Because of possible pointing errors in spacecraft image or spectrum, the values derived tend to be slightly "conservative," meaning that a given is radius in not guaranteed to actually fall within an image. However, this provides a very useful guide to what is likely to fall within an observation.

In queries, you can specify a range of ring radius values, and the query will return any observations whose range of radii intersect the range requested.

Return to the index.


Radial Resolution

The radial resolution gives the radial size of ring plane features that can be detected in a given observation, in km. Two values are associated with each ring observation, specifying the finest and the coarsest resolution within the data.

The radial resolution is the typically equal to the intrinsic point spread function of the data, as projected into the ring plane. For spectra or other data sets that have no intrinsic spatial resolution, it is equal to the difference between the maximum and minimum ring radius values.

In queries, you can specify a range of radial resolution values, and the query will return any observations whose range of radial resolutions intersects the range requested.

Return to the index.


Spacecraft

The spacecraft parameter indicates which spacecraft acquired a given observation. Valid values are VOYAGER_1, VOYAGER_2, GALILEO, HUBBLE_SPACE_TELESCOPE, etc. The value is none for Earth-based observations.

In queries, you may select the spacecraft from the given list and only observations from that spacecraft will be returned. Leave the field blank if you do not wish to constrain the search in this manner. Select none to return only Earth-based observations.

Return to the index.


Wavelength

The wavelength gives the range of wavelengths observed, in microns. A triplet of values specifying the mean, minimum and maximum are associated with each ring observation.

In queries, you can specify a range of wavelength values, and the query will return any observations whose range of wavelengths intersect the range requested.

Return to the index.


Wavelength Resolution

The wavelength resolution gives the size of the wavelength intervals associated with an observation, in mocrons. For single-wavelength observations, this parameter is equal the difference between the maximum and minimum wavelength values associated with the observation.

In queries, you may specify a numeric range for the wavelength resolution. Only observations for which the resolution is greater than or equal to the first value and less than or equal to the second will be returned.

Return to the index.


Query Form | Rings Node Catalog | Rings Node Home

Last updated 8 December 2000