Complete guide to creating stunning 3D printable terrain models
3D Topo Generator is a web application for creating 3D printable terrain models from digital elevation data. Select any area on Earth, configure your model settings, and export files for different workflows. Browser mode supports advanced local export options, while cloud mode provides server-side DEM processing with STL download. You can also place custom pins on the map and include them in browser-mode exports.
💡 Perfect for: Architects, educators, geologists, cartographers, and 3D printing enthusiasts who want to create accurate terrain models.
If you need very large geospatial pipelines, advanced GIS analysis, or highly custom production modeling, tools like ArcGIS/QGIS/Blender remain better suited. 3D Topo Generator is optimized for fast terrain-to-print workflows with minimal setup.
Generating highly detailed 3D printable terrain models requires significant computational power. This chapter explains the core processing options built into 3D Topo Generator to handle these demands effectively. You'll find guidance on optimal area sizes, expected processing times, and a detailed breakdown of the two distinct execution paths available: Browser Processing (free, on-device compute via Web Workers for smaller areas) and Cloud Processing (a flexible, pay-as-you-go backend service designed for massive, high-resolution landscapes). Understanding these choices will help you select the most efficient and cost-effective workflow for your specific project needs.
When creating a bounding box larger than 100 km², you'll see a warning. For best results with large areas, increase the resolution reduction factor or switch to Cloud mode.
Choose how your 3D models are generated. Both modes use your OpenTopography API key, but the execution model is different.
In Browser Processing, data download and mesh generation run locally on your device. Heavy mesh computation is offloaded to a dedicated background thread so the UI remains responsive during generation.
In Cloud Processing, generation is submitted as an asynchronous backend job. After you confirm credits and start generation, the selected box is queued on the cloud service, processed remotely, and then returned to your Cloud Jobs dashboard for download when complete. To activate and use this modality, you simply need to purchase a prepaid credit pack (via a PayPal account or guest checkout; no PayPal registration required). This is deliberately designed as a pay-as-you-go model rather than a recurring subscription, ensuring you only pay for exactly what you need, when you need it.
In Cloud mode, generating 3D models uses credits from your prepaid packages. The cost is calculated dynamically based on the requested area size. An example table and a live calculator are provided below to help you estimate costs.
Enter a custom area size to see the exact credits required for cloud processing.
You can run the full application locally using Docker. This is perfect for developers or users who prefer a containerized environment.
# Option 1: Run directly from Docker Hub (No installation needed)
docker run -p 8080:80 sicilian4ever/3d-topo-generator:latest
# Option 2: Run in background (detached mode)
docker run -d -p 8080:80 --name 3d-topo sicilian4ever/3d-topo-generator:latest
# Option 3: Run on a different port (e.g., 3000)
docker run -p 3000:80 sicilian4ever/3d-topo-generator:latest
# Access the application
# Open your browser and visit: http://localhost:8080 (or your custom port)The application is compatible with all modern browsers:
⚠️ Note: Internet Explorer is not supported. Please use a modern browser for the best experience.
When you first access the main application, a welcome modal appears with the 4 core steps to get started:
You can close this modal anytime and optionally hide it for the current session.
The workspace is organized for quick terrain selection and fast iteration:
💡 Integrated User Menu: Includes OT API Key, Processing Mode, Cloud Jobs, and Log Out. On desktop, it is collapsible and keeps your preferred open/closed state.
Follow this sequence from registration to model generation:
🎉 Pricing model: Browser mode is free. Cloud mode is optional and uses prepaid credits.
Credit purchase checkout: You can pay with a PayPal account or use guest checkout without creating a PayPal account.
⚠️ Important: You must be logged in to save and use an API key.
After creating or selecting a box, configure the model parameters in the box panel. These values control the final physical print size, terrain readability, and processing performance:
Open Processing Mode from the user menu and save your choice:
Quick comparison of the two end-to-end execution paths:
Current cloud export scope: one STL artifact per job.
After downloading your STL, you can estimate print costs using the free Print-Calculator tool. For models generated by this service, there is currently a required preparation step before the estimate is accurate.
Free Print-Calculator Tool: Open Print-Calculator from navigation at any time.
Compatible files: STL, OBJ, and 3DS from this app or other sources.
Important current behavior: when the model comes from this tool, import it into a slicer first, then export it to a compatible format (for example STL/OBJ/3DS as supported by Print-Calculator) before estimating cost. If you skip this conversion step, the estimate may be incorrect or errors can occur.
This extra conversion procedure is only needed at the moment for models generated by this service. Cost estimation works correctly with other models; root-cause analysis for this specific generator flow is still in progress.
The application supports multiple Digital Elevation Model sources, each with different coverage and resolution. Below you'll find detailed information about each DEM family:
An SRTM DEM is a Digital Elevation Model created from data collected by NASA's Shuttle Radar Topography Mission (SRTM) in 2000. It provides near-global elevation data for most of the world at resolutions of 3 arc-seconds (~90m) and 1 arc-second (~30m), filling gaps in elevation data to provide a continuous topographic surface. To be noted that SRTM15PLUS integrates the original Shuttle Radar Topography Mission (SRTM) land data with improved ocean bathymetry, which is derived from a combination of direct shipboard measurements and predicted depths using satellite altimetry.
AW3D30 is a global digital surface model (DSM) with a 30-meter (1 arcsec) horizontal resolution, generated from satellite stereo images by JAXA (Japan Aerospace Exploration Agency).
NASADEM (NASA Making Earth System Data Records for Use in Research Environments) is a digital elevation model (DEM) that provides global, near-global land elevation data at a resolution of 1 arc second (approximately 30 meters). It is a modernization of the original Shuttle Radar Topography Mission (SRTM) DEM, using improved processing techniques.
The Copernicus DEM is a Digital Surface Model (DSM) that represents the Earth's surface, including buildings, vegetation, and other infrastructure, in a 30-meter or 90-meter resolution format.
The European Digital Terrain Model (EU_DTM) is a 30-meter resolution model representing the bare-earth surface of Continental Europe, developed by Dr. Tom Hengl and the OpenGeoHub Foundation, using an Ensemble Machine Learning (EML) algorithm trained on various Digital Elevation Models (DEMs) and elevation data from GEDI and ICESat-2. Unlike the older EU-DEM, which was a Digital Surface Model and is no longer maintained, the EU_DTM specifically models the ground's terrain by removing vegetation and buildings, making it suitable for analyses requiring the underlying topography of the landscape.
The Global Ecosystem Dynamics Investigation (GEDI) produces high resolution laser ranging observations of the 3D structure of the Earth. GEDI's precise measurements of forest canopy height, canopy vertical structure, and surface elevation greatly advance the ability to characterize important carbon and water cycling processes, biodiversity, and habitat. GEDI was funded as a NASA Earth Ventures Instrument (EVI) mission. It was launched to the International Space Station in December 2018 and completed initial orbit checkout in April 2019.
The GEBCO DEM is a 15 arc-second resolution global elevation model that provides continuous coverage of both ocean depths (bathymetry) and land/ice surface heights (topography), with negative values representing water depths and positive values representing land/ice heights. Developed by the General Bathymetric Chart of the Oceans (GEBCO), it's a composite of diverse data sources, including satellite-derived gravity and ship-track soundings.
💡 Tip: Data quality and availability may vary by location. If one source doesn't work well, try another for better results. Each DEM source has its strengths depending on your specific use case and geographic area of interest.
Common issues and their solutions:
💡 Still having issues? Contact the developer for personalized support via the contact page.
Created by Carmelo Sammarco (Sicilian4Ever)
This application represents the intersection of geospatial science and modern web technology. Built with passion for cartography, 3D printing, and open-source software.
📧 Support: For issues and questions contact the developer.
Contact Developer