Skip to content
This repository was archived by the owner on Apr 7, 2026. It is now read-only.

PaoloRos/orbital-debris-management

Repository files navigation

Debris Detection Project

Documentation

View the documentation.

Advanced Programming Course, Università di Trento

Authors: Paolo Rossi, Leonardo Marzari

Date: 28/04/2025

Purpose And Software Structure

This software is designed to manage the collection of three debris categories across three different orbits. Specifically, the program handles debris population on each orbit, collector deployment, subsequent collection operations, and final result reporting.

After installation, the application allows users to either:

  • run a built-in functionality test (with default debris population), returning only a success/failure message;
  • execute the full collection workflow by providing input values for each debris type on each orbit.

Usage Instructions

  1. Installation: compile the project from the command line with one of the following targets:

    make
    make all
    make DebrisDetection
    

    These commands generate the executable file.

  2. Test: verify that the software works correctly by running:

    make test
    

    This command prints a message indicating whether the test passed.

  3. Input parameters: set the number of debris items by type and by orbit in parameters.txt, using the expected format:

    ==== Orbit __ ====
    Debris:__
    ProprietaryDebris:__
    CriticalDebris:__
    

    If a parameter is omitted, a default integer value of 10 is used for that debris entry.

    If the file is accidentally altered, or if negative integers, decimal values, or non-numeric characters are provided, the corresponding debris entry is set to the default value 10.

  4. Run: start the mission from the command line with:

    make run
    

    This prints the operation flow to the terminal and writes collection results to log.txt.

  5. Uninstall/Cleanup: remove executables and generated artifacts with:

    make clean
    

About

Orbital debris simulation and management.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors