Orbital Simulation of a Satellite Around Earth

This case study demonstrates how Ascoos OS can simulate a satellite in circular orbit around Earth. It calculates key physical quantities and stores the results in JSON, while also generating visual output.

Purpose

• Calculate orbital velocity
• Compute kinetic and potential energy
• Generate chart with computed values
• Log completion event
• Save report in JSON format

Core Ascoos OS Classes

• TPhysicsHandler Performs physics calculations (velocity, energy, etc.)
• TArrayGraphHandler Generates chart from computed values
• TEventHandler Logs system events
• TErrorMessageHandler Handles exceptions and error messages

File Structure

The implementation is contained in a single PHP file: - orbital_simulation.php

It includes all logic: calculations, visualization, logging, and data export.

Requirements

1. PHP ? 8.2
2. Installed Ascoos OS or AWES 26

Execution Flow

1. Define physical parameters (mass, radius, gravitational constant).
2. Calculate orbital velocity using: `v = ?(GM / r)`
3. Compute kinetic energy: `K = ½ m v²`
4. Compute potential energy: `U = -GMm / r`
5. Generate chart with values
6. Log completion event
7. Save JSON report
8. Output summary to console

Code Example

$orbitalVelocity = $physicsHandler->OrbitalVelocity($G, $earthMass, $orbitalRadius);
$kineticEnergy = $physicsHandler->KineticEnergy($satelliteMass, $orbitalVelocity);
$potentialEnergy = -$G $earthMass $satelliteMass / $orbitalRadius;

$graphHandler->setArray([
    ['label' => 'Orbital Velocity (m/s)', 'value' => $orbitalVelocity],
    ['label' => 'Kinetic Energy (J)', 'value' => $kineticEnergy],
    ['label' => 'Potential Energy (J)', 'value' => $potentialEnergy]
], ['label', 'value']);
$graphHandler->createLineChart($outputPath . '/orbital_simulation.png');

Expected Output

Orbital Simulation Complete.
Orbital Velocity: 7672.598648 m/s
Kinetic Energy: 29440800000 J
Potential Energy: -58881600000 J

Resources

• Ascoos OS Documentation
• ASCOOS
• AWES
• GitHub Repository

Contribution

You can extend the simulation to include elliptical orbits, variable mass, or multi-body interactions. See CONTRIBUTING.md for guidelines.

License

This case study is covered under the Ascoos General License (AGL). See LICENSE.md.