Thursday, October 31, 2019

OPUS Updates for October 2019 - Citing OPUS and QR Codes

We have some major improvements coming in the next month, but this month we have a simple one for you - information on how to cite OPUS in your presentation, poster, or paper.

How to Cite OPUS (and QR Codes!)

The Help menu now has a new option: Citing OPUS. This new help page gives you information on how to cite OPUS in your presentation, poster, or paper, as well as a copy of the NASA PDS logo for your use. Finally, it includes customized QR codes for your poster or presentation that directly link to OPUS, your current search in OPUS, or your entire current state in OPUS (including which tab and observations you're looking at, etc.). Note that it does not include the contents of your cart. This is a perfect way to share your search with audience members in a way that they can easily reproduce.

As always, keep those suggestions and comments coming!

Monday, September 30, 2019

OPUS Updates for September 2019 - Preprogrammed Ranges

This month we are pleased to bring you a new feature that aids in searching on ring radius or wavelength.

Preprogrammed Ranges

Users often need to search for standard ranges for ring radius, such as the inner and outer limits of Saturn's A ring or the semimajor axis of Enceladus. A similar problem occurs for wavelength; a user may wish to search for "blue" images but have to look up exactly what wavelengths that corresponds to. Both of these problems are now solved by the existence of preprogrammed ranges. When you click on the "Min" input box of the Observed Ring Radius field (available under Ring Geometry Constraints), a dropdown box will appear with a large selection of satellite semimajor axes and ring limits for Jupiter, Saturn, Uranus, and Neptune. Simply clicking on one of these options will fill in both the minimum and maximum value:

Alternatively, you may start to type the name of a feature, and the list of options will be limited to those that contain the string you've typed:

If only a single result is left, hitting ENTER will automatically fill in the values.

A similar feature is available for the Wavelength field, with colors taken from the PDS4 dictionary, CRC, and Johnson UBV filters.

As always, we welcome your feedback.

Friday, August 30, 2019

OPUS Updates for August 2019 - Cart Improvements

This month we are pleased to bring you a number of updates to the cart and the selection of observations to put in the cart.

Selecting Ranges

There are several ways to select ranges of observations to put in the cart, or remove from the cart. To indicate the beginning of the range you can shift+click on a thumbnail or table row, or select "Start add range to cart here" or "Start remove range from cart here" from the hamburger menu at the bottom of each thumbnail or on the left side of each table row. If the observation you are starting with is not currently in the cart, you will be starting an "add range" operation; if the observation is already in the cart, you will be starting a "remove range" operation. To end the range, you either shift+click on a second observation, or select "End add range to cart here " or "End remove range from cart here", as appropriate.

To help you keep track of where the range started, the starting thumbnail or table row will show a flashing green square. In addition, there is now a small window in the lower left corner of the gallery or table views that gives you the relevant information. Then you can scroll away, or use the slider to jump much further away, and still know that you are in the middle of a range select operation and where that range started.

Details about Products Available for Download

The Cart tab now shows complete information about the data products available for download. For each product type (such as "Raw image"), you are given the number of observations in the cart that are providing that product type, the number of files (including data files, label files, and support files) that will be included in the archive, and the total size of those files. You may (de)select individual product types, entire categories, or all product types to limit the download to just those products you need. As you make your selections, the "Total Size" and "Total Files" fields at the top will update.

New Location for Download Links

When you select Download Data Archive or Download URL Archive, a special window will pop up in the lower right corner showing the link to use for the current download, plus a history of previous downloads you have requested during this session. You may toggle the presence of this window by clicking on the Download History button at the bottom (or dismiss it using the X in the corner) and you can remove all the links from the history by clicking the Clear All button. Click on one of the links to start the actual download operation in your browser.

Please keep those suggestions coming!

Tuesday, July 30, 2019

OPUS Updates for July 2019

This month we are pleased to bring you a number of features requested by our users (that's you!). As a reminder, feedback is always welcome and encouraged, and we put a high priority on implementing requests or fixing bugs that are affecting our users.

Create a New Search Based on an Existing Observation

  1. Using whatever method you like, find an observation that you are interested in.
  2. Display that observation in the Detail tab. There are two easy ways to do this: you can either hover your mouse over the thumbnail and click on the icon in the mini toolbar, or you can click on the "hamburger" menu and then select Show detail.

  3. On the Detail tab you will find a magnifying glass search icon next to every metadata field that contains a string or a multiple-choice value (indicated by checkboxes on the Search tab).
  4. Clicking on a search icon will create a new OPUS in a separate browser tab. This OPUS will contain exactly one search term: the particular metadata field you selected equal to the value for the observation you were looking at. For example, for the observation selected above:

    If you click on the magnifying glass next to "Observation Name: ISS_045RI_RDCOLSCNB001_PRIME" you will get a new OPUS with that single search:

Slider Now Available on Cart Tab

The new slider, which allows you to quickly position the thumbnail gallery or metadata table to a specific place in the result set, is now available on the Cart tab. This helps you more easily browse through the items in your cart if you have added hundreds or thousands of observations. We have also slightly reorganized the navigation buttons on the Cart tab, allowing you to more easily find those that will download your cart data. Look for many more improvements to the cart in a future release.

You Can Print Help Documents

All of the Help documents (such as the Getting Start Guide, the FAQ, and the API Guide) now include a button that will open the document in a new browser tab. At that point you can print the document to your printer or to a PDF file for future use. This is especially useful for the API Guide, which you can use as a reference while writing your own software to access the OPUS API.

Select Metadata Dialog Now Includes Help

The Select Metadata dialog now includes instructions for use:

Please keep those suggestions coming!

Thursday, June 13, 2019

Announcing the Release of OPUS3!

The Ring-Moon Systems Node of NASA's Planetary Data System is proud to announce the public release of OPUS3, commemorating the 10th anniversary of OPUS.

This new version of OPUS has been under development for the past 12 months, and features a modern look-and-feel, responsive design for desktop, laptop, tablet, and mobile devices, easier-to-use interface, improved documentation, and faster back-end server.

There are too many changes to OPUS to list here, but there are two guides available to help you transition to the new interface, both available under the new Help menu:
  • The Frequently Asked Questions (FAQ) section. In there you can click on What's new in OPUS3? for a brief discussion of the differences between the previous version of OPUS and this new release.
  • The Getting Started guide. This is a more comprehensive presentation of all of the major features in OPUS3.
Whether you are a new user or have been using OPUS since its initial release in 2009, we strongly encourage you to read through the Getting Started guide. There are likely many features of OPUS that you never knew existed.

As always, we welcome and encourage feedback. You can submit comments or questions through the Questions/Feedback link at the top of the OPUS3 screen, or you can contact us on Twitter at @pdsopus.

You can try it out here. We hope you enjoy the new version of OPUS!

Monday, February 11, 2019

OPUS Updates to Product Downloading

We have recently added two new features to make downloading of data products easier. First, a reminder about how to use our download system:

  1. After refining your search criteria, browse the thumbnail gallery by clicking on the "Browse Results" tab.
  2. When you find an observation you want to save, click on the checkmark in the little toolbar at the bottom of the thumbnail.
  3. Once you've selected all of the observations you care about, click on the "Selections" tab.
  4. You will see the total size of the data products that will go into the zip file you can download. You will also see a list of product types that you can select or deselect to control what goes in your zip file.
  5. There are now three options for how to download data:
    1. Download CSV of Chosen Columns - This will create a single CSV file that has one row for each observation and one column for each metadata field you have selected using "Choose Columns". No actual data will be downloaded, only a list of metadata.
    2. Download Zipped Data Archive - This will create a ZIP file that you can download separately. The ZIP file contains all of the data products for the observations you chose. It also includes a file containing product checksums, a manifest, and the same CSV file discussed above. Finally, it includes a new file, urls.txt, discussed below.
    3. Download Zipped URL Archive - This will create a ZIP file that is the same as the one above, but with no actual data products. It will only include the checksums, manifest, CSV, and URLs files.
The new urls.txt file solves the problem of downloading huge amounts of data when it is impractical to put all the data into a single ZIP file. urls.txt simply contains a list of URLs for all data products for all observations you selected, using the PDS Ring-Moon Systems Node ViewMaster site as the source for the data. You can easily use this file to automatically retrieve the actual data using the wget command as follows:

wget -i urls.txt

We have also made it easier to download ZIP archives for a single observation directly from the Details tab:

As always, you can continue to download individual data products from this tab as well.

We value your feedback, questions, comments, and suggestions. Please let us know what you think!

Wednesday, January 16, 2019

OPUS Now Has Input Value Checking and Search String Hints

One of the most-requested improvements in OPUS is now available: Checking numerical inputs for validity.

As you type into any numerical field (including floating point, integer, date/time, and spacecraft clock count), the field border will change as you're typing. Green means the current value is valid as-is. Yellow means the current value is invalid. If you try to do a search with an invalid value, the erroneous search field will turn red and no search will be performed until you fix the input.

In addition, once you've entered a valid value, that value is normalized. For a floating point value, that means it is formatted using the proper number of digits to the right of the decimal point to indicate its precision. For a date/time value, that means converting it to the standard format YYYY-MM-DDTHH:MM:SS.sss.

As an added bonus, string input fields now have string hints. As you type, the database will be searched for appropriate matches and they will be presented to you in a drop-down box. If your search is reasonably constrained, these hints will only be those relevant to your current search. If your search has too many results, however, the hints will indicate all possible matches from the entire database. Up to 100 hints can be shown, and the hints intelligently obey the search type (contains, begins, ends, etc.). Simply click on a result if you wish to choose it for your search. This feature is particularly useful for fields such as Cassini Observation Name or Note that have a lot of free-form text.

As always, we look forward to hearing from our users. Please feel free to ask questions, make suggestions, or complain, as appropriate! We want everyone's experience using OPUS to be a great one.

Monday, December 10, 2018

Recent updates to OPUS (Instrument Names, Units, and Versions!)

  • Several fields (e.g. Spacecraft Clock Count, Filter) have similar names across instruments, making it difficult to tell which instrument or mission a particular search field or metadata column refers to. We now include the instrument or mission name in the search field title as well as in the metadata columns in the same way that we show the name of the body for surface geometry.

  • Many users have been requesting information on the measurement units supported by OPUS, and we are pleased to announce that these units are now shown. A future release will allow the user to select their own units.

  • The PDS archive supports multiple versions for data (like any good archive, nothing is ever thrown away). These versions are now visible in OPUS on the Details page. For now, when downloading a zip file for selected images, only the current version is returned. In a future release we will allow you to select which version you wish to download. 

  • Previously, Cassini ISS filter names lumped all polarizing filters of a particular type (e.g. IRP0, IRP90) into a single filter (IRPOL). We have now separated these out, making it easier to determine the polarization angle when looking at the metadata.
  • We now ignore spaces, commas, and underscores in numeric fields, allowing input such as "100,000" or "100_000" to indicate thousands.
  • Displayed numeric values (either the min/max hints on the search page or metadata values) are now rounded to an appropriate number of significant digits, with trailing zeros included to show the available precision.

Saturday, November 17, 2018

Recent updates to OPUS (new OPUS ID format!)

  • There is now a link for Questions and Feedback in the top menu bar. Please use it!
  • The format of the OPUS ID (used to uniquely identify observations) has changed. The previous format was incompatible with the upcoming migration to PDS4. The new OPUS ID format should stay consistent for the foreseeable future. The old OPUS ID format is no longer supported. Some examples of the change:
        Old: COISS_1001-1294561143_1295221348-W1294561143_1
        New: co-iss-w129456114
        Old: NHLALO_x001-20060224_000310-lor_0003103486_0x630
        New: nh-lorri-lor_0003103486
  • We have removed the short-lived search fields Spatial Sampling, Wavelength Sampling, and Time Sampling and returned to a simpler way of describing observations called Observation Type. Current choices include:
    • Image (a 2-D array of intensity values)
    • Spectrum (a 1-D array of intensity vs. wavelength)
    • Spectral Image (similar to Image, but a grating or prism has been used to spread out the spectrum along one of the axes)
    • Spectral Cube (a 3-D array, similar to an Image but with each pixel value containing an entire spectrum)
    • Time Series (a 1-D array of intensity or optical depth vs. time, such as for an occultation)
    • Spectral Time Series (similar to Time Series, but containing a spectrum for each time step)
  • The Primary File Spec for Galileo SSI observations has been changed. The original format, which looked like "GO_0017:[J0.OPNAV.C034640]5900R.IMG", was based on an ancient filesystem constraint that required the actual filename to be split across multiple directories because it was too long. This resulted in the final filename, such as "5900R.IMG", being non-unique. We have changed the format to have a more modern, non-restricted format such as "GO_0017/J0/OPNAV/C0346405900R.IMG", where each filename is now unique.
  • When downloading observations that have been selected, the available products are now categorized and sorted by their product type, such as "Metadata Products", "Browse Products", and "Mission-Specific Products".
  • The definition of Planet has been changed for Cassini and New Horizons instruments. Previously, Planet was based on the Intended Target Name, so that an observation of Venus was marked as planet Venus. Now, consistent with other missions and instruments, the Planet field indicates approximately where the spacecraft was when the observation was taken. For most observations, this is a good starting point when looking for images of that particular planet, but if you want to be more specific use the Intended Target Name or Surface Geometry Target Name. The exception to this is the Hubble Space Telescope, which is always around Earth. In this case, the Planet field is still based on the Intended Target Name.
  • The definition of Measurement Quantity for Cassini UVIS has been changed. The choice between Optical Depth and Emission is no longer dependent on the instrument mode, but instead depends on the textual Note included with the observation. Any observation with a Note containing "OCCULTATION" is marked as Measurement Type Optical Depth. All other observations are marked as Emission.
  • We have added descriptive text to help users understand the difference between Intended Target Name and Surface Geometry Target Name.
  • For added clarity, we have renamed some targets:
    • J Rings → Jupiter Rings
    • S Rings → Saturn Rings
    • U Rings → Uranus Rings
    • N Rings → Neptune Rings
    • J Minor Sat Jupiter Minor Satellites
    • Cal Lamps Calibration Lamps
  • It is now possible to right-click on the View Detail link anywhere it appears and open OPUS in a new browser tab or window with the Detail tab selected.
  • The /api/files JSON return has been changed. Previously the product type was identified by a "pretty name" such as "Raw Data". We have changed this to a simple slug-style name such as "coiss-raw" to decouple the user experience from the internal data representation. The precise data products available for each instrument are complicated (it's not as simple as just "raw" or "calibrated" when you look at all the things we currently support or are going to support). We decided to split them out by instrument so that we could give the full information to the user, rather than risk merging data products together that really aren't in the same category. Anything that is truly generic, such as browse images (browse-thumb, browse-small, etc.) or geometry indexes (ring-geometry, moon-geometry) do not have the instrument name in the front. Anything that could be different from instrument to instrument (e.g. coiss-raw, coiss-calibrated, or coiss-thumb [a special COISS-specific browse image - it's not the same thing as browse-thumb]) has the instrument name prepended. If you only want raw images, it should be easy enough to just look for keys ending in "raw", but be aware that some instruments, like Hubble, may have a different concept of what raw means.
  • Several annoying bugs were fixed. It is once again possible to sort in the table view on a field that contains multiple choices. There was a 3-order-of-magnitude error in the Observation Duration for certain instruments. Some HST NICMOS aperture names were listed twice, with only one working. Some observations were being treated as separate when they were really just separate products available for the same observation; fixing this results in a slightly smaller number of search results for some instruments. It is now possible to download all downlink copies of certain Cassini VIMS observations.

Thursday, August 30, 2018

New Hubble Images Added to OPUS

More than 6,000 solar system images taken by the Hubble Space Telescope have been added to OPUS. The majority of these images were taken by Hubble's Advanced Camera for Surveys (ACS) and Wide Field Camera 3 (WFC3), although there are also new images from NICMOS, STIS, and WFPC2. Most new images are of Jupiter and Saturn, but there are also new images of Uranus, Neptune, Pluto, and even Earth's Moon.