We’re excited to introduce the User Portal! We created this site to help SAMI users access their device data in a dynamic (more on this in a moment) and intuitive interface.
The primary features of the User Portal are device management and the data visualization tool. On the dashboard, you can view your connected devices at a glance, and easily disconnect them or add more.
If you haven’t connected a device yet, it’s simple. Click “+ Connect another device…” and type the name of your device into the field on the next page. This will search the current list of selected devices you can connect to SAMI. After authorizing the device, if it is active, the device’s data will begin to appear in the data visualization tool:
Data visualization is accessible by clicking “View your data” on the upper-right of the dashboard, or the magnifying-glass icon next to any of your connected devices.
First you’ll need to populate the tool with data types. Click the “+/- CHARTS” button to see all the available charts listed under their respective devices. You can display up to 20 at a time:
For developers, the tool provides a quick preview of how data will appear to users that have connected your devices to SAMI, provided it is configured to work with the Messages APIs. Note that the timeframe on the top row will constantly advance. The data visualization tool was built to show real-time data, and defaults to a 10-second window. Each data type appears as a continually evolving stream. If this isn’t the optimal way to view your device data, we’ll show you how to scale the display.
This tool has been designed with power users in mind. Let’s take a look at some of the details.
Charts can be rearranged to let you see data streams side-by-side in the timeline. Click and drag a chart by the two bars in the upper-left corner to move it; the window will scroll up and down as you drag the chart:
Each chart can be customized. The pulldown menu in each chart’s upper-right corner lets you display the data in lines, bars, or discrete data points. The y-axis labels can be hidden if they are not meaningful for a chart’s data type. You can also change the color:
The timeline is scalable. By clicking the buttons to zoom in and out (the magnifying glasses next to the charts button), you’ll see the timeline contract and expand, and every chart with it. Alternatively, the row of buttons to the right allow you to jump to a specific timeframe, from 10 seconds to 5 weeks.
You can also set a date and time. By selecting a day in the calendar and starting time in the time picker (see the controls below), you can define a specific time window for the charts display.
To review historical data, click “OLDER” and “NEWER” to jump through the timeline. You can also scrub the timeline by clicking and dragging directly on a chart. Notice that all charts move in unison, making it easy to spot trends as you move back and forth. This also “pauses” the timeline, which will not advance until you either return to the current time or click the “Play” button next to “Set time…”
If data was recorded earlier or later than the time window being shown, a “JUMP TO DATA” link will appear on that side. When clicked, the charts jump to the point in time where there was data. If there is no data in that direction, the link will not appear.
Finally, hovering over a chart with the mouse cursor reveals pop-ups for specific data points and their timestamps:
That’s it for today. In upcoming posts, we’ll talk about the Developer Portal and how it can aid in your development process. We will also introduce some of the third-party devices and applications being integrated with SAMI.
Top image: NASA