Skip to content

radio-satellites/RoseyCubesat-1-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RoseyCubesat-1-tools

cubsat

Decode data from RoseyCubesat-1!

Check out --help/-h for parameters.

How to decode:

You need to have some frames from RoseyCubesat-1 to decode. The script reads Satnogs DB frames from a file that you specify with --source_file/-f, and then dumps the output imagery into the directory the script is placed in.

This is very much a work-in-progress and things may change! So, if you do have issues, please open an issue, I will try to help you to the best of my abilties!

Example decode:

  1. Make sure that you have a file with SatNogs-exported imagery data in it.
  2. Install dependencies with pip3 install -r requirements.txt.
  3. Run python3 decoder.py -f <file path> -o <output name>. You can also specify a start date with -s and an end date with -e. Additionally, if required, you may clip the preview frames with -rp and add false-color composites with -fc. Check out -h for more parameters and explanations.
  4. You should have imagery!

[ADVANCED USE] Bulk imagery processing

Given a SatNOGS CSV file, bulk_convert.py takes the file and extracts every image in it. Since the script depends on the imagery decoder, you will have to specify the decoder path and python interpreter.

Credits, thanks, roadplan, etc!

Special thanks to Daniel Davidson for prettifying the code and adding argument and filtering functionality! My grammar tends to break down when writing READMEs...

Current plans include:

  • Getting preview imagery decoded. This tool currently only decodes full-scale imagery. Sometimes, though, there are dumps that appear to contain smaller-sized imagery. However, the amount of data transfered and the expected image file size don't match...

About

Decode data from RoseyCubesat-1!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages