spacecruft

strf

History

Fabian P. Schmidt 597ee64e32 Remove erroneously added files The API Token was invalidated ages ago.		2023-01-13 17:33:07 +01:00
..
README.md	contrib/README: Fix typo	2023-01-13 17:33:07 +01:00
analyze_artifact.py	Always plot measurement results	2021-11-20 08:20:22 +01:00
download_satnogs_artifact.py	Add SatNOGS Artifact Analysis (WIP)	2021-11-20 06:45:55 +01:00
download_satnogs_tle.py	Add SatNOGS Artifact Analysis (WIP)	2021-11-20 06:45:55 +01:00
find_good_satnogs_artifacts.py	contrib: Add SatNOGS artifacts download helpers	2021-09-04 01:26:43 +02:00
plot_spectrum.py	contrib: Add python script 'plot_spectrum'	2018-11-09 03:17:30 +01:00
requirements.txt	contrib: Fix/Update dependencies	2023-01-13 17:33:07 +01:00
satnogs_waterfall_tabulation_helper.py	contrib: Add satnogs waterfall tabulation helper	2021-09-04 01:26:06 +02:00
settings.py	Rename OBS_DIR to SATNOGS_DOPPLER_OBS_DIR	2021-11-20 06:39:52 +01:00
spectrum_parser.py	Fix bug reading number of channels	2019-06-17 23:46:58 +02:00
spectrum_plot.py	contrib: Add python script 'plot_spectrum'	2018-11-09 03:17:30 +01:00

README.md

STRF contrib Scripts

Installation

Create Pyhton virtual environment and install dependencies via pip:
```
mkvirtualenv strf
pip install -r contrib/requirements.txt
```
Create initial configuration from env-dist
```
cp env-dist .env
```
Configure the data paths (they must already exist!) and add your SatNOGS DB API Token in .env

Find good observations with SatNOGS artifacts

$ ./contrib/find_good_satnogs_artifacts.py

Download SatNOGS Artifacts

$ ./contrib/download_satnogs_artifact.py 4950356
Artifact Metadata for Observation #4950356 found.
Artifact saved in /home/pi/data/artifacts/4950356.h5

Download SatNOGS Observation TLEs

To add the TLE used in a specific SatNOGS Observation to your catalog, the following command can be used:

$ ./contrib/download_satnogs_tle.py 4950356
TLE saved in /home/pi/data/tles/satnogs/4950356.txt

Plot SatNOGS Artifacts

This can be done using spectranalysis.

Ultra-Short Analysis Guide

source .env

OBSERVATION_ID=4950356
./contrib/download_satnogs_tle.py $OBSERVATION_ID
./contrib/download_satnogs_artifact.py $OBSERVATION_ID
./contrib/analyze_artifact.py --observation_id $OBSERVATION_ID --site_id 977
rffit -d "$SATNOGS_DOPPLER_OBS_DIR/$OBSERVATION_ID.dat" -c "$SATNOGS_TLE_DIR/$OBSERVATION_ID.txt" -i 27844 -s 977

$ ./contrib/download_satnogs_tle.py 4950356
TLE saved in /mnt/old_home/kerel/c4/satnogs/data/tles/satnogs/4950356.txt
$ ./contrib/download_satnogs_artifact.py 4950356
Artifact Metadata for Observation #4950356 found.
Artifact saved in /mnt/old_home/kerel/c4/satnogs/data/artifacts/4950356.h5
$ ./contrib/analyze_artifact.py --observation_id 4950356 --site_id 977
Load /mnt/old_home/kerel/c4/satnogs/data/artifacts/4950356.h5
Extract measurements...
Data written in /mnt/old_home/kerel/c4/satnogs/data/doppler_obs/4950356.dat
$ rffit -d ${SATNOGS_DOPPLER_OBS_DIR}/4950356.dat -c ${SATNOGS_TLE_DIR}/4950356.txt -i 27844 -s 977