Changes between Version 3 and Version 4 of Tutorials/Digital Twins/Geo2Sig Map Getting Started

Timestamp:

Jan 21, 2026, 5:37:19 PM (5 days ago)

Author:

srivera2

Comment:

—

Tutorials/Digital Twins/Geo2Sig Map Getting Started

@@ -13 +13 @@
 * Building height calibration using Digital Elevation Models (DEMs)
 
-This drastically improves the accuracy of the environment being processed by the ML-based Propagation Model or a ray tracer of your choice. Throughout the following notebook examples, we utilize Sionna RT. This package is open-source and highly accurate for generating coverage maps. If you are unfamiliar with Sionna RT, feel free to read Nvidia's [https://arxiv.org/abs/2504.21719 Technical Report] to better understand how it works.
+This drastically improves the accuracy of the environment being processed by the ML-based Propagation Model or a ray tracer of your choice. Throughout the following notebook examples, we utilize Sionna RT. This package is open-source and highly accurate for generating coverage maps. If you are unfamiliar with Sionna RT, feel free to read Nvidia's [https://arxiv.org/abs/2504.21719 Technical Report] to better understand how it works. Tutorials for Sionna can be found [here https://nvlabs.github.io/sionna/rt/tutorials.html].
 
 === Prerequisites ===
 
+To use Geo2SigMap with ease, we **strongly** suggest managing python packages using Anaconda. Anaconda's package manager, [https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html conda], offers everything you need with no extra configuration. It becomes extremely useful while running the notebook examples in the [wiki:Demos] section.
+
+The installation process should ensure that all required packages are installed. In the event of any issue, this is the [https://github.com/bndr/pipreqs pipreqs] list as of 1/21/2025:
+
+{{{#!div style="font-size: 100%"
+  {{{#!python
+  osmnx >= 2.0.0
+  numpy
+  pyproj
+  shapely
+  rasterio
+  tqdm
+  pillow
+  open3d
+  }}}
+}}}
+
+Given the large overhead for ray tracing and ML tasks, access to a dedicated GPU is also suggested. Using Sionna RT with a CPU is limited and will restrict the possibilities 
+
 === Package Installation ===
+
+1. Create the Conda Environment:
+
+   {{{
+   #!sh
+   conda create --yes --name g2sm --channel conda-forge pdal python=3.12
+   conda activate g2sm
+   pip install pyvista==0.45.2
+   }}}
+
+   If you opt not to use conda, please note the additional installation of pyvista v0.45.2
+
+2. Clone and Install geo2sigmap:
+
+   {{{
+   #!sh
+   git clone https://github.com/functions-lab/geo2sigmap
+   cd geo2sigmap/package
+   pip install .
+   }}}
+
+   The package is now installed and can be called via the CLI tool **or** using the Python function API.
 
 === Demos ===