Editing SimTX API/Satellites (section)

== Deorbit ==
Deorbiting is a retrograde burn, not a deletion, and it cannot be undone.
* '''Preview.''' <code>POST /api/v1/stations/{id}/deorbit/preview</code> returns the [[SimTX API/Data types#Deorbit|deorbit]] that a burn fired now would produce (burn time, reentry time and place, delta-v, and the post-burn orbit) without changing anything. Use it to confirm with the user.
* '''Burn.''' <code>POST /api/v1/stations/{id}/deorbit</code> fires it. The burn takes the satellite's state at the burn time and lowers its speed along the velocity vector until the new orbit's perigee is 100 km below the surface. Position is continuous; the velocity change is the burn. The stored orbit is replaced by the post-burn elements (epoch = burn time) and the satellite becomes <code>DEORBITING</code>.
* '''Falling.''' While deorbiting, the satellite works normally on its falling orbit: tickets, sessions, the station list, ephemerides and passes. Sessions bound to it receive [[SimTX API/Packets/SessionStatus|SessionStatus]] <code>UPDATED</code> with <code>UPDATE_REASON_DEORBIT_SCHEDULED</code> and the new elements.
* '''Reentry.''' The satellite reenters at <code>reentry_at_ms</code>, the first time after the burn that its height drops below 80 km, above <code>reentry_point</code>. The servers then end its sessions with <code>ENDED</code> and the reason ''Satellite burned up on reentry'', and the account service marks it <code>DEORBITED</code>.
* '''Clients''' stop drawing the satellite at <code>reentry_at_ms</code> and cut ground tracks there. They draw the fall from the post-burn elements and never re-plan the burn themselves.

Typical results:

{| class="wikitable"
! Orbit !! Delta-v !! Time to reentry
|-
| LEO 550 km || 189 m/s || 29 min
|-
| Geostationary || 1,506 m/s || 5.15 h
|-
| Molniya, burn at apogee || 62 m/s || 5.8 h
|-
| Molniya, burn at perigee || 2,614 m/s || 29 min
|}

Deorbiting satellites count towards the owner's satellite quota until they reenter. A deorbited satellite can then be deleted.

{{SimTX API navbox}}
[[Category:SimTX API]]