OHM LagrangeMFD 1.5 for Orbiter 2010

OrbitHangar

Addon Comments
Joined
Apr 9, 2008
Messages
3,832
Reaction score
13
Points
0

Author: adswnj

Lagrange MFD is an Orbiter 2010 MFD utility to allow you to explore the Lagrange points of Sun-Earth, and Earth-Moon. It's based on a highly accurate state integrator designed by Keith Gelling. 

V1.5 version has much more capability to plot Lissajous orbits in 3 dimensions, including rotating around the stabilized axes to visualize your orbit even more precisely. 

This utility plots your orbit in 3 dimensions, with pan and zoom, and the ability to reference different focus points. You can then predict a hypothetical burn, to achieve an encounter with one of the Lagrange points. The autopilot helps with orientation, burns, and station-keeping. 

Thanks to Keith "Keithth G" Gelling for his guidance and teamwork putthing this together. 
Thanks to Dimitris “dgatsoulis” Gatsoulis, Brian “Brian J” Jones, ZT “Nicholas Kang” Kang for testing support. 
Thanks to Szymon “Enjo” Ender for ModuleMessagingExt co-developent, for MFDButton framework, and his technical assistance. 



DOWNLOAD
 

ADSWNJ

Scientist
Addon Developer
Joined
Aug 5, 2011
Messages
1,667
Reaction score
3
Points
38
Interested in any feedback on the install and run, especially from any Linux/WINE emulation people. This is a VC++ 2015 statically compiled DLL (i.e. no hassles with runtimes), so I'm interested if latest WINE can run this.
 

dgatsoulis

ele2png user
Donator
Joined
Dec 2, 2009
Messages
1,924
Reaction score
340
Points
98
Location
Sparta
I'll be posting one soon. I had it lined up for next Monday, but I'll see what I can do to make it sooner. Is there any particular transfer you'd like to see first (ie KSC → E-M L1 or LEO → S-E L2, etc), or just general use of the MFD?
 

boogabooga

Bug Crusher
Joined
Apr 16, 2011
Messages
2,999
Reaction score
1
Points
0
Any plans to add L points for more planets?

Sun-Jupiter L4 and L5 might be interesting, in particular.
 

ADSWNJ

Scientist
Addon Developer
Joined
Aug 5, 2011
Messages
1,667
Reaction score
3
Points
38
Any plans to add L points for more planets?

Sun-Jupiter L4 and L5 might be interesting, in particular.

Possibly, but we've lost our chief physicist, so we need a replacement. Basically, we need some alpha values in order to support other planetary systems, and those need some Taylor expansion calcs.
 

NukeET

Gen 1:1
Addon Developer
Donator
Joined
Oct 16, 2007
Messages
1,035
Reaction score
93
Points
63
Location
UT_SLC
Website
sites.google.com
I'll be posting one soon. I had it lined up for next Monday, but I'll see what I can do to make it sooner. Is there any particular transfer you'd like to see first (ie KSC → E-M L1 or LEO → S-E L2, etc), or just general use of the MFD?

Perhaps just general use. In particular, once one is on course for a Lagrange point, how does one calculate delta V with respect to the point - so that you stay there after encounter?

I'll continue experimenting with it. Maybe I'll answer my own question.

:cheers:
 

ADSWNJ

Scientist
Addon Developer
Joined
Aug 5, 2011
Messages
1,667
Reaction score
3
Points
38
Perhaps just general use. In particular, once one is on course for a Lagrange point, how does one calculate delta V with respect to the point - so that you stay there after encounter?

I'll continue experimenting with it. Maybe I'll answer my own question.

:cheers:

Hi NukeET - it's very easy. Say you are in a standard orbit around Earth (as Jim Kirk world say), and you want to get out to Earth-Moon Lagrange 1, which is in line with Earth-Moon, about 80% of the way to the Moon. Just like doing any other altitude adjustment, you need to burn to create an elliptical orbit to reach up to the LP orbit (i.e. your apoapsis is at the LP altitude), and then when you are at the apoapsis, do a second burn to circularize your orbit on top of the Lagrange Point orbit.

As a quick example - open the Lagrange LEO to EML1 scenario from the Lagrange subdirectory. On the left, you'll see Lagrange, in ORBITmode. Blue blob up the top - that's Earth, and if you look carefully, a green orbit and a circle, representing our vessel. Down the bottom, you have the Moon in grey, and the E-M L1 point in purple.

Bring up Lagrange on the right MFD, and hit MOD twice to get to PLAN. You'll see that the plan is currently inactive, but there are values pre-set (i.e. Burn MJD at 51984.691869, for a 2935m/s prograde-only burn). Hit ARM. You will now see the ORBIT go red, and a path is plotted out to the Lagrange Point (actually, just overshooting, but good enough for a first burn).

Let's execute the burn: on the right MFD, hit MOD to bring up AUTOPILOT, and hit AB to set the Auto-Align and the Auto-Burn. You'll see that the burn start countdown has started, but it's 24,500 seconds away. Go ahead and hit T 3 times to warp up to 1000x. You'll see it automatically un-warp step by step as the time comes close. Also notice how the vessel has set to an absolute direction, which looks slightly inside the velocity vector on the start of the burn. This is normal, as by half way through the burn, we will be lined up on the velocity vector. Also notice as the burn is firing, we are back on a green line (live orbit) on the ORBIT display, so you are watching the progression of the live orbit out to the Lagrange point. As the calculation gets refreshed, you will see the encounter circles track across the orbits, as the integration engine constantly updates for a better orbit.

Once the burn is complete, you should have an orbit with an apoapsis fairly close to our target. On the right MFD, hit MOD three times to bring up ENCOUNTER. On my burn, it's predicting an encounter distance of 3.8Mm, with an encounter velocity of 650m/s. This means, if I don't do a 650m/s burn at the top of my orbit, I will fall down towards Earth again.

OK, let's lay in a second burn now. Press MOD, to go onto PLAN, where we have some more resolution on the encounter point. Mine shows:


  • Enc MJD ~= 51988.7007
    Pro dV ~= -485
    Out ~= 432
    PlC ~= 0.05

Press MJD, then ENT, then enter the encounter MJD and press return. I suggest you take off 0.01 of a MJD, to burn at approx 1000 secs prior to the encounter point, so you can then do some approach course corrections.

Press TDV, then ENT, then delete the number and replace with 0, and press return. (Quick way to zero all the axis dV's).

Press PRO, then ENT and enter the desired dV to null out your Enc dV. E.g. for me, I'm entering +500 (as the number is rising all the time I am typing this).

Press OUT, ENT, then enter your outward correction.

Now hit ARM, and admire your handiwork on the ORBIT display. You should see the orbit go linearly out to the encounter (just before, actually), then turn a sharp left and track just inside the LP orbit. On mine, the orbit was a little bit short and a bit 'skittish'. To fix this, on the right MFD, hit MOD twise (to S4I), then RCT and enter 0.4. This tells the engine to take approximately 10x longer to work out the answer, so it works it out with 10x finer resolution than before. The range is set at 5 days, but hit RNG and enter 8d to extend it out to 8 days, which gives you a better length tail on the orbit plot now.

On the right MFD, MOD 3 x to get back to plan, and let's see if we can fine tune a bit more. On mine, the biggest position error is on the Outward (at -6Mm, with an encounter dV of -30m/s). So I start by selecting OUT and hitting ++ and -- a couple of times. I immediately see that the Coarse setting is very coarse for this burn, so I hit ADJ to get to Fine setting, and then ++/-- looks much nicer. Now add some outward until the red plot line falls nicely on the LP track. On mine, I am now down to 4.1Mm away.

Work on OUT, PRO, and PLC depending on which has the bigger error. Each time, you are looking to reduce the error in position, whilst leaving the dVel reducing the error (e.g. 1.05Mm pos error, with a negative dVel is a good thing). One piece of advice: DON'T GO CRAZY. 1Mm error at this stage is just fine. When you have a good solution, MOD to AUTOPILOT, AB to burn it, and T a few times to warp ahead. 1000x should be good ... so you can watch the orbit develop.

One thing - the off-axis burns are not as accurate as I would like for this v1.0 release. There's a host of technical reasons, but just treat it as 90% good, and you'll be fine. This is also why I recommend burning say 1000 secs before the encounter point, and not obsessing over the last 1 km of accuracy, as the burn will not live up to your expectations! However, successive mid-course corrections (MCC's) will chop down your encounter error, so after a couple of MCC burns, you can get very accurately to the target.

If you ever notice on an autoburn countdown that you have a residual alignment error, then this was because you changed warp mid-alignment. To fix it, come out to warp back to 1x, then select ROT RCS mode, and nudge the vessel with one tap of thrust to get it moving again. The autopilot will then correct things for you.

OK, we are now past the encounter burn. Mine got me to 669 km distance and 68 m/s from the target. This is a perfect first burn. I now recommend switching to manual thrusters. However, note that in this gravitational space, Orbiter has decided that as neither Earth nore Moon has dominat gravity, it selects SUN as the Orbit reference. Let's fix that: SEL Orbit MFD, REF Earth, and hit HUD. Then SEL Lagrange again. Manually rotate to the velocity vector (note that the Prograde AP is not your friend here, because of the weird gravity, so do it manually).

Once aligned with the velocity vector, switch to LIN thrusters, and experiment tapping some RCS thrust whilst watching the ENCOUNTER screen Enc. Pos. settings. Your goal is to reduce the Encounter Position to under 50 km. Work the biggest error axis successively until you achieve this goal. Once achieved, warp time until you are within say 1000 seconds of the encounter.

Now work on your Encounter Velocity. You goal is to get it to say 20m/s or less, with the velocity sign acting to reduce the enc. pos. error.

Once your actual relative position is under 100km, and your relative velocity is under 20 m/s, it is time for the Auto-Hold AP. Hit MOD to select AUTOPILOT, and hit AH for AutoHold. Then hit MOD and go back to the ENCOUNTER screen, to watch as the AutoHold reels in the target. I find setting the encounter pos and vel like this before engaging the AH gives the best results.

Feel free to assist the autopilot with your own LIN RCS thrust to get to the target.

Congrats - you are now at EML1. Have a look around outside!!
 

dgatsoulis

ele2png user
Donator
Joined
Dec 2, 2009
Messages
1,924
Reaction score
340
Points
98
Location
Sparta
Was hoping for a tutorial or a video. Either or will do.

Perhaps just general use. In particular, once one is on course for a Lagrange point, how does one calculate delta V with respect to the point - so that you stay there after encounter?

I'll continue experimenting with it. Maybe I'll answer my own question.

:cheers:

Video showing a LEO to E-M L1 transfer, posted here.
 

Nicholas Kang

Tutorial Publisher
Tutorial Publisher
News Reporter
Joined
Apr 3, 2016
Messages
522
Reaction score
10
Points
18
Location
-
Last edited:

Nicholas Kang

Tutorial Publisher
Tutorial Publisher
News Reporter
Joined
Apr 3, 2016
Messages
522
Reaction score
10
Points
18
Location
-
Why not? That is the add-on used by dgatsoulis apparently. It is still under development, probably. But the feature used was exactly the same as what dgatsoulis used.

Compare your screenshot's orbital parameter display box (the one that shows LAN and Rln) to this one shown by Ripley.

http://www.orbiter-forum.com/showthread.php?p=536753&postcount=7
 
Last edited:

boogabooga

Bug Crusher
Joined
Apr 16, 2011
Messages
2,999
Reaction score
1
Points
0
NukeET, it's the link Nicholas Kang provided.

It's called "Orbits came for the Orbiter" by Jarmonik.
 

Ripley

Tutorial translator
Donator
Joined
Sep 12, 2010
Messages
3,133
Reaction score
407
Points
123
Location
Rome
Website
www.tuttovola.org
OFFTOPIC ON (sorry ADSWNJ)

...It is still under development, probably...
Oh, I wish it was.
It's such a precious little gem (thanks Jarmonik) that I think it should come directly with Orbiter itself.

I can't understand why it has not been developed any further by some of the many talented developers we have here on this forum.
Don't look at me, I'm no programmer.

C'mon! Orbiter needs Videnie reloaded! :hailprobe:

OFFTOPIC OFF
 

Face

Well-known member
Orbiter Contributor
Addon Developer
Beta Tester
Joined
Mar 18, 2008
Messages
4,403
Reaction score
581
Points
153
Location
Vienna
I can't understand why it has not been developed any further by some of the many talented developers we have here on this forum.

Is there a need for that? Looks like it works alright in 2016 as it is now.
I read back then that people tinkered with the idea to develop this into a Kerbal-style navigator, but obviously the idea was not interesting enough to draw attention.
 

Ripley

Tutorial translator
Donator
Joined
Sep 12, 2010
Messages
3,133
Reaction score
407
Points
123
Location
Rome
Website
www.tuttovola.org
Is there a need for that? Looks like it works alright in 2016 as it is now...
I think there is need for such a tool. It could be expecially useful to Orbiter newcomers, videomakers, tutorial editors...
Its purpose is best shown in some of Tex's videos, or take a look at dgatsoulis' or flytandem's replies in this thread, for example:
http://www.orbiter-forum.com/showthread.php?t=27739

I mean, its teaching power can be huge!

Yes it does work, although it's a bit crude at its current state. Jarmonik himself posted that "This add-on does require some work to become really useful". Hopefully somebody will work on it.
The direct comparison is of course with the excellent "Videnie orbit drawing 1.0" by Artlav (although it only worked in Orbiter2010, no graphics client), which has quite a few drawing options to be (de)activated on screen.


...Well ok, so i was off-topic again! :facepalm:
:cheers:
 
Last edited:
Top