Friday, April 30, 2021

What's new in TouchTerrain version 3.3?

  • Help "bubbles": When you mouse-over or click on a question mark icon, a help text (popover) will appear. If you clicked on the question mark, the popover will remain visible until you click on it again.


  • 3D printer option settings for CNC users: This is mean to help the around 15% of TouchTerrain users who create terrain models using CNC machines. There's no direct equivalent to physical print size or nozzle nozzle, diameter,  so for CNC users, I've added three presets: small, medium, large size, which is related to the final, physical size of the piece of wood; and low, medium and high detail, which is related how much detail your carve can potentially contain.
  • Medium offers a reasonable compromise of level of detail and the size of the STL. If you want a smaller STL and can deal with less detail, set this to low detail. If you are sure that you need more detail, select high, which will create larger STL files and take longer to process. Preview can help to decide on the best level of detail but, as many factors influence the final outcome, you'll have to experiment with different settings in your CNC software and see which work best
  • For CNC users, the rest of the 3D printer settings can be left at their default level. Be aware that using a >1x z-scale can help to make low-relief terrain more interesting. However, this can also be done later in your CNC software.


  • Auto-height values for z-scaling: Many users who leave the z-scale value at the default 1x may be missing out 3D terrain prints that are more visually appealing, especially in low-relief areas. It good practice to set a z-scale that end up creating a 3D print with at least 50 layers, as less layers will not be able to image small terrain details, such as meandering river beds. 
  • However, it can be a pain to determine the "best" z-scale, which in TouchTerrain can really only be done through trial and error using the Preview, (It is much easier to increase the z-scale in the slicer software until it looks interesting!). I've added a few presets for the desired height of the model (i.e. the physical distance from the lowest elevation to the highest) in either mm or inches. 
  • A height of 20 mm is good starting value. Preview the model and change the height as desired. The actually used z-scale will be given in the log file.


  • kmz files for polygons: You can now use kmz and kml files to provide polygons to define your print area's boundary








Wednesday, March 31, 2021

TouchTerrain Story Map

I've made my first ever ESRI Story map about TouchTerrain:  https://arcg.is/11Cv5D It re-uses some of the material from the AGU 2020 conference poster but is far slicker!





Tuesday, March 30, 2021

Version 3.2.1: Z-scale bug fix

Z-scale fix 

  • Well, this is embarrassing! Simon Scherrer recently pointed out that my mesh models where hilariously tall when applying a large z-scale. 
  • Turns out that at one point I had done the z-scaling in one function, then forgot about it and applied it again in another function! 
  • While easily fixed, this means that any z-scale larger than 1.0 was wrong (not sure since when, must be several years ...). For most users that's likely not an issue b/c it wasn't that obvious at low (>1.0) z-scales and many (including) myself have no real world experience with how a certain z-scale should properly  look like. (This is what convinced me that my old z-scale of 5 was WAY too much! Also, I like that they call the z-scale Boost factor!)
  • Also, I think most user would have dialed in a appropriate z-scale  based on visual inspection. However, if you've been using TouchTerrain for anything scientific where proper z-scale matters you should account for my error and either correct your effective z-scale to the square of what you requested pre version 3.2.1 or re-do you model with the new (correct) z-scale method now in place. 
Old (pre version 3.2.1) z-scale of 5 aka Mordor mode!







Hillshaded relief with proper z-scale of 5

Fixed (>= version 3.2.1) z-scale of 5

  • Again, thanks to Simon Scherrer for bringing this to my attention!




Friday, March 12, 2021

What's new in TouchTerrain Version 3.2?

Docker version of TouchTerrain

  • I created a Docker image of TouchTerrain that makes is easy(er) to run the stand-alone version via a jupyter notebook.
  • After installing the image and running the container, you will have a virtual Linux box running inside your PC/Mac, with all required python packages already installed.
  • Shell scripts are provided to install the latest version of TouchTerrain and to run a jupyter server inside the container. The server that can be accessed through your standard, local browser and you can download and upload files through jupyter.
  • A new notebook (TouchTerrain_jupyter_for_starters.ipynb) will hopefully make is easy for beginners to work through the workflow of creating a 3D terrain model file in standalone mode.
  • The github repo for the Docker version is: 
    https://github.com/ChHarding/TouchTerrain_jupyter_docker 


Added two new DEM sources:

  • NRCan/CDEM: The Canadian Digital Elevation Model (CDEM) is part of Natural Resources Canada's (NRCan) altimetry system and stems from the existing Canadian Digital Elevation Data (CDED). The CDEM is comprised of multiple DEMs with varying resolutions. These vary according to latitude and have a base resolution of 0.75 arc-seconds (about 20m).

  • AU/GA/AUSTRALIA_5M_DEM: The Digital Elevation Model (DEM) 5 Metre Grid of Australia derived from LiDAR model represents a National 5 metre (bare earth) DEM which has been derived from some 236 individual LiDAR surveys between 2001 and 2015 covering an area in excess of 245,000 square kilometres. All available 1 metre resolution LiDAR-derived DEMs have been compiled and resampled using a neighbourhood-mean method to 5 metre resolution.

Note that both DEMs are image collections, rather than a single image as can seen here for the Australia DEM (black patches):




Zoomed into an urban area. As Lidar cannot image water surfaces, these areas will always be set to NaN and will be omitted from the terrain model.






Even at "only" 5 m resolution, it still shows some nice details!






























CDEM coverage: