Collinear Lagrange Point Solutions in the Circular Restricted Three-Body Problem with Radiation Pressure using Fortran
A Fortran collinear Lagrange points calculator.
- Background
- Key Files
- Software Requirements
- Quality Assurance
- Getting Started
- Acknowledgements
- References
- Citation
- License
ForCLaP (Fortran Collinear Lagrange Points) is a Fortran command line application demonstrating Newton-Raphson convergence on collinear solutions to the circular restricted three-body problem. Optional displacement of the collinear Lagrange points due to radiation pressure, relevant to small bodies such as asteroidal dust particles, is incorporated.
ForCLaP assumes a traditional three-body system with a large, central primary (m1), a smaller secondary (m2) and an infinitesimal tertiary mass (m3). ForCLaP accepts a user-input value for the m1/m2 mass ratio of the system. Use of a mass ratio within the Routh value limit, is enforced however.
ForCLaP also accepts a user-input value for a ratio of solar radiation pressure to gravitational force experienced by m3, β. This allows simulation of a luminous primary such as the Sun, but ForCLaP can just as easily be used for simulation of a non-luminous primary, such as planet, with an input ratio, β, of zero.
Collinear Lagrange point solution calculation is done with a Newton-Raphson algorithm. The program therefore inherits limitations of that algorithm. The algorithm can suffer runaway solution divergence, for example, but ForCLaP explicitly flags this and provides graceful algorithm termination. For algorithm convergence, iteration continues until the solution and the Newton derivative are both stable to four significant figures.
Locations of the Collinear Lagrange Points in the Circular Restricted Three-Body Problem with Radiation Pressure
Formulas for the locations of the collinear Lagrange points L1, L2 and L3 are given below. Symbol definitions and explanatory theory are given in [1].
| File | Notes |
|---|---|
src/forclap.f90 |
Fortran program. |
| Software | Notes |
|---|---|
| Fortran | Details here. Free and proprietary compilers available. |
Tip
Is Fortran already installed? It's sometimes bundled with other software. Strawberry Perl, for example, includes GNU Fortran (GFortran). Installation can be checked from the command line. E.g., for GFortran on Linux, macOS or Windows:
gfortran --version
ForCLaP has been tested in the following environments.
Windows 11, GFortran 14.3.0
| Type | Component | Version |
|---|---|---|
| Platform | Operating system | Windows 11, 26H2 (OS Build 26300.9550) |
| Software | GNU Fortran | 14.3.0 |
Windows 11, GFortran 16.2.0
| Type | Component | Version |
|---|---|---|
| Platform | Operating system | Windows 11, 26H2 (OS Build 26300.9550) |
| Software | GNU Fortran | 16.2.0, run from MSYS2 version 20260611, UCRT64 shell |
Program source code requires compilation on the target system with a Fortran compiler. E.g., for GFortran:
gfortran src/forclap.f90 -o forclap -fimplicit-none
| Compiler Flag | Notes |
|---|---|
-o |
Name of the output file. |
-fimplicit-none |
Forces all variables to be declared. |
The compiled Fortran program should be executed from a command line. Execution syntax for some example command lines is given below.
./forclap
forclap
Microsoft Copilot [2] was used as a licensing management aid.
-
T. N. Stenborg, "Collinear Lagrange Point Solutions in the Circular Restricted Three-Body Problem with Radiation Pressure using Fortran", in Astron. Data Anal. Softw. Syst. XVII, in Astronomical Society of the Pacific Conference Series, vol. 394, R. W. Argyle, P. S. Bunclark and J. R. Lewis, Eds., 2008, pp. 734–737.
View PDF View at publisher SciX -
Microsoft Copilot. (2026). Microsoft. Accessed: 24 September 2026. [AI model output, Microsoft Copilot application (cloud‑based service)] Available: Download the Microsoft Copilot app.
Citation details are available by clicking Cite this repository in the GitHub sidebar.
This repository is licensed under the BSD-3-Clause license. Details are available in the LICENSE file.