|
1 | | -# OpenC3 COSMOS Plugin |
| 1 | +# OpenC3 COSMOS Trends |
2 | 2 |
|
3 | | -See the [OpenC3](https://openc3.com) documentation for all things OpenC3. |
| 3 | +A trend analysis tool for [OpenC3 COSMOS](https://openc3.com). Upload telemetry CSV data, fit trend models, and forecast future values. |
4 | 4 |
|
5 | | -Update this comment with your own description. |
| 5 | + |
6 | 6 |
|
7 | | -## Getting Started |
| 7 | +## Features |
8 | 8 |
|
9 | | -1. Edit the .gemspec file fields: name, summary, description, authors, email, and homepage |
10 | | -1. Update the LICENSE.md file with your company name |
| 9 | +- **Upload CSV** — Import data exported from Data Extractor (timestamp + numeric columns) |
| 10 | +- **9 Trend Models** — Linear, Polynomial, Exponential, Logarithmic, Power, Sinusoidal, Simple Moving Average, Exponential Moving Average, Holt's Linear |
| 11 | +- **Forecasting** — Predict ahead with configurable time horizon |
| 12 | +- **Threshold Crossing** — Set a threshold and see when the trend is predicted to reach it |
| 13 | +- **Export** — Save charts as PNG or trend data as CSV |
11 | 14 |
|
12 | | -## Building non-tool / widget plugins |
13 | | - |
14 | | -1. <Path to COSMOS installation>/openc3.sh cli rake build VERSION=X.Y.Z (or openc3.bat for Windows) |
15 | | - - VERSION is required |
16 | | - - gem file will be built locally |
17 | | - |
18 | | -## Building tool / widget plugins using a local Ruby/Node/pnpm/Rake Environment |
19 | | - |
20 | | -1. pnpm install --frozen-lockfile --ignore-scripts |
21 | | -1. rake build VERSION=1.0.0 |
22 | | - |
23 | | -## Building tool / widget plugins using Docker and the openc3-node container |
24 | | - |
25 | | -If you don’t have a local node environment, you can use our openc3-node container to build custom tools and custom widgets |
26 | | - |
27 | | -Mac / Linux: |
| 15 | +## Building |
28 | 16 |
|
29 | 17 | ``` |
30 | | -docker run -it -v `pwd`:/openc3/local:z -w /openc3/local docker.io/openc3inc/openc3-node sh |
| 18 | +pnpm install --frozen-lockfile --ignore-scripts |
| 19 | +rake build VERSION=1.0.0 |
31 | 20 | ``` |
32 | 21 |
|
33 | | -Windows: |
| 22 | +Or using Docker: |
34 | 23 |
|
35 | 24 | ``` |
36 | | -docker run -it -v %cd%:/openc3/local -w /openc3/local docker.io/openc3inc/openc3-node sh |
| 25 | +docker run -it -v `pwd`:/openc3/local:z -w /openc3/local docker.io/openc3inc/openc3-node sh |
| 26 | +pnpm install --frozen-lockfile --ignore-scripts |
| 27 | +rake build VERSION=1.0.0 |
37 | 28 | ``` |
38 | 29 |
|
39 | | -1. pnpm install --frozen-lockfile --ignore-scripts |
40 | | -1. rake build VERSION=1.0.0 |
41 | | - |
42 | | -## Installing into OpenC3 COSMOS |
| 30 | +## Installing |
43 | 31 |
|
44 | 32 | 1. Go to the OpenC3 Admin Tool, Plugins Tab |
45 | | -1. Click the install button and choose your plugin.gem file |
46 | | -1. Fill out plugin parameters |
47 | | -1. Click Install |
48 | | - |
49 | | -## Contributing |
50 | | - |
51 | | -We encourage you to contribute to OpenC3! |
52 | | - |
53 | | -Contributing is easy. |
54 | | - |
55 | | -1. Fork the project |
56 | | -2. Create a feature branch |
57 | | -3. Make your changes |
58 | | -4. Submit a pull request |
59 | | - |
60 | | -Before any contributions can be incorporated we do require all contributors to agree to a Contributor License Agreement |
61 | | - |
62 | | -This protects both you and us and you retain full rights to any code you write. |
| 33 | +2. Click Install and choose the `.gem` file |
| 34 | +3. Fill out plugin parameters and click Install |
63 | 35 |
|
64 | 36 | ## License |
65 | 37 |
|
66 | | -This OpenC3 plugin is released under the MIT License. See [LICENSE.md](LICENSE.md) |
| 38 | +Released under the MIT License. See [LICENSE.md](LICENSE.md). |
0 commit comments