Telemetria

Shows Ap and Pe on main KSP screen. Also provides key binding for Prograde, Retrograde, SAS:Surface/SAS:Orbit, and Warp to Next Maneuver. Also Ascent Guidance.

License: CC-BY-NC-SA-4.0

Game Version: 1.10.1

Downloads: 3,062

Author: BadRocket

Followers: 12

Information Changelog Stats

Telemetria

Quick List of Features:

1) Displays Ap and Pe details on the main (Ship) screen

2) Provides keyboard binding for Prograde/Retrograde, SAS:Surface/SAS:Orbit, and "Warp to Next Maneuver" + Warp to Ap/Pe

3) Provides Ascent Guidance for optimal launches, and other interesting data like MaxQ, kph, and mph

4) Hotkeys for quickly pointing camera direction

5) A goal of being as small and simple as possible, with no dependencies

LICENSE:

Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)

CHANGELOG:

  • 0.1: Initial Build.
  • 0.2: Add Ascent Guidance, add new display options, minor fixes
  • 0.3: Fixed error with Radar Altimeter reading incorrectly over water
  • 0.4: Updated persistence logic when switching scenes and vessels
  • 0.5: Added Vessel Latitude readout, plus time to Ascending/Descending node for easier inclination changes
  • 0.6: New ascending "^" and descending "v" indicators for inclination, also some minor fixes and formatting changes
  • 0.7: Fixed bug with volume key always activating mute if game started at vol level 0
  • 0.8: Fixed bug with Warp to Node; Added "Warp to Ap/Pe" if no Node; Minor changes to formatting and Ascent Guidance defaults; undocumented "ExtraData" (see cfg)
  • 0.9: Fixed bug with visibility when using F2 key; Added Camera Snap hotkeys, Keys now allow modifiers such as Alt + F7
  • 1.10: Many bug fixes; Removed "Radar Altimeter" since now included in stock; Reorganized data display; Updated key defaults
  • 1.12: (intially released as 1.13, but had minor formatting error)
  • 1.13: Automatically calculates accurate TWR for ascent guidance (much improved guidance); Annunciators give hints about optimal ascent; Added "SnapCameraCustom" (in .cfg) to position camera at any desired heading
  • 1.14: Added "Distance" to custom camera snap; Modified time-to-Ap to show negative (countdown) during orbit insertion/circularizations; Fixed decimal formats; Recompiled against KSP version 1.8.1 and .NET 4.7.1

New for 1.14:

When launching and approaching orbit, you might temporarily pass the apoapsis while circularizing your orbit, especially with low-thrust second stages that are common in the real world. When that happens, KSP wraps around the "Time to Apoapsis" and show Hours:Minutes:Second for the next Ap, so you lose information on how far ahead of Ap you currently are. This latest Telemetria upgrade will show the "Time Past Apoapsis" data with a negative number, making it obvious that Ap is behind you so it's easier to adjust your ascent.

  • Also added "Distance" as one of the camera parameters for setting up custom quick snap-to-view.

DESCRIPTION:

So you're launching a glorious new rocket, and you have to constantly flip between the Map view and Ship view, so you can track the Apoapsis and Periapsis during ascent. I'd rather watch my rocket and epic staging events than a parabola line. Even worse, right-click the Apoapsis to keep the data visible > then switch back to Ship view > switch back to Map view and poof the data is gone again. Update: As of KSP 1.7+, the Ap/Pe display is included in stock Kerbal, plus the data stays visible, BUT Telemetria's display seems much easier to read and is moveable.

As you probably know, mods like Kerbal Engineer (KER), MechJeb, and BasicOrbit can already show this information and a lot more, but I wanted something minimalist and simpler. Preferably, a single file plug-in (with minimum-to-no dependencies), and a basic .cfg text file that I can easily edit for changes. Using this mod, I can get perfectly circular orbits every time, and at the precise desired altitude, all without ever needing to go into Map view. It's very satisfying to reach a perfect orbit by hand-flying with this tool.

During the ascent, there are numerous changes typically made with SAS relating to switching pointing reference -- Surface while low, and Orbit when higher. In the stock configuration, this requires mouse moves/clicks to activate. To facilitate SAS changes, this mod lets you map keys for Prograde and Retrograde pointing, and also key toggling for the SAS Mode ("Current Plane of Reference"), between SAS: Surface and SAS: Orbit.

Since we're mapping commands here, we've all had the experience of trying to click the (nearly hidden) dotted brown line so you can pick Warp to Next Maneuver. As you know, when the Maneuver trajectory is too close to the current trajectory, it's nearly impossible to right-click it with the mouse. With this mod, you can assign the Warp To Node command to any unused key. Even better, you can set the time allowance to be anything you want, instead of the default 60 seconds that exists in KSP version 1.5.1 and lower. Using this key command also sets the pointing to SAS:Maneuver, which is one less thing you have to click. If there is no Maneuver Node, then this will warp you to the next Apoapsis/Periapsis minus 30 seconds - great for orbital circularization!

To view the key bindings that are active with Telemetria, press the key combo mentioned in the title bar (Alt+F7 by default):

Feature: Ascent Guidance

"Ascent Guidance" shows you the optimum pitch angle to steer while climbing to arrive at your desired altitude and angle. If you've played KSP for awhile, you probably already do this based on instinct, however this guidance can assist you with achieving a Kerbal Space Agency-approved launch trajectory resulting in a circular orbit with minimum fuel. The formula used for guidance was listed in this thread:

https://www.reddit.com/r/KerbalAcademy/comments/4b878r/how_to_launch_rockets_efficiently_in_ksp_105_and/

Ascent Guidance will be active if the following conditions are true: 1) You are launching from a location with an atmosphere (non-atmospheric launches do not need guidance, and should turn prograde immediately after rising above terrain height) 2) The vertical speed is currently higher than 20m/s 3) You are above the "Start Turn" altitude in the .cfg file

The following parameters are available to tweak your ascent trajectory: (a) Start Turn Altitude, (b) End Turn Altitude, (c) End Turn Pitch Angle. Telemetria can pick all of these parameters for you with default values, which should work for both Kerbin and Earth/RSS.

Feature: Latitude shows the current latitude degrees, plus time to the next 0° node (when you cross a plane of reference such as the equator, in other words the next Ascending (AN) or Descending (DN) node). The 0° transition happens twice per orbit. The "time to 0°" is helpful since it allows you to adjust your inclination at a celestial body using no other references. This means you don't need to do the trick of "put a probe orbiting at 0°" (or hyperedit the persistent.sfs file) to obtain a reference for inclination changes. Like most data that Telemetria provides, the current Latitude and time to AN/DN is not available on the stock KSP ship screen, but is critical for realistic orbital flight ops.

Feature: Inclination Indicator Added small indicators to show if you are heading up "^" or down "v" on inclination. Note that this is independent of current latitude; "going up" can be positive or negative latitude. This information helps you to know which way to point (Normal or Antinormal) for inclination changes when reaching the 0° transition.

Feature: Extra Data There was some additional information that is of interest during launches and other activities, such as "kph", "mph", Max Q, etc. Using this data, Telemetria can calculate "Max q", and also when the vehicle goes supersonic.

Demonstration of Telemetria showing "Max Q" for a Falcon Heavy passing through 13km in the Real Solar System environment

INSTALLATION / COMPATIBILITY / DEPENDENCIES:

  • Like all Kerbal Space Program system-level mods, the free "ModuleManager" is required (all MM versions 3.x/4.x tested fine with this mod). If you have any other mods, you already have MM in your GameData folder.

  • copy "Telemetria.dll" and "Telemetria.cfg" to "[KSP install folder]\GameData\Telemetria", so the file structure looks like this:

    \Kerbal Space Program\GameData\Telemetria\
                                              Telemetria.cfg
                                              Telemetria.dll
    

Tested with:

[x] KSP 1.10 thru 1.3.1 (1.10.0, 1.9.1, 1.8.0, 1.8.1, 1.7.1, 1,7.2, 1,7.3, 1.6.1, 1.5.1, 1.3.1)

[x] ModuleManager 3.0.4, 3.1.2, 3.1.3, 4.0.2, 4.1.3, etc.

(Probably works with other versions, too.)

CONFIG FILE REFERENCE:

Everything about Telemetria is controlled by the settings (text) file "Telemetria.cfg". As of v0.4, you can even change the .cfg file entries while playing the game, and Telemetria tries to be intelligent about your new settings without requiring a KSP restart (it will reload changes during a scene or vessel switch). This allows you make changes based on new ships and launches, or alternate target orbits, without restarting.

You can delete the "Telemetria.cfg" file, and a canned template (default) settings file will be created for you.

Telemetria saves the (x,y) coordinates of its app window to the config file. This means the Telemetria window is persistent between KSP sessions. All the other settings are meant to be manually modified with a text editor like Notepad (I have no plans to make a special UI for this mod, and in KSP you quickly get skilled at modifying .cfg files).

Key Examples: Y, F6, Alt+F6, PageUp, ScrollLock, Keypad5, KeypadEnter, Mouse2, JoystickButton0, etc.

Full Key List: https://docs.unity3d.com/ScriptReference/KeyCode.html

Avoid Key conflicts: https://wiki.kerbalspaceprogram.com/wiki/Key_bindings

window_x = 0                    // Window position Left (this is automatically updated by Telemetria)
window_y = 0                    // Window position Top (this is automatically updated by Telemetria)
warp_node_margin = 180          // Time, in seconds, of the "Warp to Next Maneuver" buffer

ascent_turn_start    = 500      // Altitude to begin gravity turn (default: 500m)
ascent_turn_end      = 80000    // Altitude to end guidance (default: atmosphere height, which is 70,000m for Kerbin, or 140,000 for Earth, the full gravity turn may continue much higher.)
ascent_angle_final   = 0.0      // Pitch angle when guidance is complete (default: 5.0; a non-zero angle aids in following Prograde marker the rest of the way to orbit)
ascent_show_hints    = false    // Optionally show extra warnings for asscent guidance (ie, thrust too high, apoapsis too far, etc)

Hide = F7                       // Show/Hide the Telemetria window (only key that can't use mod "Alt+", to avoid conflicts.)
Prograde = F6                   // Activates "Prograde" following in SAS mode
Retrograde = F8                 // Activates "Retrograde" following in SAS mode
SASMode = Y                     // Toggles between "Surface" and "Orbit" mode for SAS
Mute =                          // Master mute toggle for all KSP sounds
WarpToNode = Alt+F8             // Provides "Warp to Next Maneuver" without needing to right-click mouse
SnapCamera0 = Alt + Keypad8     // Snaps the camera to 0* (looking straight north; helps during launch)
SnapCamera90 = Alt + Keypad6    // Snaps the camera to 90* (looking east)
SnapCamera180 = Alt + Keypad2   // Snaps the camera to 180* (looking south)
SnapCamera270 = Alt + Keypad4   // Snaps the camera to 270* (looking west)
SnapCameraCustom = Alt + Y      // Snaps the camera to angle that you provide in "SnapCameraCustom_Heading**"
SnapCameraCustom_Heading = 45   // 45* camera angle (looking northeast)
SnapCameraCustom_Pitch = 0.115  // Pitch angle of camera (up/down view)
SnapCameraCustom_Distance = 50  // Distance of camera from focus point (in meters)

FAQ:

(well actually nobody has asked any of these questions, but they seem like good questions)

1) Why is it named Telemetria

Since this mod primarily deals with telemetry from the Launch and Ascent phases of flight, *Telemetria* was the obvious name choice.
(and btw Telemetria is Spanish for telemetry, pero con acento por supuesto)

2) Why no "SAS:Target" toggle?

Because I made this mostly for ascents. Plus, when doing an orbital rendezvous, you typically click the "Target" mode approximately one time and just leave it on.
So it didn't seem like it needed quick access.
I can certainly add it if people request it, BUT then you will have to cycle through 3 modes instead of 2.

3) Why no "Toggle SAS on/off"

The stock game already does that with "T"

4) Will you add other commands for keyboard mapping?

Maybe, if it makes sense and others want it too. But I'd prefer to keep this simple and small.

5) If this functionality already exists in mods like KER and MechJeb, why did you create a new mod?

I wrote this primarily to solve the few things that I found annoying in the stock game to make my life easier, but without all the complexity, overhead, and dependencies of a major add-on.
I'm not aware of any mod that provides these specific features (Ap/Pe, Guidance, key override for Surface/Orbit), and nothing else, all displayed in the same tiny window.
Plus, this project gave me the experience of writing a mod for a popular game, using my own source code that I can update instantly for new versions.
Hopefully you find this mod useful like I do.

Version 1.14 for Kerbal Space Program 1.10.1

Released on 2020-03-25

  • New: Added "Distance" to custom camera snap parameters (so you can quickly set default view to a good distance to view your entire rocket monstrosity)
  • Modified "time-to-Ap" to show negative (countdown) numbers during ascents, rather than wrapping orbit time, to assist with more natural orbit insertions/circularization burns
  • Added "ascent_show_hints" to Telemetria.cfg to make the guidance warnings optional (ie, thrust too high, apoapsis too far, etc)
  • Added extra troubleshooting output into log file
  • Fixed some floating point number formatting errors
  • Recompiled against KSP version 1.8.1 and .NET version 4.7.1 (to match other popular plugin build toolsets, like Kopernicus)
  • Tested on KSP 1.8.1 and 1.9.1

Download (19.77 KiB)

Version 1.13 for Kerbal Space Program 1.8.1

Released on 2019-12-24

  • New: Automatically calculates accurate TWR for ascent guidance, providing much more optimal trajectory angles
  • During testing, new guidance updates resulted in an 18% improvement for LEO payload
  • TWR ratios used for ascent guidance are displayed (momentarily) in the UI at the end of the guidance line
  • Annunciators give hints about optimal ascent, to help guide you with Thrust (aim for 2.0 during climb), Time To Apo, and Apo altitude
  • Changed data display switchover from Orbital mode to Lat/Long (flight mode vs surface driving) at 100m altitude (was 33m)
  • Added "SnapCameraCustom" (in Telemetria.cfg) for using Keyboard to position camera at any desired heading (instead of only the N-S-E-W headings)
  • SnapCameraCustom=(key) loads "SnapCameraCustom_Heading" and "SnapCameraCustom_Pitch" to set the view (see .cfg)
  • Using stock KSP, "SnapCameraCustom" feature allows you to position the camera looking straight at the launchpad (1*), and good elevation angle (0.115)
  • Tested successfully in both KSP versions 1.7.3 and 1.8.1

Download (18.70 KiB)

Version 1.12 for Kerbal Space Program 1.8.1

Released on 2019-12-24

  • (same fix list as 1.13 above, re-released as 1.13 to fix minor formatting error)

Download (18.72 KiB)

Version 1.10 for Kerbal Space Program 1.8.1

Released on 2019-12-14

  • Fixed many minor bugs (over a dozen little things, too many to list here)
  • Removed "Radar Altimeter" since stock game includes it and it looks good and is readable
  • Removed "Extra Data" option and made it permanent
  • Reorganized data display, shows more data in fewer lines
  • Changed key defaults to work better on keyboards with no numeric keypad
  • More intelligent about ground vehicles vs orbiting
  • Added Longitude calculations since lately I've been doing precision landings on Mars in RSS
  • Updated compiler and toolkit, so that Visual Studio is no longer required for development

Download (18.20 KiB)

Version 0.9 for Kerbal Space Program 1.7.2

Released on 2019-06-07

  • New Feature: Snap view camera to 0/90/180/270° with key press (set in Telemetria.cfg: SnapCamera0, SnapCamera180, etc)
  • Moved distracting key binding details to a completely separate popup dialog, added titlebar hint on how to invoke
  • Moved version number into new popup box
  • Extra data additions: Atmosphere %, Airspeed, Orbital Velocity
  • Added "annunciators" when passing Max Q and Mach 1
  • Added ability to include Modifier key for bindings, such as "Alt+F7" or "Alt + Keypad5"
  • Made the window a few pixels smaller, and narrowed the first column
  • Fixed some various internal memory issues and C# assembly incompatibilities
  • Finally fixed the visibility bug that happened when using F2 to hide all screen items

Download (18.60 KiB)

Version 0.8 for Kerbal Space Program 1.7.1

Released on 2019-06-03

  • Fixed bug with Warp to Node using incorrect time offset
  • Added "Warp to Ap/Pe" if there is no Maneuver Node set
  • Changed default for Ascent Guidance (now uses max atmosphere height if missing cfg parameters)
  • Minor data formatting changes
  • Added undocumented "SpecialData" (see cfg)
  • Developed & tested on KSP 1.7.1

Download (17.48 KiB)

Version 0.7 for Kerbal Space Program 1.6.1

Released on 2019-01-18

  • 0.7: Fixed bug with volume key always activating mute if game started at vol level 0

Download (16.35 KiB)

Version 0.6 for Kerbal Space Program 1.6.1

Released on 2019-01-16

  • 0.6: New ascending ("^") and descending ("v") indicators for inclination, also some minor fixes and formatting changes

Download (16.17 KiB)

Version 0.5 for Kerbal Space Program 1.6.1

Released on 2019-01-13

  • 0.5: Added Vessel Latitude readout, plus time to Ascending/Descending node for easier inclination changes

Download (15.80 KiB)

Version 0.4 for Kerbal Space Program 1.6.1

Released on 2019-01-11

  • 0.4: Updated persistence logic when switching scenes and vessels

Download (14.73 KiB)

Version 0.3 for Kerbal Space Program 1.6.0

Released on 2019-01-09

  • Fixed error with Radar Altimeter reading incorrectly over water

Download (14.58 KiB)

Version 0.2 for Kerbal Space Program 1.6.0

Released on 2019-01-09

  • Add Ascent Guidance
  • Add new display options
  • Minor fixes

Download (14.59 KiB)

Version 0.1 for Kerbal Space Program 1.6.0

Released on 2019-01-06

No changelog provided

Download (11.99 KiB)

Stats for Telemetria

Downloads over time

    Downloads per version

    New followers per day

    Top Referrers

    1. spacedock.info
    2. www.google.com
    3. www.youtube.com
    4. forum.kerbalspaceprogram.com
    5. www.spacedock.info
    6. duckduckgo.com
    7. yandex.ru
    8. www.bing.com
    9. www.google.ca
    10. www.google.de

    Export Raw Stats

    Export Downloads

    Export Followers

    Export Referrals

    Raw stats are from the beginning of time until now. Each follower and download entry represents one hour of data. Uneventful hours are omitted.