FOUND is a system that Earth satellites can use to calculate their orbits using pictures taken by the satellite of Earth. It is being developed at Husky Satellite Lab, a CubeSat team at the University of Washington. It will be deployed and tested on HuskySat-2, the team's next mission.
If you are using Windows, we recommend downloading Windows Subsystem for Linux, and following the instructions for Linux.
For Linux Ubuntu/Oracle (uses either apt-get or yum) obtain the required packages for this software:
- Copy the install script into your environment: Link to install script
- Change permissions for the install script to execute (
sudo chmod +rwx install.sh) - Run the install script in root/sudo as an executable (
sudo ./install.sh) For macOS, install the following dependencies (I recommend using Homebrewbrewto install this): - Unix-like Dependencies:
git g++ make cmake wget tar valgrind python3 python3-pip doxygen graphviz - Python Dependencies:
gcovr cpplint
- Clone this repository (
git clone https://github.com/UWCubeSat/found.git) - Go into the directory (
cd found) - Compile the executable (
make) - Execute the executable (
./build/bin/found) - Execute the test suite (
./build/bin/found-test)
If you modify the local copy of this repository, only the last 2 instructions need to be repeated (unless you have cd'ed into another folder)
FOUND is still in development! Come back in about 3 to 6 months to see how to run FOUND.
FOUND will have the following components/modules, which all function together produce an orbital projection for a given satellite.
After images from a satellite are received, their images are parsed to locate Earth's horizon in the image. FOUND will be capable of:
- Simple Edge Detection via Simple Thresholding
- Laplacian of Gaussian (LoG) Filtered Edge Detection
The edge information is then used to evaluate the relative size of Earth in the image and find the distance of the satellite from Earth using principals of scale. FOUND will be capable of:
- Distance Determination with a Spherical Earth Assumption
- Distance Determination with an Ellipsoid Earth Assumption
The distance information will then be used to form a vector of the satellite relative to Earth's coordinate axes. FOUND will be capable of:
- Star-Tracker Assisted Vector Generation via LOST
- Feature Detection Assisted Vector Generation (to be developed for future mission)
This stage takes multiple vectors of the satellite at different points in the satellite's orbit to project the satellite's future path of travel. FOUND will be capable of:
- Stable Elliptical Orbit Determination
- Preceding Elliptical Orbit Determination
This stage then takes the projected path of travel and matches it to the speed of the satellite, providing the position and velocity vectors of the satellite at any future time. FOUND will be capable of:
- Eulerian-based Kinematic Profiling
- Keplerian-based Kinematic Profiling