2.8 KiB
satnogs-wut
The goal of satnogs-wut is to have a script that will take an observation ID and return an answer whether the observation is "good", "bad", or "failed".
Good Observation
Bad Observation
Failed Observation
Machine Learning
The system at present is build upon the following:
- Debian
- Tensorflow
- Keras
Learning/Testing, results are inaccurate.
wut?
The following scripts are in the repo:
wut
--- Feed it an observation ID and it returns if it is a "good", "bad", or "failed" observation.wut-api-test
--- API Tests.wut-get-obs
--- Download the JSON for an observation ID.wut-get-staging
--- Download waterfalls to staging for review (deprecated).wut-get-train-bad
--- Download waterfalls todata/train/bad
for review (deprecated).wut-get-train-good
--- Download waterfalls todata/train/good
for review (deprecated).wut-get-validation-bad
--- Download waterfalls todata/validation/bad
for review (deprecated).wut-get-validation-good
--- Download waterfalls todata/validation/good
for review (deprecated).wut-get-waterfall
--- Download waterfall for an observation ID todownload/[ID]
.wut-get-waterfall-range
--- Download waterfalls for a range of observation IDs todownload/[ID]
.wut-ml
--- Main machine learning Python script using Tensorflow and Keras.wut-review-staging
--- Review all images indata/staging
.
Usage
The main purpose of the script is to evaluate an observation, but to do that, it needs to build a corpus of observations to learn from. So many of the scripts in this repo are just for downloading and managing observations.
The following steps need to be performed:
-
Download waterfalls and JSON descriptions with
wut-get-waterfall-range
. These get put in thedownloads/[ID]/
directories. -
Organize downloaded waterfalls into categories (e.g. "good", "bad", "failed"). Note: this needs a script written. Put them into their respective directories under:
data/train/good/
data/train/bad/
data/train/failed/
data/validation/good/
data/validataion/bad/
data/validataion/failed/
-
Use machine learning script
wut-ml
to build a model based on the files in thedata/train
anddata/validation
directories. -
Rate an observation using the
wut
script.
Caveats
This is the first machine learning script I've done, I know little about satellites and less about radio, and I'm not a programmer.
Source License / Copying
Main repository is available here:
License: CC By SA 4.0 International and/or GPLv3+ at your discretion. Other code licensed under their own respective licenses.
Copyright (C) 2019, 2020, Jeff Moe