Skip to content

Commit 71fcac1

Browse files
kunifujiwarakunifujiwara
committed
docs(examples): remove decorative emoji from tutorial notebooks
Emoji in headings/text/prints are noisy in the demo notebooks. Strip them (keeping box-drawing separators and geometric UI-button glyphs), and replace the run-button reference with plain text.
1 parent aa2b451 commit 71fcac1

9 files changed

Lines changed: 70 additions & 70 deletions

‎docs/examples/demo_3d_visualization.ipynb‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,14 @@
44
"cell_type": "markdown",
55
"metadata": {},
66
"source": [
7-
"> 📘 **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
7+
"> **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
88
]
99
},
1010
{
1111
"cell_type": "markdown",
1212
"metadata": {},
1313
"source": [
14-
"# 🎨 VoxCity 3D Visualization\n",
14+
"# VoxCity 3D Visualization\n",
1515
"\n",
1616
"Visualize your 3D voxel city models using multiple methods.\n",
1717
"\n",
@@ -69,7 +69,7 @@
6969
"metadata": {},
7070
"source": [
7171
"---\n",
72-
"## 📦 OBJ Export\n",
72+
"## OBJ Export\n",
7373
"\n",
7474
"Export the voxel city to Wavefront OBJ format for use in external 3D software.\n",
7575
"\n",
@@ -91,7 +91,7 @@
9191
"metadata": {},
9292
"source": [
9393
"---\n",
94-
"## 🖼️ Static & Interactive Visualization\n",
94+
"## Static & Interactive Visualization\n",
9595
"\n",
9696
"### Static (PyVista)\n",
9797
"Renders multi-view images with orthographic or perspective projection.\n",
@@ -125,7 +125,7 @@
125125
"metadata": {},
126126
"source": [
127127
"---\n",
128-
"## 🎨 Color Mapping\n",
128+
"## Color Mapping\n",
129129
"\n",
130130
"VoxCity uses consistent colors for different element types:\n",
131131
"\n",

‎docs/examples/demo_basic.ipynb‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
"cell_type": "markdown",
55
"metadata": {},
66
"source": [
7-
"> 📘 **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
7+
"> **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
88
]
99
},
1010
{
@@ -13,7 +13,7 @@
1313
"id": "xsJJaZ01T6JH"
1414
},
1515
"source": [
16-
"# 🏙️ VoxCity Complete Demo\n",
16+
"# VoxCity Complete Demo\n",
1717
"\n",
1818
"**VoxCity** is a Python package for generating 3D voxel-based urban models from open geospatial data.\n",
1919
"\n",
@@ -38,9 +38,9 @@
3838
"id": "B24u-0E7UIo7"
3939
},
4040
"source": [
41-
"## ⚠️ Important Notes\n",
41+
"## Important Notes\n",
4242
"\n",
43-
"- Execute cells **in order** from Step 1 to Step 5 by clicking the ▶️ icons\n",
43+
"- Execute cells **in order** from Step 1 to Step 5 by clicking the run icons\n",
4444
"- In **Step 2**, choose **only ONE option** (Option 1, 2, or 3) for defining your study area\n",
4545
"- Some data sources require Google Earth Engine authentication\n",
4646
"- Model generation time depends on area size and voxel resolution"
@@ -53,7 +53,7 @@
5353
},
5454
"source": [
5555
"---\n",
56-
"# 📦 Step 1: Prepare Environment\n",
56+
"# Step 1: Prepare Environment\n",
5757
"\n",
5858
"Install VoxCity and set up authentication for data sources."
5959
]
@@ -139,7 +139,7 @@
139139
},
140140
"source": [
141141
"---\n",
142-
"# 📍 Step 2: Define Target Area\n",
142+
"# Step 2: Define Target Area\n",
143143
"\n",
144144
"Choose **ONE** of the following three options to define your study area.\n",
145145
"\n",
@@ -318,7 +318,7 @@
318318
},
319319
"source": [
320320
"---\n",
321-
"# ⚙️ Step 3: Configure Data Sources\n",
321+
"# Step 3: Configure Data Sources\n",
322322
"\n",
323323
"Select which data sources to use for buildings, terrain, land cover, and vegetation.\n",
324324
"\n",
@@ -387,7 +387,7 @@
387387
},
388388
"source": [
389389
"---\n",
390-
"# 🏗️ Step 4: Generate 3D Voxel Model\n",
390+
"# Step 4: Generate 3D Voxel Model\n",
391391
"\n",
392392
"This step downloads data from selected sources and creates the 3D voxel city model.\n",
393393
"\n",
@@ -482,7 +482,7 @@
482482
},
483483
"source": [
484484
"---\n",
485-
"# 💾 Step 5: Export to Different Formats\n",
485+
"# Step 5: Export to Different Formats\n",
486486
"\n",
487487
"Export your 3D city model to various formats for use in other applications.\n",
488488
"\n",

‎docs/examples/demo_data_sources.ipynb‎

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@
55
"id": "2dae9b81",
66
"metadata": {},
77
"source": [
8-
"> 📘 **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
8+
"> **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
99
]
1010
},
1111
{
1212
"cell_type": "markdown",
1313
"id": "eee9f384",
1414
"metadata": {},
1515
"source": [
16-
"# 🗂️ VoxCity Data Sources Guide\n",
16+
"# VoxCity Data Sources Guide\n",
1717
"\n",
1818
"This tutorial provides a comprehensive overview of all data sources available in VoxCity for building 3D urban voxel models.\n",
1919
"\n",
@@ -52,7 +52,7 @@
5252
"source": [
5353
"---\n",
5454
"\n",
55-
"## 🏢 Building Data Sources\n",
55+
"## Building Data Sources\n",
5656
"\n",
5757
"### 1. OpenStreetMap (OSM)\n",
5858
"**Coverage:** Global | **Cost:** Free | **Recommended for:** General worldwide use\n",
@@ -164,7 +164,7 @@
164164
"source": [
165165
"---\n",
166166
"\n",
167-
"## 🏔️ Terrain Data Sources (DEM/DTM)\n",
167+
"## Terrain Data Sources (DEM/DTM)\n",
168168
"\n",
169169
"### 1. DeltaDTM\n",
170170
"**Coverage:** Global | **Resolution:** 30m | **Recommended for:** General use\n",
@@ -242,7 +242,7 @@
242242
"source": [
243243
"---\n",
244244
"\n",
245-
"## 🌍 Land Cover Data Sources\n",
245+
"## Land Cover Data Sources\n",
246246
"\n",
247247
"### ESA WorldCover\n",
248248
"**Coverage:** Global | **Resolution:** 10m | **Recommended for:** Land use classification\n",
@@ -277,7 +277,7 @@
277277
"source": [
278278
"---\n",
279279
"\n",
280-
"## 🌳 Vegetation / Canopy Height Data\n",
280+
"## Vegetation / Canopy Height Data\n",
281281
"\n",
282282
"### High Resolution 1m Global Canopy Height Maps\n",
283283
"**Coverage:** Global | **Resolution:** 1m | **Recommended for:** Detailed tree heights\n",
@@ -308,7 +308,7 @@
308308
"source": [
309309
"---\n",
310310
"\n",
311-
"## 🔧 Using Data Sources with `get_voxcity()`\n",
311+
"## Using Data Sources with `get_voxcity()`\n",
312312
"\n",
313313
"The easiest way to use data sources is with the `get_voxcity()` function. It automatically combines multiple sources:"
314314
]
@@ -349,7 +349,7 @@
349349
"source": [
350350
"---\n",
351351
"\n",
352-
"## 📊 Data Source Comparison Table\n",
352+
"## Data Source Comparison Table\n",
353353
"\n",
354354
"| Source | Coverage | Resolution | Authentication | Best Use Case |\n",
355355
"|--------|----------|------------|----------------|---------------|\n",
@@ -372,7 +372,7 @@
372372
"id": "efc6109e",
373373
"metadata": {},
374374
"source": [
375-
"## 🔑 Google Earth Engine Setup\n",
375+
"## Google Earth Engine Setup\n",
376376
"\n",
377377
"Some data sources require Google Earth Engine authentication:\n",
378378
"\n",
@@ -388,7 +388,7 @@
388388
"id": "bd374843",
389389
"metadata": {},
390390
"source": [
391-
"## 📚 Next Steps\n",
391+
"## Next Steps\n",
392392
"\n",
393393
"Now that you understand the data sources, explore these tutorials:\n",
394394
"\n",
@@ -422,7 +422,7 @@
422422
"id": "87d21b61",
423423
"metadata": {},
424424
"source": [
425-
"## 🏗️ Building Data Sources\n",
425+
"## Building Data Sources\n",
426426
"\n",
427427
"### Primary Building Sources\n",
428428
"\n",
@@ -474,7 +474,7 @@
474474
"id": "28e547cf",
475475
"metadata": {},
476476
"source": [
477-
"## 🌿 Land Cover Sources\n",
477+
"## Land Cover Sources\n",
478478
"\n",
479479
"Land cover classification determines what's on the ground surface.\n",
480480
"\n",
@@ -520,7 +520,7 @@
520520
"id": "6648cec6",
521521
"metadata": {},
522522
"source": [
523-
"## 🌳 Canopy Height Sources\n",
523+
"## Canopy Height Sources\n",
524524
"\n",
525525
"Tree canopy heights for vegetation modeling.\n",
526526
"\n",
@@ -556,7 +556,7 @@
556556
"id": "1634a9bb",
557557
"metadata": {},
558558
"source": [
559-
"## ⛰️ DEM (Digital Elevation Model) Sources\n",
559+
"## DEM (Digital Elevation Model) Sources\n",
560560
"\n",
561561
"Terrain elevation data for accurate 3D representation.\n",
562562
"\n",
@@ -596,7 +596,7 @@
596596
"id": "aa8d9cf4",
597597
"metadata": {},
598598
"source": [
599-
"## 🤖 Automatic Data Source Selection\n",
599+
"## Automatic Data Source Selection\n",
600600
"\n",
601601
"VoxCity can automatically select the best data sources based on location:\n"
602602
]
@@ -620,7 +620,7 @@
620620
"print(\"Auto-selected data sources by location:\\n\")\n",
621621
"for city_name, coords in locations.items():\n",
622622
" sources = auto_select_data_sources(coords)\n",
623-
" print(f\"📍 {city_name}\")\n",
623+
" print(f\"{city_name}\")\n",
624624
" for source_type, source_name in sources.items():\n",
625625
" print(f\" {source_type}: {source_name}\")\n",
626626
" print()\n"
@@ -631,7 +631,7 @@
631631
"id": "4980984d",
632632
"metadata": {},
633633
"source": [
634-
"## 🔧 Custom Configuration Examples\n",
634+
"## Custom Configuration Examples\n",
635635
"\n",
636636
"### Example 1: High-Resolution USA City\n"
637637
]
@@ -749,7 +749,7 @@
749749
"id": "822d9d29",
750750
"metadata": {},
751751
"source": [
752-
"## 📁 Using Local Files\n",
752+
"## Using Local Files\n",
753753
"\n",
754754
"You can use your own geospatial files as data sources:\n"
755755
]
@@ -779,7 +779,7 @@
779779
"id": "56051d50",
780780
"metadata": {},
781781
"source": [
782-
"## 🌐 Google Earth Engine Authentication\n",
782+
"## Google Earth Engine Authentication\n",
783783
"\n",
784784
"Some data sources require Google Earth Engine. Here's how to authenticate:\n"
785785
]
@@ -828,7 +828,7 @@
828828
"id": "3dc8a829",
829829
"metadata": {},
830830
"source": [
831-
"## 📚 Summary\n",
831+
"## Summary\n",
832832
"\n",
833833
"### Quick Reference\n",
834834
"\n",

‎docs/examples/demo_envi-met.ipynb‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"id": "6a78bac2",
66
"metadata": {},
77
"source": [
8-
"> 📘 **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
8+
"> **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
99
]
1010
},
1111
{

‎docs/examples/demo_landmark.ipynb‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,14 @@
44
"cell_type": "markdown",
55
"metadata": {},
66
"source": [
7-
"> 📘 **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
7+
"> **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
88
]
99
},
1010
{
1111
"cell_type": "markdown",
1212
"metadata": {},
1313
"source": [
14-
"# 🏛️ VoxCity Landmark Visibility Analysis\n",
14+
"# VoxCity Landmark Visibility Analysis\n",
1515
"\n",
1616
"Analyze **visibility** of specific landmarks (buildings) from all locations in your study area using 3D ray-casting.\n",
1717
"\n",
@@ -79,7 +79,7 @@
7979
"metadata": {},
8080
"source": [
8181
"---\n",
82-
"## 🎯 Select Landmarks\n",
82+
"## Select Landmarks\n",
8383
"\n",
8484
"Three ways to specify which buildings are \"landmarks\":\n",
8585
"\n",
@@ -138,7 +138,7 @@
138138
"metadata": {},
139139
"source": [
140140
"---\n",
141-
"## 📊 Interpreting Results\n",
141+
"## Interpreting Results\n",
142142
"\n",
143143
"- **Visibility values**: 0 = not visible, 1 = fully visible\n",
144144
"- **Output**: Colored OBJ mesh showing visibility from each location\n",

‎docs/examples/demo_obj.ipynb‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,14 @@
44
"cell_type": "markdown",
55
"metadata": {},
66
"source": [
7-
"> 📘 **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
7+
"> **VoxCity tutorial** — part of the [tutorial series](index.md). Before running, make sure VoxCity is [installed](../installation.md); most data sources also require [Google Earth Engine authentication](../guides/earth_engine.md)."
88
]
99
},
1010
{
1111
"cell_type": "markdown",
1212
"metadata": {},
1313
"source": [
14-
"# 📦 VoxCity OBJ Export\n",
14+
"# VoxCity OBJ Export\n",
1515
"\n",
1616
"Export voxel city models and simulation results to Wavefront OBJ format for use in external 3D software.\n",
1717
"\n",
@@ -78,7 +78,7 @@
7878
"metadata": {},
7979
"source": [
8080
"---\n",
81-
"## 🏙️ Export Voxel City\n",
81+
"## Export Voxel City\n",
8282
"\n",
8383
"Export the full 3D voxel city model as an OBJ file with materials."
8484
]
@@ -98,7 +98,7 @@
9898
"metadata": {},
9999
"source": [
100100
"---\n",
101-
"## 📊 Export Simulation Results as Colored OBJ\n",
101+
"## Export Simulation Results as Colored OBJ\n",
102102
"\n",
103103
"Export 2D analysis grids (solar, view indices) as colored 3D surfaces.\n",
104104
"\n",

0 commit comments

Comments
 (0)