voxcity 0.3.5__py3-none-any.whl → 0.3.7__py3-none-any.whl

voxcity/geo/network.py

@@ -180,7 +180,8 @@ def get_network_values(grid, rectangle_vertices, meshsize, value_name='value', *
                                 vmin=settings['vmin'],
                                 vmax=settings['vmax'],
                                 linewidth=settings['edge_width'],
-                                legend_kwds={'label': value_name})
+                                legend_kwds={'label': value_name,
+                                           'shrink': 0.5})  # Make colorbar 50% smaller
         
         ctx.add_basemap(ax,
                        source=settings['basemap_style'],

voxcity/sim/solar.py

@@ -651,6 +651,8 @@ def get_global_solar_irradiance_using_epw(
             - calc_time (str): Time for instantaneous calculation ('MM-DD HH:MM:SS')
             - start_time (str): Start time for cumulative calculation
             - end_time (str): End time for cumulative calculation
+            - start_hour (int): Starting hour for daily time window (0-23)
+            - end_hour (int): Ending hour for daily time window (0-23)
             - view_point_height (float): Observer height in meters
             - tree_k (float): Tree extinction coefficient
             - tree_lad (float): Leaf area density in m^-1
@@ -675,11 +677,11 @@ def get_global_solar_irradiance_using_epw(
             return None
         else:
             # Calculate center point of rectangle
-            lats = [coord[0] for coord in rectangle_vertices]
-            lons = [coord[1] for coord in rectangle_vertices]
-            center_lat = (min(lats) + max(lats)) / 2
+            lons = [coord[0] for coord in rectangle_vertices]
+            lats = [coord[1] for coord in rectangle_vertices]
             center_lon = (min(lons) + max(lons)) / 2
-            target_point = (center_lat, center_lon)
+            center_lat = (min(lats) + max(lats)) / 2
+            target_point = (center_lon, center_lat)
 
             # Optional: specify maximum distance in kilometers
             max_distance = 100  # None for no limit
@@ -687,8 +689,8 @@ def get_global_solar_irradiance_using_epw(
             output_dir = kwargs.get("output_dir", "output")
 
             epw_file_path, weather_data, metadata = get_nearest_epw_from_climate_onebuilding(
-                latitude=center_lat,
                 longitude=center_lon,
+                latitude=center_lat,
                 output_dir=output_dir,
                 max_distance=max_distance,
                 extract_zip=True,
@@ -743,10 +745,17 @@ def get_global_solar_irradiance_using_epw(
             **kwargs
         )
     if calc_type == 'cumulative':
+        # Get time window parameters
+        start_hour = kwargs.get("start_hour", 0)  # Default to midnight
+        end_hour = kwargs.get("end_hour", 23)     # Default to 11 PM
+        
+        # Filter dataframe for specified hours
+        df_filtered = df[df.index.hour.between(start_hour, end_hour)]
+        
         solar_map = get_cumulative_global_solar_irradiance(
             voxel_data,
             meshsize,
-            df, lat, lon, tz,
+            df_filtered, lat, lon, tz,
             **kwargs
         )
     

voxcity/utils/weather.py

@@ -512,8 +512,8 @@ def read_epw_for_solar_simulation(epw_file_path):
         month = int(vals[1])
         day = int(vals[2])
         hour = int(vals[3]) - 1
-        dni = float(vals[13])
-        dhi = float(vals[14])
+        dni = float(vals[14])
+        dhi = float(vals[15])
         timestamp = pd.Timestamp(year, month, day, hour)
         data.append([timestamp, dni, dhi])
 

{voxcity-0.3.5.dist-info → voxcity-0.3.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: voxcity
-Version: 0.3.5
+Version: 0.3.7
 Summary: voxcity is an easy and one-stop tool to output 3d city models for microclimate simulation by integrating multiple geospatial open-data
 Author-email: Kunihiko Fujiwara <kunihiko@nus.edu.sg>
 Maintainer-email: Kunihiko Fujiwara <kunihiko@nus.edu.sg>
@@ -330,7 +330,7 @@ solar_kwargs = {
 }
 
 # Compute global solar irradiance map (direct + diffuse radiation)
-global_map = get_global_solar_irradiance_using_epw(    
+solar_grid = get_global_solar_irradiance_using_epw(    
     voxcity_grid,                        # 3D voxel grid representing the urban environment
     meshsize,                            # Size of each voxel in meters
     calc_type='instantaneous',           # Calculate instantaneous irradiance at specified time
@@ -345,7 +345,7 @@ solar_kwargs["end_time"] = "01-31 23:00:00" # End time for cumulative calculatio
 solar_kwargs["output_file_name"] = 'cummulative_solar_irradiance',  # Base filename for outputs (without extension)
 
 # Calculate cumulative solar irradiance over the specified time period
-global_map = get_global_solar_irradiance_using_epw(    
+cum_solar_grid = get_global_solar_irradiance_using_epw(    
     voxcity_grid,                        # 3D voxel grid representing the urban environment
     meshsize,                            # Size of each voxel in meters
     calc_type='cumulative',              # Calculate cumulative irradiance over time period instead of instantaneous
@@ -418,6 +418,38 @@ landmark_vis_map = get_landmark_visibility_map(voxcity_grid, building_id_grid, b
   <em>Example Result Saved as OBJ and Rendered in Rhino</em>
 </p>
 
+#### Network Analysis:
+
+```python
+from voxcity.geo.network import get_network_values
+
+network_kwargs = {
+    "network_type": "walk",        # Type of network to download from OSM (walk, drive, all, etc.)
+    "colormap": "magma",          # Matplotlib colormap for visualization
+    "vis_graph": True,            # Whether to display the network visualization
+    "vmin": 0.0,                  # Minimum value for color scaling
+    "vmax": 600000,               # Maximum value for color scaling
+    "edge_width": 2,              # Width of network edges in visualization
+    "alpha": 0.8,                 # Transparency of network edges
+    "zoom": 16                    # Zoom level for basemap
+}
+
+G, edge_gdf = get_network_values(
+    cum_solar_grid,               # Grid of cumulative solar irradiance values
+    rectangle_vertices,           # Coordinates defining simulation domain boundary
+    meshsize,                     # Size of each grid cell in meters
+    value_name='Cumulative Global Solar Irradiance (W/m²·hour)',  # Label for values in visualization
+    **network_kwargs              # Additional visualization and network parameters
+)
+```
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/kunifujiwara/VoxCity/main/images/network.png" alt="Example of Graph Output" width="500">
+</p>
+<p align="center">
+  <em>Cumulative Global Solar Irradiance (kW/m²·hour) on Road Network</em>
+</p>
+
 ## References of Data Sources
 
 ### Building 

{voxcity-0.3.5.dist-info → voxcity-0.3.7.dist-info}/RECORD

@@ -17,20 +17,20 @@ voxcity/file/obj.py,sha256=oW-kPoZj53nfmO9tXP3Wvizq6Kkjh-QQR8UBexRuMiI,21609
 voxcity/geo/__init_.py,sha256=AZYQxK1zY1M_mDT1HmgcdVI86OAtwK7CNo3AOScLHco,88
 voxcity/geo/draw.py,sha256=roljWXyqYdsWYkmb-5_WNxrJrfV5lnAt8uZblCCo_3Q,13555
 voxcity/geo/grid.py,sha256=_MzO-Cu2GhlP9nuCql6f1pfbU2_OAL27aQ_zCj1u_zk,36288
-voxcity/geo/network.py,sha256=xKWBJHg-l7CHnC1-_k-aYfkI-GNEKCp57gTZZwJXuFs,6804
+voxcity/geo/network.py,sha256=iBgvOaM4YPQKL5gnAU9rxe3ZlJLTjLIt7DoAIWzZRfs,6892
 voxcity/geo/utils.py,sha256=1BRHp-DDeOA8HG8jplY7Eo75G3oXkVGL6DGONL4BA8A,19815
 voxcity/sim/__init_.py,sha256=APdkcdaovj0v_RPOaA4SBvFUKT2RM7Hxuuz3Sux4gCo,65
-voxcity/sim/solar.py,sha256=7waUoUMzDBf_Van3qghSG019TrgHgNj-TcVRVf0StuU,31306
+voxcity/sim/solar.py,sha256=9vyzLCBiASh85b1TRRG4gFqSmMcbI0i-2sBdPrswMyM,31783
 voxcity/sim/utils.py,sha256=sEYBB2-hLJxTiXQps1_-Fi7t1HN3-1OPOvBCWtgIisA,130
 voxcity/sim/view.py,sha256=oq6G-f0Tn-KT0vjYNJfucmOIrv1GNjljhA-zvU4nNoA,36668
 voxcity/utils/__init_.py,sha256=nLYrj2huBbDBNMqfchCwexGP8Tlt9O_XluVDG7MoFkw,98
 voxcity/utils/lc.py,sha256=RwPd-VY3POV3gTrBhM7TubgGb9MCd3nVah_G8iUEF7k,11562
 voxcity/utils/material.py,sha256=Vt3IID5Ft54HNJcEC4zi31BCPqi_687X3CSp7rXaRVY,5907
 voxcity/utils/visualization.py,sha256=FNBMN0V5IPuAdqvLHnqSGYqNS7jWesg0ZADEtsUtl0A,31925
-voxcity/utils/weather.py,sha256=fJ2p5susoMgYSBlrmlTlZVUDe9kpQwmLuyv1TgcOnDM,21482
-voxcity-0.3.5.dist-info/AUTHORS.rst,sha256=m82vkI5QokEGdcHof2OxK39lf81w1P58kG9ZNNAKS9U,175
-voxcity-0.3.5.dist-info/LICENSE,sha256=-hGliOFiwUrUSoZiB5WF90xXGqinKyqiDI2t6hrnam8,1087
-voxcity-0.3.5.dist-info/METADATA,sha256=ZQfsmx9_kNBV9fDtdBuKU4PHTX-lG5WXnzbzRdHjpoo,23630
-voxcity-0.3.5.dist-info/WHEEL,sha256=A3WOREP4zgxI0fKrHUG8DC8013e3dK3n7a6HDbcEIwE,91
-voxcity-0.3.5.dist-info/top_level.txt,sha256=00b2U-LKfDllt6RL1R33MXie5MvxzUFye0NGD96t_8I,8
-voxcity-0.3.5.dist-info/RECORD,,
+voxcity/utils/weather.py,sha256=P6s1y_EstBL1OGP_MR_6u3vr-t6Uawg8uDckJnoI7FI,21482
+voxcity-0.3.7.dist-info/AUTHORS.rst,sha256=m82vkI5QokEGdcHof2OxK39lf81w1P58kG9ZNNAKS9U,175
+voxcity-0.3.7.dist-info/LICENSE,sha256=-hGliOFiwUrUSoZiB5WF90xXGqinKyqiDI2t6hrnam8,1087
+voxcity-0.3.7.dist-info/METADATA,sha256=B78MYc4ThBH3XI2d-3R7UrkFjVpThF0j66z_JcOwmmE,25087
+voxcity-0.3.7.dist-info/WHEEL,sha256=A3WOREP4zgxI0fKrHUG8DC8013e3dK3n7a6HDbcEIwE,91
+voxcity-0.3.7.dist-info/top_level.txt,sha256=00b2U-LKfDllt6RL1R33MXie5MvxzUFye0NGD96t_8I,8
+voxcity-0.3.7.dist-info/RECORD,,