Open MCT

Open MCT is a next-generation mission control framework being developed at the NASA Ames Research Center in Silicon Valley. Web-based, for desktop and mobile.

##HOW IS NASA USING OPEN MCT?

Software based on Open MCT is being used for mission planning and operations in the lead up to the Resource Prospector mission and at NASA's Jet Propulsion Laboratory to view data from the Curiosity Rover.

##Features

• Support planning and operations of any system that produces telemetry
• Support space missions
• Visualize Data
  • Streaming Data
  • Historical Data
  • Imagery
  • Timelines
  • Procedures
  • etc.

##See Open MCT in Action LIVE DEMO

##Getting Started

1. Download or Clone OpenMCT git clone https://github.com/nasa/openmct.git

2. Install Development Dependencies npm install

3. Run on your local machine npm start

4. Open your web browser and go to http://localhost:8080/

5. Wait for splash screen finish then you should be able to play with Open MCT.

For more information on building and running Open MCT, please see our getting started guide - https://nasa.github.io/openmct/getting-started/

Build

Open MCT is built using npm and gulp.

To build:

npm run prepublish

This will compile and minify JavaScript sources, as well as copy over assets. The contents of the dist folder will contain a runnable Open MCT instance (e.g. by starting an HTTP server in that directory), including:

• A main.js file containing Open MCT source code.
• Various assets in the example and platform directories.
• An index.html that runs Open MCT in its default configuration.

Additional gulp tasks are defined in the gulpfile.

Building Documentation

Open MCT's documentation is generated by an npm-based build. It has additional dependencies that may not be available on every platform and thus is not covered in the standard npm install. Ensure your system has libcairo installed and then run the following commands:

• npm install
• npm install canvas nomnoml
• npm run docs

Documentation will be generated in target/docs.

Bundles

A bundle is a group of software components (including source code, declared as AMD modules, as well as resources such as images and HTML templates) that are intended to be added or removed as a single unit. A plug-in for Open MCT will be expressed as a bundle; platform components are also expressed as bundles.

A bundle is also just a directory which contains a file bundle.json, which declares its contents.

The file bundles.json (note the plural), at the top level of the repository, is a JSON file containing an array of all bundles (expressed as directory names) to include in a running instance of Open MCT. Adding or removing paths from this list will add or remove bundles from the running application.

Tests

Tests are written for Jasmine 1.3 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. (For legacy reasons, some existing tests may be located in separate test folders near the units they test, but the naming convention is otherwise the same.)

Test Reporting

When npm test is run, test results will be written as HTML to target/tests. Code coverage information is written to target/coverage.

Functional Testing

The tests described above are all at the unit-level; an additional test suite using Protractor is under development, in the protractor folder.

To run:

• Install protractor following the instructions above.
• cd protractor
• npm install
• npm run all

Glossary

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.

• bundle: A bundle is a removable, reusable grouping of software elements. The application is composed of bundles. Plug-ins are bundles. For more information, refer to framework documentation (under platform/framework.)
• capability: An object which exposes dynamic behavior or non-persistent state associated with a domain object.
• composition: In the context of a domain object, this refers to the set of other domain objects that compose or are contained by that object. A domain object's composition is the set of domain objects that should appear immediately beneath it in a tree hierarchy. A domain object's composition is described in its model as an array of id's; its composition capability provides a means to retrieve the actual domain object instances associated with these identifiers asynchronously.
• description: When used as an object property, this refers to the human-readable description of a thing; usually a single sentence or short paragraph. (Most often used in the context of extensions, domain object models, or other similar application-specific objects.)
• domain object: A meaningful object to the user; a distinct thing in the work support by Open MCT. Anything that appears in the left-hand tree is a domain object.
• extension: An extension is a unit of functionality exposed to the platform in a declarative fashion by a bundle. For more information, refer to framework documentation (under platform/framework.)
• id: A string which uniquely identifies a domain object.
• key: When used as an object property, this refers to the machine-readable identifier for a specific thing in a set of things. (Most often used in the context of extensions or other similar application-specific object sets.)
• model: The persistent state associated with a domain object. A domain object's model is a JavaScript object which can be converted to JSON without losing information (that is, it contains no methods.)
• name: When used as an object property, this refers to the human-readable name for a thing. (Most often used in the context of extensions, domain object models, or other similar application-specific objects.)
• navigation: Refers to the current state of the application with respect to the user's expressed interest in a specific domain object; e.g. when a user clicks on a domain object in the tree, they are navigating to it, and it is thereafter considered the navigated object (until the user makes another such choice.)
• space: A name used to identify a persistence store. Interactions with persistence with generally involve a space parameter in some form, to distinguish multiple persistence stores from one another (for cases where there are multiple valid persistence locations available.)