No description, website, or topics provided.
JavaScript HTML Python CSS Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
correlator
fault_detector
final
resources
serial_transfer_xbee
telemetry_simulation
viz
.gitignore
__init__.py
feature_ideas.md
functionality_notes.txt
readme.md
resources.md
summary.png
viz.py

readme.md

Summary

Determining the root causes of problems for complex electromechanical systems is difficult. Systems can detect fault states quite reliably using simulated software models; however, even when a fault is detected, it can be difficult to determine the underlying reasons, and resolution method, for that fault. Some anticipated faults may be automatically recovered from, but others are more complex and require humans to understand their root causes before resolving them.

In this project, we've worked to address these issues within a data visualization product. We focused on the major frontend components, as well as our highly modularized backend, which we developed in order to make a system that not only simplifies the telemetry monitoring and fault diagnosis tasks, but does it in a way that’s extensible to a wide variety of systems.

Development Notes

Setup

The server is flask, which can be installed minimally using:

pip install flask

Running

To run the visualization server/client combo, in the root directory either run:

flask -a viz --debug run # Requires Flask 1.0

or:

python viz.py

This will start a localhost server on port 5000.

The first command requires Flask 1.0, I believe, but handles restarting the server for new code in a more reliable way.

Using python -m viz might be preferable to the second case, but might require some finagling to get working.

Research and Development Process

The research behind this project actually dates back to the beginning of 2015, when Nathaniel started researching Fault Detection, Isolation, and Recovery (FDIR) system design as part of his graduate research in Aeronautics & Astronautics. Prior to this, he had worked on code and testing related to FDIR systems at SpaceX, and had used a few different telemetry monitoring and analysis tools. The tools that he used informed his work and some of the early design decisions that were made on this project.

After the project kicked into gear and Nick joined the effort, the two of them began to look into other aerospace industry systems, as well as read academic research into how to solve many of the problems related to the display and analysis of thousands of slightly-related channels of data. They were inspired by methods of graphically showing cross-correlations which were described by Yairi et al, as well as by techniques for packing in large amounts of status-related data into a small space that were originally described by Cancro et al.

As development continued, they iterated on design decisions and improved the overall interface and its ability to quickly and clearly convey data. That iteration continues.

Division of Labor

The major tasks within this project were distributed as follows:

  • Nathaniel: Data simulation, fault detection system, monitoring panel, correlation backend, metafile format design and parsing, server-client communication
  • Nick: channel hierarchy window, correlation matrix frontend, channel correlation vector frontend, plots, server-client communication

(However, there was quite a bit of crossover as well as pair-programming.)