Help Page for the Advanced Voyager Image Catalog 1.1

The Advanced Voyager Image Catalog makes it possible to select images from the PDS CDROMs based on a broad variety of constraints, including constraints on the geometric content of an image. For example, you may quickly identify all the Voyager 2 Uranian ring images for which the filter was CLEAR or BLUE, the exposure time was at least 15 seconds, and the phase angle was less than 40 degrees. 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 images that match the constraints you have entered.

Change History

1.0 (November 16, 1999) Original advanced query 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 Advanced Voyager Image Catalog makes it possible to select images from the PDS CDROMs based on a broad variety of constraints. You can accomplish this by entering 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 Voyager images on the CDROMs that match the constraints entered.

The numerous fields on this form permit the user to enter many different kinds of constraints. In most cases, 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 images from the Voyager 1 encounter. However, selecting values within the same group of parameters results in an "or" operation. For example, if you select Jupiter Targets=IO and then select Jupiter Targets=EUROPA in the next column, you will find all the images of either Io or Europa. If you leave a field blank, that particular parameter is unconstrained. Because the form has so many fields, it is very common for most of them to be blank.

The upper half of the query form lets you constrain parameters that also appear on the standard Voyager query form. The lower half contain additional parameters to constrain the viewing geometry, lighting geometry, timing, and wavelength range of the image.

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 images in the database but does not return a list. A Summary listing returns a table of the matching images in addition to the match count. This is the default. A summary listing can return up to 1000 images at a time. A Detailed listing returns a detailed summary of every parameter for each matching image, in addition to the match count and summary listing. A detailed listing can return up to 100 images at a time. If you exceed the image limit for either a summary or detailed listing, you can see the remaining images by entering a number of images 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

A detailed listing returns a list of file names, which are active links to copies of the CDROMs on line at the Rings Node.

The Voyager image CDROM containing a particular Voyager image can be determined by examining the Compressed image field of a detailed listing. The full directory path is shown, beginning with the CDROM volume ID of the form VG_00xx.

Alternatively, you may simply email a request to Neil Heather. We can also fill requests for limited numbers of images 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 images in the database but does not return a list. A Summary listing returns a table of the matching images in addition to the match count. A Detailed listing returns a detailed summary of every parameter for each matching image, in addition to the match count and summary listing.

Match Count

When the Match Count listing type is selected, the user only sees the number of unique images 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 images. This is the most common type of query and serves as the default. Only the most often used parameters of each image are listed; if the user needs more information, repeat the same query while requesting a Detailed listing. The parameters included in a Summary listing are the Query record, FDS count, planet, spacecraft, camera, nominal target, filter, exposure time, scan rate, shutter mode and ring information flag.

In a summary listing, you can click on the FDS count to see a 200x200 preview of the image.

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 images.

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 image. 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.

In a detailed listing with the previews option turned on, a 200x200, pre-stretched image appears with each entry. With the option turned off, you can click on "[PREVIEW]" following the Query record number to see the preview image.

Note that a Detailed listing query is limited to 10 matches if the previews option turned on, or 100 if it is turned off. If more matches are found, only the first 10 or 100 will be shown. The Match Count section will list both the number of matches found and the (possibly smaller) number listed. The user can repeat the query with a number entered into the Skip the first _____ matches field in order to see the additional images.

Return to the index.


Include previews

If this option is turned on ("Yes"), a 200x200, pre-stretched thumbnail preview image is included with each entry in the detailed listing. Also, this option overrides a Summary listing, converting it to a Detailed listing. This option is ignored for Match count listing. With this option, the number of images returned from any query is limited to 10.

If this option is turned off ("No"), links to the thumbnail preview images are still available via links from the summary and detailed listings.

Return to the index.


Skip the first _____ matches

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

Return to the index.


GLOSSARY

Anomaly

The Anomaly value indicates whether spurious values may exist in the image. Possible values are NONE and RAMCOR. A value of NONE indicates that no anomalies were detected; a value of RAMCOR indicates that spurious values exist in the image data due to corruption of the random access memory onboard the spacecraft.

The user may select images with a particular value of Anomaly using the field of this name on the query form. The value is only shown in a detailed listing. Anomaly is also known as "data_anomaly_type" in the database and on the CD-ROMs.

Return to the index.


Browse Image

The Voyager image CDROMs contain a small but uncompressed version of each image, called a browse image. Browse images provide a quick, easy-to-display glimpse of the image if the user is unsure whether to uncompress the full image. This field gives the name of the browse image file on the CDROM in, in a Unix-style format. More information about browse images can be found here.

The Browse image name cannot be constrained as a part of a query. Its value is only shown only on a detailed listing. Note that some images are duplicated on the CDROM set, so this field occasionally takes on multiple values. The value is constructed from the "browse_volume_id" and "browse_file_name" columns of the database, and is converted to a Unix format for display. This field is blank for images not yet available on CDROM.

If the image is available on a CDROM, then the value of Browse image serves as a link to the data file.

Return to the index.


Compressed Image

The Voyager images are stored on the CDROMs in a compressed format. This field gives the name of the compressed image file on the CDROM in, in a Unix-style format. More information about compressed images can be found here.

The Compressed image name cannot be constrained as a part of a query. Its value is only shown only on a detailed listing. Note that some images are duplicated on the CDROM set, so this field occasionally takes on multiple values. The value is constructed from the "image_volume_id" and "image_file_name" columns of the database, and is converted to a Unix format for display. This field is blank for images not yet available on CDROM.

If the image is available on a CDROM, then the value of Compressed image serves as a link to the data file.

Return to the index.


Edit Mode

Some Voyager images were read out of the camera vidicon in an edited manner, which means that not the entire 800x800 array of pixels was read. The Edit mode parameter describes how the data was read. Possible values are 1:1 (corresponding to the full image array), 3:4, 1:2, 1:3, 1:5, and 1:10.

A single edit mode can be selected in the Edit mode field on the query form; if the field is left blank, images of all edit modes are returned. The value of the Edit mode is only shown on detailed listings. This parameter is also known as the "edit_mode_id" in the database and on the CDROMs.

Return to the index.


Earth Received Time

The Earth received time gives the time UTC at which the given image was received on Earth.

The Earth received time cannot be constrained as a part of a query. Its value is only shown only on a detailed listing. It is also known as "received_time" in the database and on the CDROMs.

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 images of a lit ring face and between 90 and 180 for images of an unlit face. A single value of emission angle is associated with each ring image, even though the value can vary slightly within an image.

In queries, you may specify a numeric range for the emission angle. Only images 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.


Event Time

The Event time gives the time UTC at which the given image was acquired by Voyager.

The Event time cannot be constrained as a part of a query. Its value is only shown only on a detailed listing. It is also known as "image_time" in the database and on the CDROMs.

Return to the index.


Exposure Time

Exposure time is the time interval between the opening and closing of the camera shutter, in seconds.

On the query form, the user may enter values for a minimum and a maximum exposure time, and only those images with exposure times between the two values (inclusive) are returned. If the first field is left blank, a minimum of zero is assumed; if the second is left blank, the maximum exposure time is effectively infinite.

On a summary listing, the exposure time is listed under the Texp heading. The value is also included on the detailed listing. Exposure time is also known as "exposure_duration" in the database and on the CDROMs.

Return to the index.


FDS Count

The "Flight Data Subsystem" or FDS clock generates a unique number for each Voyager image within a single encounter. Voyager images are quite often identified by this number. The FDS count is of the form "nnnnn.nn" where the leading digits fall between 00000 and 65535 and the trailing digits fall between 00 and 59. Leading zeros should always be included for values less than 09999.59.

On the query form, the user may enter values for a minimum and a maximum FDS count, and only those images with identifiers between the two limits (inclusive) are returned. If the first field is left blank, a minimum of 00000.00 is assumed; if the second is left blank, the maximum of 65535.59 is assumed. FDS count is also known as "image_number" in the database and on the CDROMs.

The FDS count is included in the summary and detailed listings. In a summary listing, the FDS count is a link to a 200x200, pre-stretched thumbnail preview of the image.

Return to the index.


Filter

Voyager images were captured through a variety of color filters. Possible values are CLEAR, CH4_U, CH4_JS, UV, VIOLET, BLUE, GREEN, ORANGE, and SODIUM. More detailed information about the filters for each camera can be found here.

On the query form, the user may select up to three different color filters, and only images taken through one of these filters are returned, as if an "or" operation were being performed. The filter name and also its number (0-7) are listed on both the summary and detailed listings. Within the database and on the CDROMs, the filter is also known by "filter_name" and "filter_number".

Note that you can also select images by wavelength range.

Return to the index.


Gain Mode

The Gain mode identifies the gain state of the Voyager cameras. Gain determines the factor that multiplies an instrument's output signal to increase or decrease the output level. For the Voyager cameras, the valid values are LOW and HIGH.

The Gain mode cannot be constrained on the query form. Its values is shown on a detailed listing only. Gain mode is also known as "gain_mode_id" in the database and on the CDROMs.

Return to the index.


Image ID

The Image ID is a unique identification for each Voyager image. It takes the form "nnnnes+ddd" where

The Image ID cannot be constrained on the query form. Its value is only shown in a detailed listing.

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 image.

In queries, you may specify a numeric range for the incidence angle. Only images 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

Voyager carried two cameras, called the WIDE_ANGLE_CAMERA and the NARROW_ANGLE_CAMERA. More information about the Voyager cameras can be found here.

The Instrument field on the query form enables the user to select images from only one of the two cameras. If the field is left blank, images taken by both cameras are returned. In a summary query, the instrument is listed under the Camera column with a value abbreviated to either WIDE or NARROW. The full Instrument name is shown in a detailed listing.

Return to the index.


Is Ring Data?

In the Rings Node catalog, observations are flagged as ring observations if any piece of the planet's ring plane (extended out to infinity) was observed. Possible values are YES and NO.

In queries, use the ring data only? field to specify whether the query should include ring data only or any image that satisfies the specified constraints. Note that the ring radius and radial resolution parameters are undefined for images in which this field has the value NO.

Return to the index.


Mask

Mask specifies a string of bits showing which are active in each image sample. Allowed values are 11111111 (meaning all bits are active) and 11111110 (meaning the least significant bit is not valid).

Mask cannot be constrained on the query form. Its value is only shown on a detailed listing. It is also known as "sample_bit_mask" in the database and on the CDROMs.

Return to the index.


Mission Phase

The Mission phase indicates the portion of a Voyager mission surrounding a particular planetary encounter. Possible values are JUPITER_ENCOUNTER, SATURN_ENCOUNTER, URANUS_ENCOUNTER and NEPTUNE_ENCOUNTER. More detailed information about the mission phases can be found here.

The Mission phase does not appear on the query form but the equivalent functionality is provided by the Planet field. The value of this field is included on the summary listing under the header Planet, with values of JUPITER, SATURN, URANUS or NEPTUNE. The Mission phase appears on the detailed listing. It is known as the "mission_phase_name" in the database and on the CDROMs.

Return to the index.


Note

The Note field contains a brief textual description of the image.

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 images you are interested in, you can select the images 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. Images are associated with two different times, indicating when the camera's shutter opened and when it closed. 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 images 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.


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 image, even though the value can vary slightly within an image.

In queries, you may specify a numeric range for the phase angle. Only images 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 Voyager encounter. Possible values are JUPITER, SATURN, URANUS and NEPTUNE. More detailed information about these phases of the Voyager mission can be found here.

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, images from all four planets will be listed. The value of this field is included on both the summary and detailed listings. In the detailed listing, it is actually indicated by the Mission phase, with values of JUPITER_ENCOUNTER, SATURN_ENCOUNTER, URANUS_ENCOUNTER and NEPTUNE_ENCOUNTER. It is also known as the "mission_phase_name" in the database and on the CDROMs

Return to the index.


Query Record

The Query record is a temporary identifier for each of the matching images found by the most recent query. Values range from 001 to the total number images 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 image.

When the previews option is off, "[PREVIEW]" appears following the Query Record in the detailed listings, and this serves as a link to a 200x200, pre-stretched thumbnail preview of the image.

Return to the index.


Radial Resolution

The radial resolution gives the radial size of ring plane features that can be detected in a given image, in km. Two values are associated with each ring image, 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 image, as projected into the ring plane.

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

Return to the index.


Ring Data Only?

In the Rings Node catalog, images are flagged as ring observations if any piece of the planet's ring plane (extended out to infinity) was observed. Possible values are YES and NO. Note that the ring radius and radial resolution parameters are undefined for images in which this field has the value NO.

In queries, select YES if you only want images 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 image left the ring plane. Ring images 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 images 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 Information

The Ring information parameter indicates whether additional information about this image (e.g. geometric parameters) appears elsewhere in the Rings Node catalog. Valid values are YES and NO.

The Ring information parameter does not appear on the query form. The value of this field is included on the summary listing under the header Ring?, and also in the detailed listing.

Return to the index.


Ring Observation ID

The Ring observation ID is used by the Rings Node as a unique identifier for data in the catalog. For Voyager images it has the form "p/IMG/VGk/ISS/nnnnn.nn/c" where

The Ring observation ID cannot be constrained on the query form and its value is only shown on a detailed listing.

Any Ring observation ID in an output listing serves as a link to a page containing an image 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 image. Units are km. A pair of values specifying the minimum and maximum are associated with each ring image. Because of possible pointing errors in spacecraft images, 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 image.

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

Return to the index.


Scan Mode

Scan mode describes the rate at which the Voyager camera vidicon was read out after an image was exposed. This parameter affects the properties of an image, in particular the amount of "dark current" present in the image. Possible values are 1:1, 2:1, 3:1, 5:1, and 10:1.

On the query form, the user may specify a single value for the scan mode, and only images with that value are returned. If the field is left blank, images with any scan rate are returned. The value for scan rate appears in a summary listing under the Scan heading, as well as in the detailed listing. Scan mode is also known as "scan_mode_id" in the database and on the CDROMs.

Return to the index.


Shutter Mode

The Shutter mode parameter the type of shutter operation performed by the Voyager camera. Possible values are: The Shutter mode field on the query form lets the user select images with a particular value of this parameter; if it is left blank, then images of all shutter modes are returned. The value appears on a summary listing under the Shutter heading; it also appears on a detailed listing. The Shutter mode is also known as "shutter_mode_id" in the database and on the CDROMs.

Return to the index.


Spacecraft

The Spacecraft parameter indicates which spacecraft captured a given image. Valid values are VOYAGER_1 and VOYAGER_2. More detailed information about the Voyager spacecraft can be found here.

The Spacecraft field on the query form enables the user to select images from only one of the two Voyagers. If the field is left blank, images taken by both Voyagers are returned. In a summary listing, the spacecraft appears under the Vgr heading with a value abbreviated to 1 or 2. The full spacecraft name is shown in a detailed listing. Spacecraft is also known as "spacecraft_name" in the database and on the CDROMs.

Return to the index.


Target

The Target parameter indicates the nominal target of each Voyager image. Note that an image can contain multiple objects but each image is cataloged with only a single nominal target. As a result, this parameter is not 100% reliable. For example, seekers of Saturn ring images should always consider images targeted at SATURN as well as those targeted at S_RINGS.

Because of the large number of possible targets, the query form divides the target selections into groups under Jupiter, Saturn, Uranus, Neptune, and Other.

Any combination of targets may be selected; they are combined in the query via an "or" operation.

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 image.

In queries, you can specify a range of wavelength values, and the query will return any images whose range of wavelengths intersect the range requested. Note that you can also select images by filter name.

Return to the index.


Query Form | Data Catalog | Rings Node Home

Last update 8 December 2000

Mark Showalter