1. add README for windows. 2. rewrite some python scripts and bat-files according to windows requirements. 3. Create tm_brd_parser.py and tm_wheel_parser.py for demonstration how to work with data in python

This commit is contained in:
2025-06-09 20:05:35 +03:00
parent b2380a2d6e
commit ab2a3e8b53
13 changed files with 278 additions and 196 deletions

View File

@@ -6,24 +6,26 @@ This project contains tools for decoding, converting, and visualizing telemetry
- **Project structure**
- **Requirements**
- ** Linux Setup**
- ** Windows 10 Setup**
- **Linux Setup**
- **Windows 10 Setup**
- **Using the tools**
- *Plot all ASOTR data*
- *Plot ASOTR data in specified date borders (for MVN reports)*
- **Contacts**
**Note 1**: \<PATH_TO_MVN_FLIGHT\> - path where is mvn_flight scripts is cloned from heagit
**Note 2**: \<PATH_TO_ASOTR_DATA\> - path with raw MVN ASOTR data
**Note 3**: \<PATH_TO_MVN_DATA\> - path with raw MVN data
**Note 2**: \<PATH_TO_ASOTR_DATA\> - path with raw MVN ASOTR data
## Project structure
-> `/bin/` - ready-to-use binary files and python scripts for assembling, extracting and plotting telemetry data
--> `/bin/asotr_unzip_plot.sh` or `/bin/asotr_unzip_plot.bat` — scripts to automate the unpack-convert-plot chain for Linux/Windows.
--> `/bin/asotr_unzip_plot.sh` or `/bin/asotr_unzip_plot.bat` — scripts to automate the unpack-convert-plot chain ASOTR data (Linux/Windows).
--> `/bin/plot_flight_borders.py` — Python script to generate plots from CSV data.
-> `/asotr_csv/` — binary parser to collect data from raw ASOTR data to CSV. This parser written using the Rust language. For more informatin see documentation in `/asotr_csv/README.markdown`).
-> `/data/` — folder containing processed CSV files.
-> `/plots/` — folder where output plots are saved.
--> `/bin/plot_flight_borders.sh` or `/bin/plot_flight_borders.bat` - scripts to automate plot generations for MVN reports
--> `/bin/tm_brd_parser.py` - python script for demostration processing BRD telemetry data (1 Hz evolution)
--> `/bin/tm_wheel_parser.py` - python script for demostration processing BRD wheel telemetry data
-> `/asotr_csv/` — binary parser to collect data from raw ASOTR data to CSV. This parser written using the Rust language. For more informatin see documentation in `/asotr_csv/README.markdown`).
-> `/data/` — folder containing processed CSV files.
-> `/plots/` — folder where output plots are saved.
## Requirements
- Python version 3.10 or upper. For checking type:
@@ -31,21 +33,11 @@ This project contains tools for decoding, converting, and visualizing telemetry
python3 --version
```
Python dependencies:
```bash
pip install matplotlib pandas
```
- Rust compiler version 1.83.0 or upper. For checking type:
```bash
rustc --version
```
Additional tools (Linux only):
```bash
sudo apt install unzip git
```
## Linux Setup
1. Clone the repo to your computer:
```bash
@@ -56,7 +48,7 @@ git clone http://heagit.cosmos.ru/gamkov/mvn_flight.git
```bash
sudo apt update
sudo apt install python3 python3-pip
pip3 install matplotlib pandas
pip3 install matplotlib pandas openpyxl scipy
```
1. Install Rust compiler (if you do not have):
@@ -74,7 +66,7 @@ git clone http://heagit.cosmos.ru/gamkov/mvn_flight.git
3. Open CMD and install python dependencies:
```cmd
pip install matplotlib pandas
pip install matplotlib pandas openpyxl scipy
```
4. Install Rust compiler (if you do not have):
@@ -87,23 +79,41 @@ For more detailed information you can go to: https://doc.rust-lang.ru/book/ch01-
### Plot all ASOTR data
1. Donwload data from science data server to directory \<PATH_TO_ASOTR_DATA\>.
If you don't have MVN data, you might download it from server with science SRG data (IP: 193.232.11.95).
For questions about downloading science data contact Shtykovsky A. (a.shtykovsky@cosmos.ru) or Chelovekov I. (chelovekov@cosmos.ru)
For questions about downloading science data contact Shtykovsky A. (a.shtykovsky@cosmos.ru) or Chelovekov I. (chelovekov@cosmos.ru)
Linux (for example):
```
sftp username@IP_address
cd mvn/data/data/2025
get -r 20250101*
```
Windows:
```
Open filezilla
connect to sft server
get data from: /export/home/user_name/mvn/data/data/2025
```
2. Parse all raw data from ASOTR into csv files and plot all csv data:
Linux:
```bash
./bin/asotr_unzip_plot.sh <PATH_TO_ASOTR_DATA>/
cd bin
./asotr_unzip_plot.sh <PATH_TO_ASOTR_DATA>/
```
Windows:
```cmd
.\bin\asotr_unzip_plot.bat <PATH_TO_ASOTR_DATA>\
cd bin
asotr_unzip_plot.bat <PATH_TO_ASOTR_DATA>\
```
csv data will be in directory:
```cmd
./data/asotr/
/data/asotr/
```
### Plot ASOTR data in specified date borders (for MVN reports)
@@ -113,12 +123,14 @@ csv data will be in directory:
Linux:
```bash
./bin/plot_flight_borders.sh ../data/asotr/ 10.03.2025_00:00:00 23.04.2025_23:59:59
cd bin
./plot_flight_borders.sh ../data/asotr/ 10.03.2025_00:00:00 23.04.2025_23:59:59
```
Windows:
```cmd
.\bin\plot_flight_borders.bat ..\data\asotr\ 10.03.2025_00:00:00 23.04.2025_23:59:59
cd bin
plot_flight_borders.bat ..\data\asotr\ 10.03.2025_00:00:00 23.04.2025_23:59:59
```
where: