Jump to content

[0.22] ISA MapSat 4.0 Dev Build


Recommended Posts


I have been working on a new Mapsat for a while as many might be aware, this is taking longer than I had hoped, there's always something in the way of working on it.

For this reason I released a dev build of the next version, it's fully compatible with 0.20's new system. It is however a dev build meaning not all the planned stuff for 4.0 is in yet and what is might not have received any love in the GUI polish department yet. I have put a lot of time in ensuring the main functionality is all working correctly in 0.20 .

One thing that is considered broken at the moment is csv writing. It works but it's worthless, it hasn't been updated to properly work with the new scanning routines. It's on the to do list before I release the final on Spaceport.

More information and the download to the dev build can be found in my blog, see my signature or click the blog item to the left of this message.



No code is allowed to be used or modified and published without express written consent.


Old forum post pertaining to previous releases:

The Innsewerants Space Agency is very happy to present the ISA MapSat Module and MapGen rendering tool.

Code: Innsewerants, Special thanks to Giucam for finding a way around the pqs weirdness.

Part Model & Animation: Innsewerants

Part Texture: Innsewerants

Special Thanks

r4m0n, C7 - 4 Being on IRC and guiding me towards solutions learning c#.

And anyone I might forget at the moment.


Collect elevation data and map planets with the ISA MapSat.



New in game GUI and maps.

<iframe width="560" height="315" src="http://www.youtube.com/embed/0NAI0WDASos" frameborder="0" allowfullscreen></iframe> <iframe width="560" height="315" src="http://www.youtube.com/embed/YXz1K-E9nM8" frameborder="0" allowfullscreen></iframe>

-Automatically scans for artefacts within range which you can show using a toggle.

-KSC\'s are marked on maps, show using toggle.

-Current satellite position marker available on toggle as well.


[tr][td]Of course MapGen is still included to render data files if you are collecting raw data:[/td][td][/td][/tr]



[tr][td]Change the maximum elevation e.g. white = 8000 m[/td][td]or generate really small maps[/td][/tr]





[table][tr][td]Generate polar views[/td][td][/td][td]Map Kerbin, give it a nice 'natural' colour if you like[/td][/tr]



*Images were generated with data collected during testing and likely containing errors, I used this data because it\'s enough to show what the MapGen can do.


Note 1:

If you have an unofficial 2.0.3 version installed, consider removing it, everything in my code has changed.

Perhaps it will somehow interfere or make bug finding/fixing more difficult.

Note 2:

you can append to your old csv\'s by renaming them appropriately (Kerbin_elevation.csv , Mun_elevation.csv and Minmus_elevation.csv) and placing them in the PluginData\isa_mapsat folder.

Note 3:

If you want to start MapSat with prerendered textures from old csv data run mapgen using 'isa_mapgen.exe texture' and 'isa_mapgen.exe texture polar' this will render out textures suited for the gui.


-Extract the archive somewhere and copy over the files, I left the structure of KSP_win in the archive to make it easier to figure out.

-Copy old csv files to the pluginData/isa_mapsat folder and rename if required.

-Prerender textures with mapgen if desired.

-Launch KSP.

IMPORTANT - You need to copy over and replace all on the part folder too not just the dll and the mapgen.exe when you update. Textures used in the gui are stored in the parts folder. Not doing this can result in squashed textures, corrupt textures and missing gui elements. As of 3.1.0 the map textures are 400x256 not 400x400, 400x400 are incompatible and you either need to crop the old ones to the correct size, delete them and start new or render out ones from csv data using 'isa_mapgen.exe texture' and 'isa_mapgen.exe texture polar'.

You can delete any isa_RAM_Module folder if you don\'t use a third party unofficial version of 2.0.3 that uses it and don\'t have anything in there you want to keep.

This directory will never be used again and the mod has changed permanently to the name ISA_MapSat, getting rid of the RAM crap in the name.

General Usage:

You need preferably 1 sat only on your craft.

The gui maps are updated as long as you are in range and continue to be updated in the background if you look at different maps.

You can switch maps by clicking on the button with the current map name.

The rest of the buttons speak for themselves I think, all the overlays are on toggles.

Toggle open the information panel to get Wikipedia-like information about the planetoid straight from the game.

Toggle on raw data collection if you want to collect csv data for the MapGen tool.

You can find stored csv\'s and the MapGen tool in the PluginData\isa_mapsat directory

NOTE: Toggle raw data collection off before running MapGen!!.

More information in spoilers.

Can it map Kerbin/future bodies?

-As of 3.0.0 a manual update is required to support new planetoids as the devs add them. Not a lot of work though So expect a quick update whenever they add something new to map.

Can it collect data from high altitude

-Yes, it can collect data from as far away as 500km but beam density suffers, but then again the sparse beam density but wider coverage is handy to get a general overview first to render small maps with or find artefacts somewhat quicker.

Can it collect data while in map view

Yes, as of v2.0.0

Can it collect data while speeding up time?

Yes, as of v2.0.0 it can collect data up to 10x speed, but you will get big spaces between readings, might be handy at high alt to collect enough spread out data to render a filled small global map quickly though.

  • [li][MapSat][bug]There is a bug when occasionally not all ksc markers show up, this code is up for planned changes anyway.[/li]

Version 3.3.1

-Added GPS part, it's very compact as to not get in the way but lack the ability to map itself, for navigation purposes without lugging a whole dish. [MAPSAT]

-Fixed Mac file path problem. [MAPSAT]

Version 3.3.0

-Rewrote maphandling completely to be dynamic. 17 and future content like planet should work without manual updating on my end.[MAPSAT]

-Enhanced the beam/drawing. [MAPSAT]

-Gave the wiki a workover and renamed it KerbalPedia since it's not really a wiki. [MAPSAT]

-Fixed the icon tooltip. [MAPSAT]

-Fixed the icon positioning after reports of issues on some resolutions. [MAPSAT]

-Renamed artefacts to anomalies. [MAPSAT]

-Enabled one more notch of timewarp increasing mapping capability up to max 50x err timewarp.[MAPSAT]

(Note: gameplay wise I find it too fast and feeling a bit cheaty but after considerations about how much harder it is to reach other planets than mun and minmus I enabled it.)

-Some performance tweaks.[MAPSAT]

Version 3.2.1

-Added forgotten Geostationary orbit altitude and velocity to wiki.[MAPSAT]

-Forgot to change main button to the new icon as planned, fixed.[MAPSAT] (update Parts folder too!)

Version 3.2.0

-Added some batch files to render textures from csv data.

-Replaced the information panel completely, you can now look up wiki data on any body regardless of current orbit and it's in a more readable scrolling window. [MAPSAT]

-Added a mouse tooltip when you hover over the map that gives you the GPS coordinates of the pixel underneath, doesn't work in polar. [MAPSAT]

-Removed saving textures when part gets destroyed for now, you won't lose much and it's a suspect for texture problems. [MAPSAT]

-Fixed another instance where texture corruption could happen. [MAPSAT]

-Changed beam from a premade pattern to a simpler to handle grid [MAPSAT]

-Increased the density of the scan beam a lot [MAPSAT]

-Can't believe noone including me noticed but fixed the north pole being mirrored [MAPSAT & MAPGEN]

(requires re-rendering the polar textures with MapGen, deleting polar textures or manually doing a horizontal mirror on the North pole half of every polar texture, sorry)

-CSV data now collects over a period of time without writing to file as often [MAPSAT]

-The previous change allows me to remove duplicates somewhat, at least per write. [MAPSAT]

Version 3.1.0

-0.16 Compatible.

-Made drawing on a toggle after requests [MAPSAT]

-A few optimizations and code changes [MAPSAT]

-Fixed a bug on info panel when around Kerbol [MAPSAT]

-SOme typo corrections in the info panel, uses more scientific notation for large numbers[MAPSAT]

-Cut up the info panel into 2 pages so it will fit with the new dimensions. [MAPSAT]

-Fixed the blank instead of black map error. Requires deletion of any erronous transparent maps. [MAPSAT]

-Tweaked GUI size [MAPSAT]

-Added Polar maps [MAPSAT]

-Increased the beam resolution/number of measuring points in the beam. [MAPSAT]

-Added 'texture' to mapgen\'s command line options to pre-render textures for the gui from old csv data. [MAPGEN]

-Added 'texture polar' to mapgen\'s command line options to pre-render polar textures for the gui. [MAPGEN]

-Added scale, sea level marker and labels [MAPSAT]

-Resized GUI texture size [MAPSAT]

-Fixed long unnoticed bug in topography colour scheme in Mapgen when rendering bodies with negative elevations like kerbin [MAPGEN]

-Removed missed test log output spam [MAPSAT]

Version 3.0.0

-Changed name of mode to ISA_MapSat and ISA_MapGen.

-Started mod with a blank slate.

-15.2 compatible csv collection

-Added the GUI features inc maps, artefact detection and more.

-Fixed MapGen to work with new file names.

-New beam code, separation between measuring points now worked out with meters.

(since the beam doesn\'t erroneously distorts you will now see mapping distortion on isa/Mercator as the beams seem to diverge at poles, polar renders no longer show the erroneous thinning of the beam at poles).

Version 2.0.3

-Fixed crashing on unpause [MODULE]

-Some code optimizations. you code, you learn. [MODULE]

Version 2.0.2

-Fixed beams behaving inverted, gets wider at higher altitude and narrower at low altitudes, data is still valid.[MODULE]

-Fixed grey scale becoming broken with Kerbin\'s negative ocean elevations[MAPGEN]

-Tweaked the default topography gradient, also increased the amount of distinct elevation colours it has available[MAPGEN]

-Fixed the small unsightly graphic error in the scale at the bottom that showed in bigger renders[MAPGEN]

-Added bot#### argument to control the bottom elevation for the gradient[MAPGEN]

-Autoscale is now the default render mode unless bot#### and/or top#### are provided[MAPGEN]

Version 2.0.1

-Corrected an overlooked math.round.[MODULE]

-A few code tweaks.[MODULE]

Version 2.0.0 (I think Kerbin is a big new feature so 2 point o it is.)

-New data gathering code allowing mapping of any planet, including Kerbin, at any altitude, within reason (<2000km) , it will keep separate csv\'s automatically. [MODULE]

-Changed to a matrix of 'beams' for a wider 'beam', beam density and width is dependent on orbital altitude. [MODULE]

-Rewrote parts of mapgen\'s file handling to work with the additional planet files [MAPGEN]

-Added highest elevation and it\'s location to the 'report' after running mapgen [MAPGEN]

-Added a dedicated part model to replace the borrowed antenna [PART]

-Added Mercator projection [MAPGEN]

-Added Azimuthal projection for north and south poles [MAPGEN]

-Added new 'natural' colour scheme based on a topography map of India I found, gives Kerbin texture-like colours based on height [MAPGEN]

-Added requested autoscale feature, currently only works with the normal topography colours, natural is pretty specific for Kerbin and needs some more work [MAPGEN]

-Added meridian gridlines option, should work with any projection [MAPGEN]

-Command line arguments can now be given in any arbitrary order [MAPGEN]

Version 1.4.1

-Fixed mapgen crashing on certain data[MAPGEN]

Version 1.4.0 (First public release)

-Completely overhauled how the satellite determines data to be valid this now also allows mapping higher peaks and plateaus without dipping into collision prone orbits after a few hours of collecting a fresh csv at 3800-4100m with additional debug data I have not seen a single erroneous measurement any more.. This includes preventing all the other known causes for erroneous data (including but not limited to going to map view and auto/quicksave)[MODULE]

-Added grey-scale elevation map option. [MAPGEN]

-Added better more forgiving console prompt argument handling. [MAPGEN]

-Added option to set the maximum elevation for the colour mapping. [MAPGEN]

-Added ability to mix and match render options[MAPGEN]

Version 0.3.0

-Fixed a core problem in the mapper that was the main cause for exceptions [MAPGEN]

-Fixed: Found that ksp doesn\'t always switch N/S or E/W quick enough and outputs coordinates like 181 or -90.5, rewrote part of the program to correct for it when making maps [MAPGEN]

-Added Directory check should now always write to the correct folder inside the kspwin directory regardless of \'start in\' in a shortcut or whatnot [MODULE]

-Fixed: if no csv exists yet one will be created instead of spamming the console with errors. [MODULE]

-Added console output in ksp (alt-F2) when mapping activates or stops. [MODULE]

-Satellite should now only scans when < 3400m to prevent bad data. [MODULE]

-Various small changes and optimizations[MODULE] [MAPGEN]

-Fixed MapGen so instead of crashing it properly checks for the data file first. [MAPGEN]

-The map generator will now create file names including set parameters. [MAPGEN]

Version 0.2.0

-Added the option to render a scale gradient along with the map. [MAPGEN]

-Removed outdated debug console output. [MAPGEN]

-Various optimizations. [MAPGEN]

-The mapping module now only collects data if orbiting the Mun. [MODULE]

Version 0.1.0

-Fixed a typo that caused bad averaging of pixel colours.[MAPGEN]

-Fixed map projection to fill image correctly [MAPGEN]

-Fixed float rounding issue causing bad colour mapping [MAPGEN]

-Added option give any image width to the MapGen[MAPGEN]

Version 0.0.0 (Never public)

-Started learning c# trying to make a mapping satellite.

-Added data collection with a few checks to prevent bad data. [MODULE]

-Added MapGen tool to render colour topography maps with the data.[MAPGEN]


[tr][td]No arguments[/td][td][/td][td]Renders 400px wide colour topography map using the NASA/moon colour band[/td][/tr]

[tr][td]<number>[/td][td][/td][td]Render colour topography map of given width in pixels[/td][/tr]

[tr][td]grey[/td][td][/td][td]Render grey-scale elevation map[/td][/tr]

[tr][td]natural[/td][td][/td][td]Uses more natural terrain colours, resulting in a texture-like map[/td][/tr]

[tr][td]scale[/td][td][/td][td]Render the scale at the bottom.[/td][/tr]

[tr][td]gridw## or gridb##[/td][td][/td][td]Overlay a white or black meridians grid, ## is the separation between lines in degrees.[/td][/tr]

[tr][td]top####[/td][td][/td][td]The elevation with # in meters that is taken as the top of the colour scale[/td][/tr]

[tr][td]bot####[/td][td][/td][td]The elevation with # in meters that is taken as the bottom of the colour scale[/td][/tr]

[tr][td]mercator[/td][td][/td][td]Use Mercator projection instead of default[/td][/tr]

[tr][td]azimuthalNP[/td][td][/td][td]Create an azimuthal projection of the northern hemisphere[/td][/tr]

[tr][td]azimuthalSP[/td][td][/td][td]Create an azimuthal projection of the southern hemisphere[/td][/tr]

[tr][td]texture[/td][td][/td][td]Renders normal textures for use in MapSat[/td][/tr]

[tr][td]texture polar[/td][td][/td][td]Renders polar textures for use in MapSat[/td][/tr]


You can mix up the different arguments, order should not matter, if you run into any combination that breaks please let me know.

Do not use 'texture' and 'texture polar' with other arguments, these are tweaked to fit with the drawing in MapSat\'s gui.


isa_RAM_MapGen.exe 1600 natural azimuthalNP scale grid10 would generate a 1600 pixel wide, natural coloured, azimuthal polar view of the northern hemisphere with a grid overlay that\'s spaced 10 degrees apart and the scale added to the bottom.

Latest version

Source (old)

Cheers and happy orbiting,



If you have problems and want to help me fix them (It\'s my first c# learning project after all) please do the following:

if it\'s the module in ksp:

Check the console alt-f2 and if it\'s spamming something there. If so send me what errors is spamming so I can find out what\'s happening.

If it\'s the mapgen

Run from command line so you can see if it spits out a file not found or if it crashes what the exception is it gives, these usually show me the way to what\'s wrong.

[edit]fixed some information, spell checked my heinous errors that crept in from being exhausted lol.[/edit]

Edited by Innsewerants
Link to comment
Share on other sites

Totally awesome, I\'ll let this run for awhile!

EDIT: This *could* work on kerbin, right?

Yes, it would just be very uneasy to do unless I find ways to bypass kerbins atmosphere or perhaps take control of the terrains detail level and how high up the collision mesh remains loaded etc.

I coded the mapper to leave room to collect a separate file on Kerbin/future bodies.

The code to prevent recording of bad data should be such in this release that kerbin would not cause problems except for the circumstances preventing a low enough orbit.

Aw come on, an .exe? Doesn\'t anyone feel sorry for Mac users?

I do so very much, for their wallets mostly.

But seriously, it\'s really simple, this is my first c# learning project, when I started my first line of code thursday I didn\'t know a word of c#.

If I figure out how to build it for mac be sure I will release a mac version of the tool. I will add it to the request list. Just give me time to figure it out and test it when I do, I would need to visit some people with macs to even try my own test builds.

Link to comment
Share on other sites

not really, no

Not all of us are using Mac by choice. I do have a PC, it\'s just back at Uni... I\'m having to use my Dad\'s iMac over the holidays as it\'s the only computer in the house that is remotely capable of running KSP.


Link to comment
Share on other sites

Not all of us are using Mac by choice. I do have a PC, it\'s just back at Uni... I\'m having to use my Dad\'s iMac over the holidays as it\'s the only computer in the house that is remotely capable of running KSP.


Some on the other hand have always preferred using mac over their windows machine (PC ain\'t PC :D).

I would like to volunteer for mac testing. It looks so epic!

Link to comment
Share on other sites

Something to do with the fact that Kerbin has Oceans, perhaps?

I think it\'s more that it is optimized to operate at an altitude of 4000m or lower, which is inherently unsafe orbit height in atmosphere. You might try attaching one to a plane and fly a level spiral or switchback search pattern and see what happens.

If this app were rewritten in Java, we Mac users could run it without much issue.

Link to comment
Share on other sites

If this app were rewritten in Java, we Mac users could run it without much issue.

You just need Mono. Java is silly (not to mention the only way to run Java code in a KSP plugin is to use something like IKVM, which would run on Mono anyway).

Link to comment
Share on other sites

You just need Mono. Java is silly (not to mention the only way to run Java code in a KSP plugin is to use something like IKVM, which would run on Mono anyway).

It\'s not the plugin being written in Java that he is suggesting. He means the application which processes the elevation data.

Link to comment
Share on other sites

Couple thoughts,

1. Neato

2. Can\'t wait to grid this data.

3. It takes so long to record, I wish I had more data points :)

4. Looking Mechjeb, I\'m guessing I can\'t record in map mode.

5. Just brain storming: Maybe the output file could be the name of the celestial body your orbiting. I.e. Mun.csv and Kerbin.csv.

6. I wonder what A good height for a polar orbit.

7. GMT could be used on the mac to the mapping. :)

Link to comment
Share on other sites

This topic is now closed to further replies.

  • Create New...