Table of Contents

Load Real World Data Node

  • Category: Data
  • Edition: Vista Pro
  • Output type: Height and color map
  • Typical place in a graph: at the start of a graph that recreates a real place

Load Real World Data brings real elevation and satellite imagery into the graph. It reads a Data Provider asset, where you have selected a region on the map and downloaded its data, and outputs the region's height and color, stretched over the biome. Use it to build terrain from a real place, then erode, texture and populate it like any other height.

Real mountains from Colorado elevation data, remapped and shown as terrain

When to use it

  • Recreate a real mountain, valley or coastline.
  • Texture and populate from satellite imagery, with HSL Selector picking forest, grass and rock by color.
  • Not for: images you made yourself (use Load Texture).

Outputs

Slot Type What it holds
Height Map Mask The elevation, as a fraction of the provider's full height range (0 is its lowest possible height, 1 its highest). Empty if the asset has no height data.
Color Map Color The satellite or aerial imagery of the region. Empty if the asset has no imagery.

Properties

Property Default Range What it does
Data Provider Asset None A Data Provider asset The asset holding the downloaded region. Create one with Assets > Create > Vista > Data Provider (USGS), (Open Topography) or (Custom Tile Based), pick a region in its map view and download. See Data Provider assets. Without an asset, nothing comes out.

Below the field, the node shows the asset's Source Min Height and Source Max Height: the real heights, in meters, that 0 and 1 stand for.

Common properties

Property What it does
Id The node's unique name in this graph, shown for reference. You cannot edit it. Scripts and the AI workflow CLI use it to find the node.
Resolution How detailed this node's result is, in texels across the biome. The node has no input, so Relative To Main Input (default) and Relative To Graph both follow the biome's Canvas Resolution, times the multiplier below. Absolute sets an exact size. The data is resampled to that size. Absolute is limited to 32 to 512 in Vista Personal and 32 to 4096 in Vista Indie and Pro.
Split Execution Lets this node run over several frames so the editor stays responsive during long generations. It only works when Allow Split Execution is on in the graph settings. This node finishes in one step, so splitting only adds a short pause around it; leave it off.
Bypass Skips the node. Nothing comes out.

Examples

All examples use the Colorado sample data from the Vista Pro samples (Data_USGS_Colorado), on a 1024 × 1024 m biome with the Vista Manager's Max Height at 400 m.

Height Map, as loaded Color Map
2D: almost all bright red, a high, nearly flat range of values Satellite imagery: dark forest, pale rocky high ground
Height as loaded, in 3D Height through Remap (0 to 0.8)
A block of terrain raised close to the top of the height range The same land stretched into steep, detailed mountains
The values run from 0.615 to 1: this is high ground in USGS's range of -58 to 3922 m, so the land sits as a block near the terrain's top, with little relief. Stretching the values to 0 to 0.8 brings out the shape, ignoring the real proportions.

Recipes

Note

The height comes as a fraction of the provider's range, not as meters. Without remapping, real land usually looks flat or raised. Remap it with Real World Height Remap for true proportions, or with Remap or Levels for the shape only.

Note

The downloaded region is stretched over the biome, whatever its real size. Match the biome's size and proportions to the region for a true scale.

Tip

Different providers can serve different maps for the same region, such as heights from one and imagery from another. Use one Load Real World Data node per asset.

Performance

Very cheap: one copy per output in use. Downloading happens in the Data Provider asset, not in the graph.

For AI agents

  • Type name: LoadRealWorldDataNode (Vista Pro, Real World Data module). Outputs: Height Map = 100 (Mask), Color Map = 101 (ColorTexture). No inputs.
  • Property: dataProviderAsset (asset path of a DataProviderAsset: USGS, OpenTopography or Custom Tiled). Outputs are written only when the asset has the map.
  • Height values are 0 to 1 over the provider's source range (USGS -58.3733 to 3922.473 m, OpenTopography 0 to 10000 m). Measured on the Colorado sample: 0.615 to 1, mean 0.815.
  • Sample asset: Assets/PinwheelStudio/Vista/Pro/Real World Data/Samples/LocalBiomeWithWorldData/Data_USGS_Colorado.asset.