Open MCT (Open Mission Control Technologies) is a next-generation mission control framework for visualization of data on desktop and mobile devices. It is developed at NASA's Ames Research Center, and is being used by NASA for data analysis of spacecraft missions, as well as planning and operation of experimental rover systems. As a generalizable and open source framework, Open MCT could be used as the basis for building applications for planning, operation, and analysis of any systems producing telemetry data.
Please visit our Official Site and Getting Started Guide
Once you've created something amazing with Open MCT, showcase your work in our GitHub Discussions Show and Tell section. We love seeing unique and wonderful implementations of Open MCT!
Try Open MCT now with our live demo.
Building and running Open MCT in your local dev environment is very easy. Be sure you have Git and Node.js installed, then follow the directions below. Need additional information? Check out the Getting Started page on our website. (These instructions assume you are installing as a non-root user; developers have reported issues running these steps with root privileges.)
Clone the source code
git clone https://github.com/nasa/openmct.git
Install development dependencies. Note: Check the package.json engine for our tested and supported node versions.
npm install
Run a local development server
npm start
Open MCT is now running, and can be accessed by pointing a web browser at http://localhost:8080/
Documentation is available on the Open MCT website.
The clearest examples for developing Open MCT plugins are in the tutorials provided in our documentation.
We want Open MCT to be as easy to use, install, run, and develop for as possible, and your feedback will help us get there! Feedback can be provided via GitHub issues, Starting a GitHub Discussion, or by emailing us at arc-dl-openmct@mail.nasa.gov.
Open MCT is built using npm
and webpack
.
See our documentation for a guide on building Applications with Open MCT.
This is a fast moving project and we do our best to test and support the widest possible range of browsers, operating systems, and nodejs APIs. We have a published list of support available in our package.json's browserslist
key.
If you encounter an issue with a particular browser, OS, or nodejs API, please file a GitHub issue
Open MCT can be extended via plugins that make calls to the Open MCT API. A plugin is a group of software components (including source code and resources such as images and HTML templates) that is intended to be added or removed as a single unit.
As well as providing an extension mechanism, most of the core Open MCT codebase is also written as plugins.
For information on writing plugins, please see our API documentation.
Our automated test coverage comes in the form of unit, e2e, visual, performance, and security tests.
Unit Tests are written for Jasmine and run by Karma. To run:
npm test
The test suite is configured to load any scripts ending with Spec.js
found
in the src
hierarchy. Full configuration details are found in
karma.conf.js
. By convention, unit test scripts should be located
alongside the units that they test; for example, src/foo/Bar.js
would be
tested by src/foo/BarSpec.js
.
The e2e, Visual, and Performance tests are written for playwright and run by playwright's new test runner @playwright/test.
To run the e2e tests which are part of every commit:
npm run test:e2e:stable
To run the visual test suite:
npm run test:e2e:visual
To run the performance tests:
npm run test:perf
The test suite is configured to all tests localed in e2e/tests/
ending in *.e2e.spec.js
. For more about the e2e test suite, please see the README
Each commit is analyzed for known security vulnerabilities using CodeQL and our overall security report is available on LGTM
Each test suite generates a report in CircleCI. For a complete overview of testing functionality, please see our Circle CI Test Insights Dashboard
Our code coverage is generated during the runtime of our unit, e2e, and visual tests. The combination of those reports is published to codecov.io
Certain terms are used throughout Open MCT with consistent meanings or conventions. Any deviations from the below are issues and should be addressed (either by updating this glossary or changing code to reflect correct usage.) Other developer documentation, particularly in-line documentation, may presume an understanding of these terms.
Support for our legacy bundle-based API, and the libraries that it was built on (like Angular 1.x), have now been removed entirely from this repository.
For now if you have an Open MCT application that makes use of the legacy API, a plugin is provided that bootstraps the legacy bundling mechanism and API. This plugin will not be maintained over the long term however, and the legacy support plugin will not be tested for compatibility with future versions of Open MCT. It is provided for convenience only.
You might still be using legacy API if your source code
openmct.$injector()
, or openmct.$angular
,openmct.legacyRegistry
, openmct.legacyExtension
, or openmct.legacyBundle
.Please refer to the modern Open MCT API. Post any questions to the Discussions section of the Open MCT GitHub repository.