MAVEN XINA User's Guide

From 699wiki
Jump to navigation Jump to search

Below are instructions on how to make use of XINA's capabilities for MAVEN.

Requesting a XINA Account

Create a NASA ID through IdMAX

Before using Xo, a user must have a NASA Agency UserID (AUID), managed through the Identity Management and Account Exchange (IdMAX). To create an AUID, a user needs to access the IdMAX through the Access Launchpad. Here a user can select to 'Create My Profile' and enter his/her information, as well as setting up security questions for password recovery.

Launchpad Create My Profile.PNG

Following the creation of an account, a user should complete the IT Security Training in SATERN here. More information about the IdMAX and steps required before using the NASA Access Management System (NAMS) are located here.

After completing all of the above, a user should be permitted to request XINA access through NAMS.

Request XINA Access through NAMS

To request XINA Access through NAMS, a user should be on the NASA network and login through id.nasa.gov here. Then, a user can select 'Create a NAMS Request' under the 'My Access' tab or by going here.

Create NAMS Request.PNG

Once on the request page, click on the "Sponsor" tab, then, search and select Tiffany Navas as the sponsor. Next, go to the "Applications" tab, search for "XINA", and select the only result that is returned.

Next, select "MAVEN Science" as the role, list your affiliation with the MAVEN science team, and submit your request. Once the request has been submitted, please contact an NGIMS team member so the correct permission can be assigned to the user's account. If this last step is not performed, the user will be able to log into XINA, but no information will be visible to them.

Logging Into XINA

When logging into XINA, it is recommended that Google Chrome or Mozilla Firefox be used as browsers. To access XINA, click here.

If the user doesn't have a current launchpad session open, the user will be prompted to use their NASA NAMS username and password prior to automatically redirecting to the XINA site.

Once successfully logged in, the user should see:

XINA Main.png

click on the MAVEN label in order to access all of the MAVEN resources.

Downloading NGIMS Flight Data

Selecting Flight Database

To search through the NGIMS Flight database, the user must ensure that the Model section has "Flight Model" selected.

Flight DB.png

If "Flight Model" isn't selected, click on the arrows to the right of the box, and select it.

Searching through the NGIMS Flight Data

Go to the quick search section, and click on the "Any" button to select from a variety of items to query for:

Searching Any.png


It is recommended that if the user does not know which particular activity to search for, they select "Fields.." and then select anything from orbit number and date to TID or calibration gas.

Searching Fields.png

After selecting whichever item type to query for, enter any relevant information into the text field and click on Searching.png to search.

Downloading NGIMS Flight Data

Once the user has found whatever TID correspond to the data they are trying to download, find the "Files" section. Within that section, click on Open.png to view the NGIMS Level 0 file, tm.mav, for that particular TID. Next, click on Download.png to download the file to your system.

NGIMS Engineering Tools

Message Log Viewer

Used to view message logs for only ONE TID at a time.

Before using this tool, it's important to select the Flight Database so that the correct TIDs can be made available. If necessary, please refer to Section 3.1 for guidance on how to select the correct database.

This tool can be opened two different ways: with a TID preselected or with no TID preselected.

Message Log Viewer with TID Preselected

To use the tool with a TID preselected, search for the specific TID that the user would like to use, if necessary, please refer to Section Section 3.3 for guidance.

After selecting a TID, click on Screen Shot 2014-10-07 at 12.39.37 PM.png icon to open the tools available for that TID and click on Message Log.

Message viewer.png

A new browser tab will be opened that already has the TID selected and all of its available message logs.

Tid log3.png

The user can also query for words found in the message log by typing them into the user prompt in the area below the Message Column. Once anything is entered into that area, the log will automatically start displaying anything that matches the word being search. Below is an example of a user querying the word "qms" in the message log and the instances where the word qms appeared for that particular TID. The user can also export the results of the query or the entire message log as a .csv file by clicking on the "Export" button at the top right of the screen.

Message query2.png

Message Log Viewer with NO TID Preselected

To use the tool with no TID preselected go the main MAVEN area, and to the right of the screen, the "Tools" area should be available. This area is where all of the tools available to the MAVEN mission can be found. Therefore, click on "Message Log"

Tools message log.png

After clicking on "Message Log", the browser will redirect to the message log viewer page which will show the message "No TID selected" within the TID area of the page, and the right side of the screen shows the message "No messages found".

Empty viewer.png

To select a TID, use the search field to query by any field such as TID, orbit number, date, etc., if necessary, refer to Section 3.2 for guidance on how to search for TIDs. Once the user knows which TID to view, simply click on the name of the TID to load its message log contents. To make sure the correct TID was selected, verify that the TID name shows up at the bottom left of the screen. Please note that this tool can only show one TID at a time; therefore, if the user wants to view another TID, as soon as they click on that TID's name, the message log will automatically update.

Loaded viewer.png

Message Log Trending

Used to search for specific messages in the message logs for multiple TIDs at a time.

Before using this tool, it's important to select the Flight Database so that the correct TIDs can be made available. If necessary, please refer to Section 3.1 for guidance on how to select the correct database.

Go to the main MAVEN area, and to the right of the screen, the "Tools" area should be available. This area is where all of the tools available to the MAVEN mission can be found. Therefore, click on "Message Log Trending"

Message trending.png

After clicking on "Message Log Trending", the browser will redirect to the message log trending page which will show the message "TIDs (0 TIDs, 0 expressions)" within the TID area of the page, and the right side of the screen shows the message "No messages found".

Empty trending.png

To select a TID, use the search field to query by any field such as TID, orbit number, date, etc., if necessary, refer to Section 3.2 for guidance on how to search for TIDs. Once the user knows which TID to view, simply click on the name of the TID to load its message log contents. In this tool, more than one TID can be selected, and the user can verify which TIDs have been selected by looking towards the bottom left of the screen. For example, in the image below two TIDs have been selected.

Tid selected.png

To search a specific message within the selected TIDs, enter whatever message the user wants to search for by typing it in the search bar on the top left side of the screen. For example, the image below shows the user searching for the word "QMS" within the TIDs 14008 and 14009. Please note that this search query is not case sensitive.

First search.png

After performing the initial query on the top left of the screen, the user can also search for another word within the already filtered messages logs by entering it on the query box to the right of the screen. For example, the image below show the user initially making a query for any messages within TIDs 14008 and 14009 that contain "QMS"; however, the user then decides to look for query for the word "off" within the previously filtered messages so that only messages that include both "QMS" and "off" appear.

Second search.png

Housekeeping

This tool is used to view the NGIMS housekeeping values per one main TID and a reference TID, if necessary. This tool is also used to view the Engineering State of Health (ESOH) plots.

Before using this tool, it's importatnt to select the Flight Database so that the correct TIDs can be made available. If necessary, please refer to Section 3.1 for guidance on how to select the correct database.

This tool can be opened two different ways: with a TID preselected or with no TID preselected.

Housekeeping Tool TID Preselected

To use the tool with a TID preselected, search for the specific TID that the user would like to use, if necessary, please refer to Section Section 3.3 for guidance.

After selecting a TID, click on Screen Shot 2014-10-07 at 12.39.37 PM.png icon to open the tools available for that TID and click on Housekeeping.

Housekeeping selected.png

A new browser window will appear which has the following default settings: Time (TID) as the X axis; Overlay as the reference; Average as the diff; 0 seconds as the offset; and Time as the bin mode. Please note that all of those settings can be easily changed by clicking on the Drop down.png icon next to each of them to open their respective drop down menus. For the X-axis, the two options available are Time in UTC and Time in seconds since the start of the TID. For reference, the options are overlay and difference; this particular option is used when the user wants to compare a housekeeping value from one TID with respect to a reference TID. For diff, the options are average, minimum, and maximum; and the offset can be any positive number of seconds. The bin mode options are time or marker.

Default hk.png

The user must then select from any of the instrument housekeeping values available under the Y Housekeeping area by scrolling down to the bottom left area of the page. The user can scroll down to view all 50 housekeeping values or simply enter a query on the search box to find the housekeeping value desired. Once a housekeeping value has been selected, it will appear at the bottom of the area, and it can easily be unselected by clicking on the red X next to it.

Y-axis.png Y-axis-selected.png

As soon as a housekeeping value has selected, the plot will automatically load. Also, note that the user can select more than one housekeeping value to view at the same time; however, if too many are selected, then, the data cannot be viewed as well. Apart from selecting house keeping values, the user also has the ability to select a marker from the chosen TID and view the housekeeping values over that marker's timespan. To a marker to select from, scroll to the bottom left of the page, and click on Open.png button within the Marker area. Once the Marker area has opened, enter an expression or phrase to query for. Please note that only one marker can be selected at a time.

Housekeeping Tool with NO TID Preselected

To use the tool with no TID preselected go the main MAVEN area, and to the right of the screen, the "Tools" area should be available. This area is where all of the tools available to the MAVEN mission can be found. Therefore, click on "Housekeeping" so that the page can redirect to the housekeeping tool page.

Housekeeping no tid.png

To select a TID, use the search field to query by any field such as TID, orbit number, date, etc., if necessary, refer to Section 3.2 for guidance on how to search for TIDs. Once the user knows which TID to view, simply click on the name of the TID to select it. To make sure the correct TID was selected, verify that the TID name shows up at the bottom left of the screen.

The housekeeping tool will have the following default settings: Time (TID) as the X axis; Overlay as the reference; Average as the diff; 0 seconds as the offset; and Time as the bin mode. Please note that all of those settings can be easily changed by clicking on the Drop down.png icon next to each of them to open their respective drop down menus. For the X-axis, the two options available are Time in UTC and Time in seconds since the start of the TID. For reference, the options are overlay and difference; this particular option is used when the user wants to compare a housekeeping value from one TID with respect to a reference TID. For diff, the options are average, minimum, and maximum; and the offset can be any positive number of seconds. The bin mode options are time or marker.

Default hk.png

The user must then select from any of the instrument housekeeping values available under the Y Housekeeping area by scrolling down to the bottom left area of the page. The user can scroll down to view all 50 housekeeping values or simply enter a query on the search box to find the housekeeping value desired. Once a housekeeping value has been selected, it will appear at the bottom of the area, and it can easily be unselected by clicking on the red X next to it.

Y-axis.png Y-axis-selected.png

As soon as a housekeeping value has selected, the plot will automatically load. Also, note that the user can select more than one housekeeping value to view at the same time; however, if too many are selected, then, the data cannot be viewed as well. Apart from selecting house keeping values, the user also has the ability to select a marker from the chosen TID and view the housekeeping values over that marker's timespan. To a marker to select from, scroll to the bottom left of the page, and click on the Open.png button within the Marker area. Once the Marker area has opened, enter an expression or phrase to query for. Please note that only one marker can be selected at a time.

Engineering State of Health (ESOH) Plots

Prior to their inclusion on XINA, the ESOH plots were a large PDF document which contained plots of all of the relevant health and safety values associated with each TID. However, now that the PDF document is not being generated, any user can quickly load each of the ESOH plots for any TID. Prior to selecting an ESOH plot option, the user must first select a TID by using the search field to query by any field such as TID, orbit number, date, etc., if necessary, refer to Section 3.2 for guidance on how to search for TIDs.

Esoh.png

The ESOH plots that are currently available on XINA are:

  • PS IMON - Power Supply Current
  • EM HV MON (High Speed)
  • EM HV MON (High Speed) Zoom
  • Plus Power VMONs -
  • Plus Power REFs
  • Plus 2.5 Power VMONs Expanded
  • Minus Power VMONs
  • CDH VREF
  • CTL VMON
  • Other IMON
  • 13V MON
  • +5V
  • -5V
  • 3.3V & 2.5V VMON
  • Grounds
  • Therm Com
  • Spares Channels
  • Board Temperatures
  • AGC & RF Temperature
  • IS Temperature
  • All Fils V MONs Full
  • CS Fil 1 Full Length
  • CS Fil 2 Full Length
  • OS Fil 1 Full Length
  • OS Fil 2 Full Length
  • Fil Emission
  • BA Mons
  • OS 1 EF MON
  • OS 2 EF MON
  • OS EA MON
  • CS 1 EF MON
  • CS 2 EF MON
  • CS EA MON
  • CS IF MON
  • OS OL MON
  • OS IF MON
  • IA MON
  • SL MON
  • MT MON
  • RF Frequencies
  • Pulse Counter
  • Multana (High Speed)
  • Valves

Housekeeping TID Trending

Mission independent TID-oriented housekeeping data trending tool.

Before using this tool, it's important to select the Flight Database so that the correct TIDs can be made available. If necessary, please refer to Section 3.1 for guidance on how to select the correct database. To use this tool go to the to right of the screen where the "Tools" area should be available. This area is where all of the tools available to the MAVEN mission can be found. Therefore, click on "Housekeeping TID Trending" so that the page can redirect to the housekeeping tool page.

Hk tid.png

After the page has redirected, search for the specific TIDs that the user would like to use, if necessary, please refer to Section 3.2 for guidance. Please note that this tool was explicitly built to compare housekeeping values for MORE than one TID at a time.

This tool has the following default settings: TID as the X axis; Overlay as the reference; and Average as the diff. Please note that all of those settings can be easily changed by clicking on the Drop down.png icon next to each of them to open their respective drop down menus. For the X-axis, the two options available are Time in UTC and TID. For reference, the options are overlay and difference; and for diff, the options are average, minimum, and maximum.

The user must then select from any of the instrument housekeeping values available under the Y Housekeeping area by scrolling down to the bottom left area of the page. The user can scroll down to view all 50 housekeeping values or simply enter a query on the search box to find the housekeeping value desired. Once a housekeeping value has been selected, it will appear at the bottom of the area, and it can easily be unselected by clicking on the red X next to it.

Y-axis.png Y-axis-selected.png

As soon as a housekeeping value has selected, the plot will automatically load. Also, note that the user can select more than one housekeeping value to view at the same time; however, if too many are selected, then, the data cannot be viewed as well.

This tool can also be used to compare ESOH plots through several TIDs, if necessary. For more information on how to use the ESOH functionality, please refer to Section 4.3.3

Housekeeping Marker Trending

This tool is used to trend housekeeping values with the emphasis on markers instead of TIDs.

Before using this tool, it's important to select the Flight Database so that the correct TIDs can be made available. If necessary, please refer to Section 3.1 for guidance on how to select the correct database. To use this tool go to the to right of the screen where the "Tools" area should be available. This area is where all of the tools available to the MAVEN mission can be found. Therefore, click on "Housekeeping Marker Trending" so that the page can redirect to the housekeeping marker trending tool page.

Hk marker.png

After the page has redirected, search for the specific TIDs that the user would like to use, if necessary, please refer to Section 3.2 for guidance. Please note that this tool was explicitly built to compare housekeeping values over several markers and/or TIDs.

After selecting one or more TIDs, scroll down to the "Marker" area to select markers available with the corresponding TIDs selected. Within the markers available, the user can then query by marker ID, marker type, or a variety of expressions as a way to filter out certain phases of the activity. Usually, it is expected that the user will be primarily interested in the phase mass scans only which have designated marker ID ranges from 2000 to 5000. To query by that particular expression, enter 2000 and 5000 in the marker area. Then, click on the Searching.png icon to search for the relevant marker IDs. Once the appropriate marker IDs have loaded, click on the "Add Expression" button shown below.

Add expression.png

To verify that the expression has been successfully added, scroll below the marker area to find the expression area to the bottom left of the screen.

Expression.png

After having selected TIDs and Markers, the user must then select from any of the instrument housekeeping values available under the Y Housekeeping area by scrolling down to the bottom left area of the page. The user can scroll down to view all 50 housekeeping values or simply enter a query on the search box to find the housekeeping value desired. Once a housekeeping value has been selected, it will appear at the bottom of the area, and it can easily be unselected by clicking on the red X next to it.

Y-axis.png Y-axis-selected.png

As soon as a housekeeping value has selected, the plot will automatically load. Also, note that the user can select more than one housekeeping value to view at the same time; however, if too many are selected, then, the data cannot be viewed as well. Instead of selecting individual housekeeping values, the user can also utilize the ESOH plots by referring to Section 4.3.3 for more information. Lastly, please note that if the user makes any changes to plot after it has previously loaded, the Execute.png button.

NGIMS Science Tools

MAVEN Science L1

This tool is used to view the NGIMS L1 data for one TID at a time, and its results can also be easily exported by clicking on the Export.png icon at the top right of the page.

Before using this tool, it's important to select the Flight Database so that the correct TIDs can be made available. If necessary, please refer to Section 3.1 for guidance on how to select the correct database.

This tool can be opened two different ways: with a TID preselected or with no TID preselected.

MAVEN Science L1 with TID Preselected

To use the tool with a TID preselected, search for the specific TID that the user would like to use, if necessary, please refer to Section Section 3.2 for guidance.

After selecting a TID, click on Screen Shot 2014-10-07 at 12.39.37 PM.png icon to open the tools available for that TID and click on MAVEN Science L1.

Tid selected l1.png

A new browser tab will be opened that already has the TID, mass ranges 4,12,14,15,16,17,18,28,30,32,40,44 as well as multipler (2) selected. Please note that in virtually all cases, multiplier 2 should be selected since it is the primary multiplier used by the NGIMS instrument. As for the mass ranges, any particular mass can be added along with ranges; however, beware that the more masses are included, the longer it can take for the plots to load. Also, please avoid entering 4-450 as a mass range since it will cause the tool to break. The user can also choose the data to be displayed as counts per second, dead time corrected, and raw, and it can be shown either linearly or logarithmically; however, the default selections are corrected counts per second and linear.

Default masses.png Default display.png

The primary two features that the user can use to query data with this tool is to select which focus mode to use and to filter by marker id. The user can select a focus mode by simply clicking on the query area for focus mode, and select any of the following from the drop down menu:

  • csn - Closed Source
  • osion - Open Source Ion
  • osnb - Open Source Neutral Beaming
  • osnt - Open Source Neutral Thermal

The user can then query by marker ID, marker type, or a variety of expressions as a way to filter out certain phases of the activity. Usually, it is expected that the user will be primarily interested in the phase mass scans only which have designated marker ID ranges from 2000 to 5000. To query by that particular expression, enter 2000 and 5000 in the marker area. Then, click on the Searching.png icon to search for the relevant marker IDs. Once the appropriate marker IDs have loaded, click on the "Add Expression" button shown below.

Add expression.png

To verify that the expression has been successfully added, scroll below the marker area to find the expression area to the bottom left of the screen.

Expression.png

One those selections have been made, scroll to the top of the screen and click on the Search l1.png button. After doing so, please wait a couple of seconds until the data has been populated in the Count v Mass plot and the Count v Time plot.

MAVEN Science L1 with NO TID Preselected

To use the tool with no TID preselected go the main MAVEN area, and to the right of the screen, the "Tools" area should be available. This area is where all of the tools available to the MAVEN mission can be found. Therefore, click on "MAVEN Science L1"

Tools message log.png

After clicking on "MAVEN Science L1", the browser will redirect to the MAVEN Science L1 tool page which will show the message "No TID selected" within the TID area of the page, and the plots will be empty.

Empty l1.png

To select a TID, use the search field to query by any field such as TID, orbit number, date, etc., if necessary, refer to Section 3.2 for guidance on how to search for TIDs. Once the user knows which TID to view, simply click on the name of the TID to select it. To make sure the correct TID was selected, verify that the TID name shows up at the bottom left of the screen. Please note that this tool can only show one TID at a time; therefore, if the user wants to view another TID, as soon as they click on that TID's name, that TID will be selected instead.

To query the data within the TID selected, the user can select which focus mode to use and to filter by marker id. The user can select a focus mode by simply clicking on the query area for focus mode, and select any of the following from the drop down menu:

  • csn - Closed Source
  • osion - Open Source Ion
  • osnb - Open Source Neutral Beaming
  • osnt - Open Source Neutral Thermal

The user can then query by marker ID, marker type, or a variety of expressions as a way to filter out certain phases of the activity. Usually, it is expected that the user will be primarily interested in the phase mass scans only which have designated marker ID ranges from 2000 to 5000. To query by that particular expression, enter 2000 and 5000 in the marker area. Then, click on the Searching.png icon to search for the relevant marker IDs. Once the appropriate marker IDs have loaded, click on the "Add Expression" button shown below.

Add expression.png

To verify that the expression has been successfully added, scroll below the marker area to find the expression area to the bottom left of the screen.

Expression.png

One those selections have been made, scroll to the top of the screen and click on the Search l1.png button. After doing so, please wait a couple of seconds until the data has been populated in the Count v Mass plot and the Count v Time plot.