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
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)
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.
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):
"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:
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
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
[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.)
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)
(well actually nobody has asked any of these questions, but they seem like good questions)
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)
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.
The stock game already does that with "T"
Maybe, if it makes sense and others want it too. But I'd prefer to keep this simple and small.
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.
Released on 2020-03-25
Released on 2019-12-24
Released on 2019-12-24
Released on 2019-12-14
Released on 2019-06-07
Released on 2019-06-03
Released on 2019-01-18
Released on 2019-01-16
Released on 2019-01-13
Released on 2019-01-11
Released on 2019-01-09
Released on 2019-01-09
Raw stats are from the beginning of time until now. Each follower and download entry represents one hour of data. Uneventful hours are omitted.