nasa/openmct là dự án mã nguồn mở trên GitHub với 13.2k sao, viết chủ yếu bằng JavaScript. A web based mission control framework.
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
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.
[!NOTE]
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!
Building and Running Open MCT Locally
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
(Optional) Install the correct node version using nvm:
nvm install
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
[!IMPORTANT]
Open MCT is now running, and can be accessed by pointing a web browser at http://localhost:8080/
Open MCT is built using npm and webpack.
Documentation
Documentation is available on the Open MCT website.
Examples
The clearest examples for developing Open MCT plugins are in the
tutorials provided in
our documentation.
[!NOTE]
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 [email protected].
Developing Applications With Open MCT
For more on developing with Open MCT, see our documentation for a guide on Developing Applications with Open MCT.
Compatibility
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.
The project utilizes nvm to maintain consistent node and npm versions across all projects. For UNIX, MacOS, Windows WSL, and other POSIX-compliant shell environments, click here. For Windows, check out nvm-windows.
If you encounter an issue with a particular browser, OS, or NodeJS API, please file an issue.
[!NOTE]
If you are building a project with Open MCT as a git dependency rather than an npm dependency, an extra step is now
necessary to build the source. Due to the threat posed by Supply Chain Attacks ignore-scripts is now enabled in
this repository. Developers building with Open MCT as a git dependency will now need to execute npm run build
manually. We always encourage developers to use Open MCT as a prebuilt npm repository, rather than building from github.
Plugins
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.
Tests
Our automated test coverage comes in the form of unit, e2e, visual, performance, and security tests.
Unit 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.
e2e, Visual, and Performance Testing
Our e2e (end-to-end), Visual, and Performance tests leverage the Playwright framework and are executed using Playwright's test runner, @playwright/test.
How to Run Tests
e2e Tests: These tests are run on every commit. To run the tests locally, use:
npm run test:e2e:ci
Visual Tests: For running the visual test suite, use:
npm run test:e2e:visual
Performance Tests: To initiate the performance tests, enter:
npm run test:perf
All tests are located within the e2e/tests/ directory and are identified by the *.e2e.spec.js filename pattern. For more information about the e2e test suite, refer to the README.
Security Tests
Each commit is analyzed for known security vulnerabilities using CodeQL. The list of CWE coverage items is available in the CodeQL docs. The CodeQL workflow is specified in the CodeQL analysis file and the custom CodeQL config.
Test Reporting and Code Coverage
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
For more on the specifics of our code coverage setup, see
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.
Term
Definition
plugin
A removable, reusable grouping of software elements. The application is composed of plugins.
composition
In the context of a domain object, this term 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. It is described in its model as an array of ids, providing a means to asynchronously retrieve the actual domain object instances associated with these identifiers.
description
When used as an object property, this term refers to the human-readable description of a thing, usually a single sentence or short paragraph. It is 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 and a distinct thing in the work supported by Open MCT. Anything that appears in the left-hand tree is a domain object.
identifier
A tuple consisting of a namespace and a key, which together uniquely identifies a domain object.
model
The persistent state associated with a domain object. A domain object's model is a JavaScript object that can be converted to JSON without losing information, meaning it contains no methods.
name
When used as an object property, this term refers to the human-readable name for a thing. It is most often used in the context of extensions, domain object models, or other similar application-specific objects.
navigation
This term refers to the current state of the application with respect to the user's expressed interest in a specific domain object. For example, 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.
namespace
A name used to identify a persistence store. A running Open MCT application could potentially use multiple persistence stores.
Open MCT v2.0.0
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.
How do I know if I am using legacy API?
You might still be using legacy API if your source code
Contains files named bundle.js, or bundle.json,
Makes calls to openmct.$injector(), or openmct.$angular,
Makes calls to openmct.legacyRegistry, openmct.legacyExtension, or openmct.legacyBundle.
What should I do if I am using legacy API?
Please refer to the modern Open MCT API. Post any questions to the Discussions section of the Open MCT GitHub repository.
Related Repos
[!NOTE]
Although Open MCT functions as a standalone project, it is primarily an extensible framework intended to be used as a dependency with users' own plugins and packaging. Furthermore, Open MCT is intended to be used with an HTTP server such as Apache or Nginx. A great example of hosting Open MCT with Apache is openmct-quickstart and can be found in the table below.
Repository
Description
openmct-tutorial
A great place for beginners to learn how to use and extend Open MCT.
openmct-quickstart
A working example of Open MCT integrated with Apache HTTP server, YAMCS telemetry, and Couch DB for persistence.
Open MCT YAMCS Plugin
Plugin for integrating YAMCS telemetry and command server with Open MCT.
openmct-performance
Resources for performance testing Open MCT.
openmct-as-a-dependency
An advanced guide for users on how to build, develop, and test Open MCT when it's used as a dependency.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/nasa/openmct là nguồn chính thức.
nasa/openmct có bao nhiêu sao?
nasa/openmct có 13.2k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/nasa/openmct. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
nasa/openmct có phải mã nguồn mở không?
TopGit chưa ghi nhận license cho nasa/openmct. Phần lớn repo public trên GitHub là mã nguồn mở, nhưng điều khoản khác nhau từng repo — mở file LICENSE để xác nhận.
nasa/openmct có trang demo không?
Dự án có trang chủ ở https://nasa.github.io/openmct/. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
nasa/openmct là gì?
nasa/openmct (nasa/openmct) là dự án JavaScript trên GitHub. Theo mô tả gốc: A web based mission control framework.
Đọc đầy đủ README ở tab phía trên.
openmct có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về openmct.