voxcity 0.6.30__tar.gz → 0.6.32__tar.gz

{voxcity-0.6.30 → voxcity-0.6.32}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voxcity
-Version: 0.6.30
+Version: 0.6.32
 Summary: voxcity is an easy and one-stop tool to output 3d city models for microclimate simulation by integrating multiple geospatial open-data
 License: MIT
 License-File: AUTHORS.rst
@@ -247,14 +247,14 @@ kwargs = {
 
 ### 4. Get voxcity Output
 
-Generate voxel data grids and corresponding building geoJSON:
+Generate voxel data grids and a corresponding building GeoDataFrame:
 
 ```python
 from voxcity.generator import get_voxcity
 
 voxcity_grid, building_height_grid, building_min_height_grid, \
-building_id_grid, canopy_height_grid, canopy_bottom_height_grid, land_cover_grid, dem_grid, \
-building_gdf = get_voxcity(
+    building_id_grid, canopy_height_grid, canopy_bottom_height_grid, land_cover_grid, dem_grid, \
+    building_gdf = get_voxcity(
     rectangle_vertices,
     building_source,
     land_cover_source,
@@ -265,6 +265,10 @@ building_gdf = get_voxcity(
 )
 ```
 
+### Interactive 3D Demo (Plotly)
+
+- **Open interactive demo**: <a href="https://voxcity.readthedocs.io/en/latest/_static/plotly/voxcity_demo.html">Launch the Plotly 3D viewer</a>
+
 ### 5. Exporting Files
 
 #### ENVI-MET INX/EDB Files:
@@ -301,6 +305,7 @@ from voxcity.exporter.obj import export_obj
 
 output_directory = "output"  # Directory where output files will be saved
 output_file_name = "voxcity" # Base name for the output OBJ file
+# export_obj signature: export_obj(array, output_dir, file_name, voxel_size, voxel_color_map=None)
 export_obj(voxcity_grid, output_directory, output_file_name, meshsize)
 ```
 The generated OBJ files can be opened and rendered in the following 3D visualization software:
@@ -372,7 +377,7 @@ solar_grid = get_global_solar_irradiance_using_epw(
 # Adjust parameters for cumulative calculation
 solar_kwargs["start_time"] = "01-01 01:00:00" # Start time for cumulative calculation
 solar_kwargs["end_time"] = "01-31 23:00:00" # End time for cumulative calculation
-solar_kwargs["output_file_name"] = 'cummulative_solar_irradiance',  # Base filename for outputs (without extension)
+solar_kwargs["output_file_name"] = 'cumulative_solar_irradiance'  # Base filename for outputs (without extension)
 
 # Calculate cumulative solar irradiance over the specified time period
 cum_solar_grid = get_global_solar_irradiance_using_epw(    

{voxcity-0.6.30 → voxcity-0.6.32}/README.md

@@ -185,14 +185,14 @@ kwargs = {
 
 ### 4. Get voxcity Output
 
-Generate voxel data grids and corresponding building geoJSON:
+Generate voxel data grids and a corresponding building GeoDataFrame:
 
 ```python
 from voxcity.generator import get_voxcity
 
 voxcity_grid, building_height_grid, building_min_height_grid, \
-building_id_grid, canopy_height_grid, canopy_bottom_height_grid, land_cover_grid, dem_grid, \
-building_gdf = get_voxcity(
+    building_id_grid, canopy_height_grid, canopy_bottom_height_grid, land_cover_grid, dem_grid, \
+    building_gdf = get_voxcity(
     rectangle_vertices,
     building_source,
     land_cover_source,
@@ -203,6 +203,10 @@ building_gdf = get_voxcity(
 )
 ```
 
+### Interactive 3D Demo (Plotly)
+
+- **Open interactive demo**: <a href="https://voxcity.readthedocs.io/en/latest/_static/plotly/voxcity_demo.html">Launch the Plotly 3D viewer</a>
+
 ### 5. Exporting Files
 
 #### ENVI-MET INX/EDB Files:
@@ -239,6 +243,7 @@ from voxcity.exporter.obj import export_obj
 
 output_directory = "output"  # Directory where output files will be saved
 output_file_name = "voxcity" # Base name for the output OBJ file
+# export_obj signature: export_obj(array, output_dir, file_name, voxel_size, voxel_color_map=None)
 export_obj(voxcity_grid, output_directory, output_file_name, meshsize)
 ```
 The generated OBJ files can be opened and rendered in the following 3D visualization software:
@@ -310,7 +315,7 @@ solar_grid = get_global_solar_irradiance_using_epw(
 # Adjust parameters for cumulative calculation
 solar_kwargs["start_time"] = "01-01 01:00:00" # Start time for cumulative calculation
 solar_kwargs["end_time"] = "01-31 23:00:00" # End time for cumulative calculation
-solar_kwargs["output_file_name"] = 'cummulative_solar_irradiance',  # Base filename for outputs (without extension)
+solar_kwargs["output_file_name"] = 'cumulative_solar_irradiance'  # Base filename for outputs (without extension)
 
 # Calculate cumulative solar irradiance over the specified time period
 cum_solar_grid = get_global_solar_irradiance_using_epw(    

{voxcity-0.6.30 → voxcity-0.6.32}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "voxcity"
-version = "0.6.30"
+version = "0.6.32"
 description = "voxcity is an easy and one-stop tool to output 3d city models for microclimate simulation by integrating multiple geospatial open-data"
 readme = "README.md"
 license = "MIT"

{voxcity-0.6.30 → voxcity-0.6.32}/src/voxcity/geoprocessor/mesh.py

@@ -318,7 +318,9 @@ def create_sim_surface_mesh(sim_grid, dem_grid,
             if np.isnan(val):
                 continue
 
-            z_base = meshsize * int(dem_grid_flipped[x, y] / meshsize + 1.5) + z_offset            
+            # Match voxel ground rounding: int(dem/mesh + 0.5) + 1 == int(dem/mesh + 1.5)
+            # Then lower the plane by one mesh layer as requested
+            z_base = meshsize * int(dem_grid_flipped[x, y] / meshsize + 1.5) + z_offset - meshsize            
 
             # 4 corners in (x,y)*meshsize
             v0 = [ x      * meshsize,  y      * meshsize, z_base ]