Allow custom meshes & rotations

[gomezzz]

Description

Summary of changes

• Added docs how to use custom central bodies
• Added ReferenceFrame enum for convenience
• Added new CentralBody class to wrap either pykep Earth, custom meshes etc.
• Added ActorBuilder function set the central body
• Provided access to central body via actor to user
• Add utility code for rotations and intersection checks with meshes and spheres
• Refactor old eclipse and line of sight code
• Refactored get_communication_window.py for readability
• Removed some redundant code. The ISL checks as described in Inter-satellite link model #149 can now be done via setting a custom central body (basically an Earth with a larger radius)
• Adapted visualization for meshes
• Minor refactoring

Resolved Issues

• fixes Allow other central bodies #60

How Has This Been Tested?

• New test for loading mesh
• New test for rotation
• New test for line of sight
• New test for eclipse computation
• CI / CD

Related Pull Requests

N/A

Visualization with mesh looks like this

@schuhmaj @rasmusmarak Your comments would also be appreciated 🙏

ToDos

• Doublecheck interaction with thermal model
• Create a Mars example in the README
• Formulate an issue for central bodies around Earth like the Moon etc.
• Search code for appearances of Earth to doublecheck we caught all hard-coded assumptions
• Check ground stations are correctly denied for non-Earth
• Remove magic number from mesh readme

[github-actions]

Coverage Report

File	Stmts	Miss	Cover	Missing
paseos
__init__.py	33	1	97%	49
paseos.py	144	12	92%	67–68, 145–146, 203, 218, 236, 245, 263, 294, 302–305
paseos/activities
activity_manager.py	43	3	93%	46, 74, 157
activity_processor.py	58	1	98%	121
activity_runner.py	62	10	84%	80–84, 104–113, 122–125
paseos/actors
actor_builder.py	177	27	85%	22–28, 31, 221–223, 250–252, 297–306, 445, 502, 530, 542–546, 553–554, 561–562
base_actor.py	128	18	86%	82, 104, 120, 167, 207–209, 230, 239, 256, 277, 283–286, 292, 307, 362
ground_station_actor.py	15	3	80%	47–53
spacecraft_actor.py	61	1	98%	123
paseos/central_body
central_body.py	65	5	92%	68, 177–178, 186–187
is_in_line_of_sight.py	58	12	79%	106–123, 167, 187
mesh_between_points.py	35	2	94%	64, 72
sphere_between_points.py	26	8	69%	35–38, 48–51, 63–64
paseos/communication
get_communication_window.py	23	2	91%	38, 64
paseos/power
charge_model.py	16	1	94%	49
discharge_model.py	7	2	71%	22, 34
paseos/tests
activity_test.py	57	3	95%	90, 93–94
communication_window_test.py	49	1	98%	176
eclipse_test.py	10	1	90%	20
import_test.py	6	1	83%	13
init_test.py	8	1	88%	16
line_of_sight_test.py	62	4	94%	143–146
mesh_test.py	119	3	97%	118, 136, 144
thermal_model_test.py	30	1	97%	61
visualization_test.py	18	1	94%	28
paseos/utils
check_cfg.py	61	18	70%	31, 40, 46, 60–62, 67, 70–72, 75–77, 80–82, 98, 103
operations_monitor.py	71	3	96%	127–130
paseos/visualization
animation.py	18	6	67%	27–30, 35, 44
plot.py	9	3	67%	29–32
space_animation.py	215	23	89%	108–109, 124, 147–148, 182, 206–213, 219, 329, 352–354, 359, 368–369, 373, 409, 415–416, 447, 461–472
TOTAL	2151	177	92%

Tests	Skipped	Failures	Errors	Time
36	0 💤	0 ❌	0 🔥	1m 5s ⏱️

[schuhmaj]

Great work! I like that some of the previous free functions moved inside the actor class - which facilities the usage for the user. The CentralBody class and associated functions look fine as well.

Otherwise some minor comments for the wine 🍷algorithm. (and to the already pointed out magic number, but now in the test cases)

[schuhmaj]

Magic Scaling number as a constant to the top of the file?

[gomezzz]

added a comment ✌️

[rasmusmarak]

Looks great, well done!✌️