Jump to content
PDS Geosciences Node Community

Tom Stein

Geo Staff
  • Posts

  • Joined

  • Last visited

Posts posted by Tom Stein

  1. The above video demonstrates how to order data from the Analyst's Notebook using search filters and the cart order system. The transcript of the video is provided below.



    Hello. I am going to provide a short video demonstrating getting data from the Mars Curiosity rover using the Analyst’s Notebook.

    In this case, I want to download Navcam image data from a particular sol using a pattern for the data product ID.

    I will start by signing into to the Notebook. An account is not required but is useful for return visits to the site.

    Let me minimize this introductory help window.

    For this demonstration, our goal is to find Navcam data from a specific sol using product ID pattern matching. Let’s click on the search tab, and then select data search.

    Now we will set some filters.

    • We want data from sol 611, so I will enter 611 as the start sol and click tab. I also will set the end sol. Notice that the results have changed to reflect this setting.
    • Let’s constrain search results to only Navcam data.
    • And then let’s scroll to the bottom to add our product ID pattern. In this case, we are looking for linearized RAD data with a specific sequence value.

    Notice the prompt at the top of the results listing. The suggestion is that we change the Results view setting to “all products” based on our use of the ID filter. Let me scroll the filter list to the top where we see that currently the Results view is set to “Observation groups”. We will accept the suggested change, and now we have 10 data products in the results view.

    As a side note, we can read more about the Results view filter using the help options provided. More information is available in this help window.

    Now that we have found the data that matches our settings, we will add them to our cart.

    Let’s now go to our cart to finish the order and download the data. The cart is found in the User tab. We will click on View cart and checkout.

    I will accept the current Order settings and continue to step 2 of the checkout.

    The settings here show that I will receive an email when a zip file is ready for download. I will click Submit Request and look forward to the email message that will arrive shortly. The message will include a link to a zip file with the data we ordered.

    If you have questions about using the Notebook, you can switch to the Help tab to access the online documentation and to get information about contacting us directly.



  2. Great question. The sol documents you refer to are the Mission Manager and Documentarian reports that provide a view into science operations—insight into why and how particular observations were made. The reports have not been edited except for grammar and spelling, and to remove spacecraft and instrument sensitive materials. 

    As you note, the sol documents are not part of the formal science archive. They are provided courtesy of the respective mission science teams who approve the content. Separate from the sol documents are mission and data set documents that are collected from archive bundles and volumes and are designed to promote understanding off the mission, spacecraft, instruments, and data formats.

    I have updated the online help to include a more detailed description of sol documents, highlighting the fact that they are not part of the formal archive.

  3. Hi Neal -

      Your question makes perfect sense. In the data search, you can enter a sequence ID as a search criterion. The available sequences will appear as you type, so by entering "15298", for example, the selection box provides the correct sequence ID "mcam15298". Search results will appear on the right side where you can add the found items to your cart from the menu. See the attached image as an example.

    You can apply other search criteria as you wish. The default results for MastCam will be DRCX products. If you are looking for XXXX products, try this trick: select "All products" from the "Results view" option at the top of the filter list, and then enter "*XXXX" in the "ID" option at the bottom of the filters. You can further restrict the selection to omit thumbnails by selecting "C" Mastcam data type under the "Type" filter option.


    Searching for data by sequence.png

  4. Hi, Jimmy. You should be able to delete individual measurements and other elements by clicking on the corresponding trash can icon in the list of elements to the left of the image. See the image below for an example. Note that deleting one annotation may delete others as well. For example, if you delete a location that is the endpoint of a distance measurement, the endpoint locations and the distance measurement all will be deleted. You will receive a warning in such cases asking you to confirm the delete. Please let us know if you still feel that the tool isn't working the way you expect.

    I am glad that you find the measurement tools useful. You are welcome to make suggestions for tool enhancements.


  5. The profile plot y -axis is elevation in site frame. To be specific, the elevation values shown are the rover's negative z-axis values because in site frame, the rover's z-axis is positive down. You will notice in the attached example, the elevation of the first point is z = -2.04m in the location list and 2.04m in the profile plot. (Remember, the profile shows elevation as -z values.) If you change the Coordinate frame from Site to Rover using the drop down menu, you will see different z values in the location list.

    The profile plot x-axis is distance along the profile, with the first point in the plot being the beginning of the profile drawn on the image. This means that, although the plotted elevation is absolute using site frame values, the distance along the profile is relative to the points selected.

    Note that the profile calculated returns the elevations along a path as if it were "dropped on the ground" between the two points. The profile is not simply the elevation values of the image pixels under the line drawn on the image.


  6. Hi Jimmy - thanks for dropping the note. We're sorry for the inconvenience.

    I tracked down the problem to an integer conversion and the fix is in place. You probably will need to refresh your browser window. Please let me know how it goes.

  7. You are correct, Jimmy. The Mastcam L/R have different fields of view which can make working with the stereo pairs more difficult. The Notebook uses Navcam XYZ data products generated by the team to support the measurement and distance tools. However, the Mastcam team does not produce XYZ data products, thus the Notebook measurement tools can't support Mastcam images taken as stereo pairs.

  8. The sol 1627 sequence does have 112 thumbnail video frames (product type "K"). Unfortunately, the command sequence did not include a request for full-resolution frames to match. Note that the 10 K-type products you see for sol 1627 are really the two "XXXX" images and the eight derived images (four from each) that include a variety of color correction, linearization, and other techniques applied. The four Mastcam derived image types (also called processing codes) are DRXX, DRCV, DRLX, and DRCL. You can read about them in the data product SIS (Software Interface Specification). In the Notebook, click on the Resource tab, then choose "View documents". Select Mastcam and scroll down to the document titled "MSL_MMM_EDR_RDR_DPSIS.PDF".

    Only a handful of sols have full-resolution (or higher-resolution) Mastcam movie sequences. Through the current data release, the sols are:

    • Type K, sols 351, 363, 368, 713, 1032, 1627, 1668, 1692, 1693, 1972
    • Type L, sols 363, 368, 369, 650, 713, 1032
    • Type M, sols 284, 284, 289, 351, 1625

    The K-type sequences generally have the fewest frames per sequence. Some sols have multiple sequences.

    You can find the images in the Notebook from the Search > Data form. Enter the sol, instrument, and product type, and also put the processing code "DRCX" in the Product ID box. This will restrict the number of images that are returned.


    PS. Nice video. I'd like to see what you get from higher-res images.

  9. Glad to hear the tutorial helped. Although not trivial, you can use the Mastcam SIS (Software Interface Specification) in conjunction with individual product labels to work out the pointing information. The scale is a bit tougher. We are working on adding image footprints to the traverse map to show orientation. We will also consider adding pointing information to the product overview page to at least provide basic information about where the image is relative to the rover.


    The Mastcam SIS is available here: http://an.rsl.wustl.edu/su/t8F4Tcw3

    Note that this link may change as documents are updated. I found the document from the Resources tab under "Mission and instrument data set documents" and then choosing "Mastcam".

  10. Hi there. If you are looking at a Hazcam or Navcam image that is part of a stereo pair, you can use the Notebook's Image Viewer. There are measurement tools built in to let you obtain locations and distances and to view elevation profiles.The tool is a little hard to find--we recently started work on some tutorials to help users like yourself find these tools and learn how to use them, but they still are in production. In the meantime, let me briefly walk you through getting to and using the Image Viewer measurement tools.

    To get started in this example (a Navcam stereo pair from sol 1292), click on this link: http://an.rsl.wustl.edu/su/y6Y8N


    Side note, explanation of how I got to this page in the Notebook: Open the Analyst's Notebook for MSL and go to the Sol Summaries (the orange "sun" icon). This shows the data, documents, etc for each sol. If you click on a sol to expand it, you then have an option to expand the Data Products list for that sol. Clicking on any product in the list brings up a window about that product or group of products.


    Your screen should look something like screen shot 1. On the left is the sol summary list, and on the right is a Navcam stereo pair (and the resulting anaglyph image). We will work with the left image. The shortest was to get to the Image Viewer for that image is to click on the menu button where the red arrow is pointing in screen shot 1.


    A menu should open and your screen should look like screen shot 2. Now click on the Image Viewer link (in the red box in the screen shot 2). You should now see something like screen shot 3.


    Depending on your screen size, the Image Viewer space may be pretty small. You can get more area to work with by clicking on the two buttons highlighted in screen shot 3.


    In the Image Viewer, there is a left side with some controls, and the right side with the image. At the start, you are assigned the Pointer tool. Switch to the Distance Tool by clicking on the ruler icon highlighted in screen shot 4. A few things will happen. 1. The Distance tool icon will be highlighted in yellow to show it is selected. 2. Directions will appear (circled in red on screen shot 4) to show how to use the tool. 3. A purple overlay mask will appear to show where there are XYZ data in the image (purple is out of bounds).


    In this example I will create a distance using by following the instructions above the image: left click at the starting point, left click again where I want it to end, and then click the Complete button in the instructions. My screen looks like screen shot 5. There is an entry in the Distance table on the left. When I click on that like (in the red box in screen shot 5), the I have the opportunity to change the settings. I chose to increase the label size so it would be a little bigger.


    Note that you can export the image by selecting File > Download annotated image in the Image Viewer menu.


    Also, if you sign in with an account, your measurements will be saved and are loaded automatically the next time you open the image in the Image Viewer, even on another computer.


    There is additional Image Viewer help at this Notebook help page.


  • Create New...