PatchedConicSolver

From KSP 2 Modding Wiki

PatchedConicSolver is a class that is part of Orbiter objects. It is used to capture, generate, update, and provide access to patched conics information relating to the Orbiter object it is associated with. The PatchedConicSolver class has the following public members.

Namespace: KSP.Sim.impl

PatchedConicSolver.MaxTotalPatches

Type: int

The maximum limit on the number of patches. The default value = 10. This member can be get, but not set.

PatchedConicSolver.Orbiter

Type: OrbiterComponent

The ObiterComponent object this class is associated with. This member can be get, but not set.

PatchedConicSolver.CurrentTrajectory[index]

Type: List<PatchedConicsOrbit>

A list of PatchedConicOrbits. May be given an index to obtain a particular trajectory. It’s basically a list of all the trajectories currently associated with this Orbiter object, and you can do things with it like any list. The length of the list will be no longer than MaxTotalPatches, with list members being chronologically organized from the patch that occurs first to the last patch. Unused members are null. This member can be get, but not set.

PatchedConicSolver.PatchesAhead

Type: int

The number of patches ahead. This member can be get or set. It is set in the private method PatchedConicSolver.CalculatePatchList()

PatchedConicSolver.OnDestroy()

Called by: TBD

The PatchedConicSolver.OnDestroy() method first tests to see if the Orbiter object is null. If it is, then it returns immediately. Otherwise, it will remove the handler for OnReferenceBodyChange which was added by the OnStart method.

PatchedConicSolver.OnStart()

Called by: VesselComponent.OnStart(double)

The PatchedConicSolver.OnStart() method adds a new handler for the Orbiter.OnReferenceBodyChange method so that OnReferenceBodyChange will be called when necessary. It then sets the private _patchLimit to be the max of PersistentProfileManager.ConicPatchLimit and 1, adds this.Orbiter.PatchedConicsOrbit to the CurrentTrajectory list, and similarly adds any remaining patches from 1 to MaxTotalPatches.

PatchedConicSolver.OnUpdate()

Called By: VesselComponent.OnUpdateOrbit()

The PatchedConicSolver.OnUpdate() method first calls PatchedConicSolver.SetPatchesInactive, then calls private methods for InitializeFirstPatch() and CalculatePatchList() to ensure the patches are updated.
NOTE: When called by VesselComponent.OnUpdateOrbit(), this method is called before calling orbiter.ManeuverPlanSolver.OnUpdate().

PatchedConicSolver.SetPatchesInactive(List<PatchedConicsOrbit>, int)

Called By: OnUpdate, ManeuverPlanSolver.UpdateManeuverTrajectory()

The PatchedConicSolver.SetPatchesInactive() method accepts a list of patches (i.e., CurrentTrajectory) and (optionally) a starting index for the list (defaults to 0). For each list member from the starting index to the end of the list, the member's ActivePatch property is set to false.
NOTE: When called by ManeuverPlanSolver.UpdateManeuverTrajectory(), this method is called after calling ManeuverPlanSolver.SetPatchesInactive

PatchedConicSolver.SetTarget(CelestialBodyComponent)

Called By: VesselComponent.TargetObject

The PatchedConicSolver.SetTarget() method accepts a CelestialBodyComponent and uses that to set the private _targetBody property.

PatchedConicsOrbit.FindPatchContainingUT(double)

Called By: OrbitalReadoutInstrumentManager.Update(), ManeuverPlanComponent.IsValidNode(), ManeuverPlanComponent.UpdateNodeDetails(), ManeuverPlanComponent.GetManeuverNodeBurnDirVector(), and ManeuverPlanComponent.SolveManeuver()

The PatchedConicsOrbit FindPatchContainingUT() method accepts a double (the universal time of interest) and returns the PatchedConicOrbit for the patch associated with that time.

PatchedConicsOrbit.DecreasePatchLimit()

Called By: TBD

The PatchedConicsOrbit.DecreasePatchLimit() method decreased the current setting of the private _pathcLimit property by 1 to a value that is never less than 1.

PatchedConicsOrbit.IncreasePatchLimit()

Called By: TBD

The PatchedConicsOrbit.IncreasePatchLimit() method increases the current setting of the private _pathcLimit property by 1 to a value that is never more than 5.

PatchedConicsOrbit.RefreshPatchLimit()

Called By: GameplaySettingsMenuManager.ApplyConicPatchLimit()

The PatchedConicsOrbit.RefreshPatchLimit() method clamps the current setting of the private _pathcLimit property to be between 1 and 5 inclusively.

PatchedConicsOrbit.SolverParameters

Called By: PatchedConics.GetClosestApproach(), PatchedConics.EncountersBody(), PatchedConics.CheckEncounter()

Used By: ManeuverPlanSolver, PatchedConicSolver

The PatchedConicsOrbit.SolverParameters class defines the parameters needed for the solver with default values assigned to maxGeometrySolverIterations (25), maxTimeSolverIterations (50), and outerReaches (1E+20).