Jump to content

(1.12.5) (Kopernicus) VertexHeightOblateAdvanced 1.1.0 - Easy oblate bodies


Recommended Posts

VertexHeightOblateAdvanced

VertexHeightOblateAdvanced is a custom PQS Mod intended for use by planet modders to enable easy creation of oblate bodies via a simple PQS Mod, rather than via a heightmap. Additionally, when in the SOI of a body implmenting VertexHeightOblateAdvanced, two new camera modes will be added to the camera rotation after FREE mode to better support non-spherical bodies.

Planet pack developers implementing VertexHeightOblateAdvanced are encouraged to bundle it with their mod, for the convenience of users.

Examples

  • PointEqupotential
Spoiler

MfPfnJp.png
8j0GjtG.jpg

  • UniformEquipotential Low
Spoiler

4OLv0EQ.png
AWZ92cm.jpg

  • UniformEquipotential Low
Spoiler

b7fMmxQ.png
k5hVciz.jpg

  • UniformEquipotential High
Spoiler

P6gKHLX.png
BZPitvl.jpg

  • UniformEquipotential High
Spoiler

CS0ie4f.png
LG0hRIL.jpg

Download

Installation and Use

  • Install ALL listed dependencies, following the links below
  • Download and extract the VertexHeightOblateAdvanced zip file
  • Place the GameData folder into your KSP directory
  • Once installed, simply add a VertexHeightOblateAdvanced node to the Mods node in your body's PQS node
  • Using the following Google Sheet, find appropriate periods for your body to get the desired oblateness, based on body surface gravity and radius.

Camera modes:

  • SURFACE NORMAL
    • Functions like FREE camera mode, but with the vertical axis aligned perpendicular to the shape defined by the VertexHeightOblateAdvanced instance. This eliminates the "uphill effect" that oblate bodies have.
    • Lerps to FREE camera mode when greater than 10% of the body radius above the maximum oblate height.
  • GRAVITY NORMAL
    • Functions like FREE camera mode, but with the vertical axis aligned with the local apparent gravity vector, taking into account the effects of rotation. Surfaces that look flat and level are actually flat and level relative to gravity.
    • Lerps to FREE camera mode when greater than 10% of the body radius above the maximum oblate height.

Parameters and expected values:

  • oblateMode: overall controller for type of generation used
    • Values: (PointEquipotential, UniformEquipotential, Blend, CustomEllipsoid)
      • PointEquipotential: Generates a point mass equipotential
      • UniformEquipotential: Generates a uniform density equipotential, either a Maclaurin spheroid or Jacobi ellipsoid deppending on energyMode and period
      • Blend: Multiply a PointEquipotential by a CustomEllipsoid
      • CustomEllipsoid: Generate an ellipsoid based on a, b, and c axis values
  • energyMode :
    • Used with: oblateMode (UniformEquipotential)
    • Values: (Low, High)
      • Low: For the given period, generate using the low oblateness branch. Always generates a Maclaurin spheroid
      • High: For the given period, generate using the high oblateness branch. Generates either a Maclaurin spheroid or Jacobi ellipsoid based on period
  • mass: Mass of the body as set in the Properties node. Optional if both radius and geeASL are provided.
    • Used with: oblateMode (PointEquipotential, UniformEquipotential, Blend)
    • Value: (greater than 0)
  • radius: Mass of the body as set in the Properties node. Optional if both mass and geeASL are provided.
    • Used with: oblateMode (PointEquipotential, UniformEquipotential, Blend)
    • Value: (greater than 0)
  • geeASL: Surface gravity of the body as set in the Properties node. Ignored if both mass and radius are provided.
    • Used with: oblateMode (PointEquipotential, UniformEquipotential, Blend)
    • Value: (greater than 0)
  • period: Rotational period of the body as set in the Properties node.
    • Used with: oblateMode (PointEquipotential, UniformEquipotential, Blend)
    • Value: (greater than 0)
  • a: The primariy equatorial axis as a ratio of provided radius.
    • Used with: oblateMode (Blend, CustomEllipsoid)
    • Value: (1 to infinity)
  • b: The secondary equatorial axis as a ratio of provided radius.
    • Used with: oblateMode (Blend, CustomEllipsoid)
    • Value: (1 to infinity)
  • c: The polar axis as a ratio of provided radius.
    • Used with: oblateMode (Blend, CustomEllipsoid)
    • Value: (1 to infinity)

Requirements

  • ModuleManager
  • Kopernicus

FAQ

  • Q. I'm not a planet modder? Do I need this?
  • A. You do not need to install it manually yourself, but if you found this in you GameData, it is because a planet pack you have/had needs/needed it and so it was either included with the mod or auto installed through CKAN

Licensing

  • VertexHeightOblateAdvanced is licensed under the MIT License
Edited by Lt_Duckweed
Link to comment
Share on other sites

oh that's excellent. maybe i'll be able to put this into Whirligig World if i get back to it. I've been wanting to make Mesbin properly level ever sense i first released it. (I just haven't been interested in planet modding for the past year or so, since running Planet Jam 2)

Edited by Whirligig Girl
Link to comment
Share on other sites

Can you post the config for the planet so I can take a look?

Since it tries to be as realistic as feasible on shape, if a planet isn't rotating all that fast it won't change the shape much at all.  It's possible that is the issue here.

As an example, if the Earth was had a period of 6 hours, or 4x faster than it does now, it would only have a Equatorial to Polar axis ratio of 1.07, which is going to be hard to notice to the naked eye.

Link to comment
Share on other sites

14 hours ago, Lt_Duckweed said:

Can you post the config for the planet so I can take a look?

Since it tries to be as realistic as feasible on shape, if a planet isn't rotating all that fast it won't change the shape much at all.  It's possible that is the issue here.

As an example, if the Earth was had a period of 6 hours, or 4x faster than it does now, it would only have a Equatorial to Polar axis ratio of 1.07, which is going to be hard to notice to the naked eye.

Sure, 
                VertexHeightOblateAdvanced
                {
                    oblateMode = UniformEquipotential
                    energyMode = High
                    radius = 980000
                    geeASL = 0.06
                    period = 14040
                    enabled = True
                    order = 25
                }        

Link to comment
Share on other sites

On 1/15/2024 at 4:03 AM, Emma_4623 said:

Sure, 
                VertexHeightOblateAdvanced
                {
                    oblateMode = UniformEquipotential
                    energyMode = High
                    radius = 980000
                    geeASL = 0.06
                    period = 14040
                    enabled = True
                    order = 25
                }        

Is this body meant to represent Haumea perchance?  When replicating a existing body with a known shape, it would be easiest to use CustomEllipsoid mode, so you can set the a, b, and c parameters equal to the known real values.

Additionally, when using UniformEquipotential or PointEquipotential, the radius and geeASL you input must match the values for the poles.  For Haumea this would be something like 525km radius, and a geeASL of around 0.095

Unfortunately this still gives a shortest possible period under the Uniform model that is longer than the actual real period of Haumea.  This is because in reality, Haumea is probably not uniform in density but is denser towards the core, and thus would have a shorter period than what the model would predict.  In such a case it is supposed to clamp to an oblate value that is within the bounds of the model, but seems like this edge behavior may have a bug I need to fix.

All that said, assuming this is indeed Haumea, my recommendation would be to use the polar radius and gravity, and try using CustomEllipsoid to manually set the a,b, and c values (c should be 1, a should be a bit over 2, and b should be around 1.6).

Edited by Lt_Duckweed
Link to comment
Share on other sites

On 1/15/2024 at 8:08 PM, Lt_Duckweed said:

Is this body meant to represent Haumea perchance?  When replicating a existing body with a known shape, it would be easiest to use CustomEllipsoid mode, so you can set the a, b, and c parameters equal to the known real values.

Additionally, when using UniformEquipotential or PointEquipotential, the radius and geeASL you input must match the values for the poles.  For Haumea this would be something like 525km radius, and a geeASL of around 0.095

Unfortunately this still gives a shortest possible period under the Uniform model that is shorter than the actual real period of Haumea.  This is because in reality, Haumea is probably not uniform in density but is denser towards the core, and thus would have a shorter period than what the model would predict.  In such a case it is supposed to clamp to an oblate value that is within the bounds of the model, but seems like this edge behavior may have a bug I need to fix.

All that said, assuming this is indeed Haumea, my recommendation would be to use the polar radius and gravity, and try using CustomEllipsoid to manually set the a,b, and c values (c should be 1, a should be a bit over 2, and b should be around 1.6), alternately.

Thank you very much, and yes im trying to make Haumea
I will try  using CustomEllipsoid, thx 

Link to comment
Share on other sites

VertexHeightOblateAdvanced 1.1.0

What's new:

  • When in the SOI of a body implementing VertexHeightOblateAdvanced, two new camera modes will be added to the camera rotation after FREE mode to better support non-spherical bodies.
    • SURFACE NORMAL
      • Functions like FREE camera mode, but with the vertical axis aligned perpendicular to the shape defined by the VertexHeightOblateAdvanced instance. This eliminates the "uphill effect" that oblate bodies have.
      • Lerps to FREE camera mode when greater than 10% of the body radius above the maximum oblate height.
    • GRAVITY NORMAL
      • Functions like FREE camera mode, but with the vertical axis aligned with the local apparent gravity vector, taking into account the effects of rotation. Surfaces that look flat and level are actually flat and level relative to gravity.
      • Lerps to FREE camera mode when greater than 10% of the body radius above the maximum oblate height.

Download

Edited by Lt_Duckweed
Link to comment
Share on other sites

On 1/12/2024 at 12:12 PM, Whirligig Girl said:

Finally! do we get a scientifically mesklin mesbin in the game. It would be very cool if you can get the atmosphere done right too, I just can't wait play my mission of gravity soon. PS,Is this picture before or after the update?

Link to comment
Share on other sites

1 hour ago, Alpha_star said:

Finally! do we get a scientifically mesklin mesbin in the game. It would be very cool if you can get the atmosphere done right too, I just can't wait play my mission of gravity soon. PS,Is this picture before or after the update?

the image attached uses VertexHeightOblateAdvanced.

the shape i ended up going with (visible in the end of the whirligig world thread) is wider than this, to match mesbin's original dimensions so gameplay remains the same; but the slopes should be gentler now even though it's not using the pure equipotential.

Atmospheric oblateness is still impossible at the moment. If Atmospheric oblateness does become a thing it will probably require Whirligig World go through something of a paradigm shift or major update (or, and no promises, a sequel) to accomodate. It's something I've always wanted to do, but it's always been this far off future thing.

Atmospheric oblateness would require both physics and visuals be changed to accomodate not just ellipsoidal shapes, but all the shapes possible with VertexHeightOblateAdvanced.

And for a proper Mesklin analogue we also need oceans! which means ocean heightmaps with proper physics for buoyancy and collision on oblate worlds.

Link to comment
Share on other sites

3 hours ago, Whirligig Girl said:

Atmospheric oblateness would require both physics and visuals be changed to accomodate not just ellipsoidal shapes, but all the shapes possible with VertexHeightOblateAdvanced.

On the physics side of things, oblate atmospheres might be possible with some ModularFlightIntegrator tomfoolery. I don't yet know about the visual side of things. (tho one could probably poke blackrack to see if he has any thoughts on that)

Edited by CashnipLeaf
Link to comment
Share on other sites

12 hours ago, CashnipLeaf said:

On the physics side of things, oblate atmospheres might be possible with some ModularFlightIntegrator tomfoolery. I don't yet know about the visual side of things. (tho one could probably poke blackrack to see if he has any thoughts on that)

it's all i've ever wanted. :valsob: i would make such a cool planet if i had working oblate atmospheres. (and uh. oceans. the planet would be possible but way less cool without oceans.)

Link to comment
Share on other sites

  • 3 weeks later...
  • 1 month later...

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...