Skip to content

Commit b075da4

Browse files
committed
remove unused section numbers, leading zero section numbers, redundant bullets
1 parent 3b20990 commit b075da4

File tree

5 files changed

+37
-33
lines changed

5 files changed

+37
-33
lines changed

design/requirements.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ format:
55
toc: true
66
toc-location: body
77
toc-title: Contents
8+
number-sections: false
89
---
910

1011
## 01 Mint Identifiers

index.qmd

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,13 @@ The Internet of Samples (iSamples) is a multi-disciplinary and multi-institution
1010

1111
**Note**: iSamples Central is currently unavailable. The project now uses **geoparquet files** for efficient, browser-based data access and analysis:
1212

13-
- 📊 **[Interactive Tutorials](/tutorials/)** - Modern browser-based analysis with DuckDB-WASM
14-
- 🗺️ **Comprehensive Coverage** - Complete datasets from SESAR, OpenContext, GEOME, and Smithsonian
15-
- 🚀 **High Performance** - Fast, efficient data access with minimal memory usage
16-
- 🌐 **Universal Access** - Works in any modern browser without software installation
13+
📊 **[Interactive Tutorials](/tutorials/)** - Modern browser-based analysis with DuckDB-WASM
14+
<br/>
15+
🗺️ **Comprehensive Coverage** - Complete datasets from SESAR, OpenContext, GEOME, and Smithsonian
16+
<br/>
17+
🚀 **High Performance** - Fast, efficient data access with minimal memory usage
18+
<br/>
19+
🌐 **Universal Access** - Works in any modern browser without software installation
1720

1821
**Resources**
1922

models/index.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ listing:
1818
sort: "title asc"
1919
fields: [title, subtitle]
2020
type: table
21-
21+
number-sections: false
2222
---
2323

2424
see [description of model](https://isamplesorg.github.io/metadata/) at https://isamplesorg.github.io/metadata/

people.qmd

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,14 @@ title: "Some of those who contributed to iSamples"
77
* Cao, Sean
88
* Choe, Saebyl
99
* Cui, Hong
10-
* Davies, Neil
10+
* Davies, Neil (PI)
1111
* Deck, John
1212
* Kansa, Eric C
1313
* Kansa, Sarah Whitcher
1414
:::
1515
::: {.column width="34%"}
1616
* Kunze, John
17-
* Lehnert, Kerstin
17+
* Lehnert, Kerstin (PI)
1818
* Mandel, Danny
1919
* Meyer, Christopher
2020
* Ramdeen, Sarah
@@ -25,8 +25,8 @@ title: "Some of those who contributed to iSamples"
2525
* Robinson, Erin
2626
* Snyder, Rebecca
2727
* Song, Lu-lin
28-
* Thomer, Andrea
29-
* Vieglais, Dave
28+
* Thomer, Andrea (PI)
29+
* Vieglais, Dave (PI)
3030
* Walls, Ramona L
3131
* Yee, Raymond
3232
:::

tutorials/zenodo_isamples_analysis.qmd

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -12,20 +12,20 @@ format:
1212
theme: cosmo
1313
---
1414

15-
## Introduction
15+
# Introduction
1616

1717
This tutorial demonstrates how to efficiently analyze large geospatial datasets directly in your browser without downloading entire files. We'll use DuckDB-WASM and Observable JS to perform fast, memory-efficient analysis and create interactive visualizations.
1818

1919
**Note**: This tutorial attempts to connect to the live iSamples dataset (~300MB, 6+ million records). If CORS restrictions prevent access to the remote file, it automatically falls back to a representative demo dataset that demonstrates the same analytical techniques.
2020

21-
### Key Technologies
21+
## Key Technologies
2222

2323
- **DuckDB-WASM**: In-browser analytical database with HTTP range request support
2424
- **Observable Plot**: Grammar of graphics for interactive visualizations
2525
- **Observable Inputs**: Interactive controls for data exploration
2626
- **CORS Handling**: Automatic fallback for cross-origin restrictions
2727

28-
### Dataset Information
28+
## Dataset Information
2929

3030
**Primary dataset**:
3131
- **URL**: `https://labs.dataunbound.com/docs/2025/07/isamples_export_2025_04_21_16_23_46_geo.parquet` *(temporary for testing)*
@@ -40,7 +40,7 @@ This tutorial demonstrates how to efficiently analyze large geospatial datasets
4040
- **Size**: 10K records with same schema and representative geographic distribution
4141
- **Purpose**: Demonstrates all analytical techniques with faster loading
4242

43-
## Setup and Database Connection
43+
# Setup and Database Connection
4444

4545
```{ojs}
4646
//| label: test-reactivity
@@ -58,7 +58,7 @@ test_value = test_input
5858
test_output = test_value * 2
5959
6060
md`
61-
### 🧪 Reactivity Test
61+
## 🧪 Reactivity Test
6262
6363
**Raw input object**: ${typeof test_input} (Constructor: ${test_input?.constructor?.name})
6464
**Extracted value**: ${test_value}
@@ -241,7 +241,7 @@ createDemoData = async (conn) => {
241241
//| label: connection-status
242242
243243
md`
244-
### Connection Status
244+
## Connection Status
245245
246246
${working_parquet_url ?
247247
`✅ **Connected to live data**: Using ${working_parquet_url.includes('zenodo.org') ? 'Zenodo direct' : working_parquet_url.includes('cors-anywhere') ? 'CORS proxy' : 'original'} URL
@@ -255,7 +255,7 @@ ${working_parquet_url ?
255255
`
256256
```
257257

258-
## Basic Data Exploration
258+
# Basic Data Exploration
259259

260260
Let's start with fundamental queries to understand the dataset structure and size.
261261

@@ -289,7 +289,7 @@ geo_percentage = Math.round((geo_count / total_count) * 100)
289289
//| label: display-basic-stats
290290
291291
md`
292-
### Dataset Overview
292+
## Dataset Overview
293293
294294
- **Total records**: ${total_count.toLocaleString()}
295295
- **Records with coordinates**: ${geo_count.toLocaleString()} (${geo_percentage}%)
@@ -298,7 +298,7 @@ md`
298298
`
299299
```
300300

301-
## Source Collection Analysis
301+
# Source Collection Analysis
302302

303303
Analyze the distribution of samples across different source collections.
304304

@@ -389,7 +389,7 @@ source_chart = {
389389
}
390390
```
391391

392-
## Geographic Distribution Analysis
392+
# Geographic Distribution Analysis
393393

394394
Examine the geographic spread of samples and identify regional patterns.
395395

@@ -457,7 +457,7 @@ regional_data = {
457457
//| label: display-geo-stats
458458
459459
md`
460-
### Geographic Statistics
460+
## Geographic Statistics
461461
462462
- **Latitude range**: ${geo_stats.min_lat.toFixed(3)}° to ${geo_stats.max_lat.toFixed(3)}°
463463
- **Longitude range**: ${geo_stats.min_lon.toFixed(3)}° to ${geo_stats.max_lon.toFixed(3)}°
@@ -467,7 +467,7 @@ md`
467467
`
468468
```
469469

470-
## Interactive Regional Explorer
470+
# Interactive Regional Explorer
471471

472472
Create an interactive visualization to explore samples by region and source.
473473

@@ -538,7 +538,7 @@ regional_chart = {
538538
}
539539
```
540540

541-
## Efficient Sampling for Visualization
541+
# Efficient Sampling for Visualization
542542

543543
Create a representative sample of the data for detailed visualization while minimizing data transfer.
544544

@@ -614,7 +614,7 @@ sample_stats = {
614614
//| label: display-sample-stats
615615
616616
md`
617-
### Sample Statistics
617+
## Sample Statistics
618618
619619
**Total sample size**: ${sample_stats.total.toLocaleString()} points
620620
**Data transfer**: ~${Math.round(sample_stats.total * 6 * 8 / 1024 / 1024)} MB (estimated)
@@ -625,7 +625,7 @@ ${sample_stats.by_source.map(d => `- ${d.source}: ${d.count.toLocaleString()}`).
625625
`
626626
```
627627

628-
## Interactive World Map
628+
# Interactive World Map
629629

630630
Create an interactive scatter plot map showing the geographic distribution of samples.
631631

@@ -708,7 +708,7 @@ world_map = {
708708
}
709709
```
710710

711-
## Material Category Analysis
711+
# Material Category Analysis
712712

713713
Explore the distribution of material categories across different sources.
714714

@@ -864,25 +864,25 @@ material_by_source_chart = {
864864
}
865865
```
866866

867-
## Performance Summary
867+
# Performance Summary
868868

869869
This browser-based approach demonstrates remarkable efficiency compared to traditional methods.
870870

871871
```{ojs}
872872
//| label: performance-summary
873873
874874
md`
875-
## Performance Analysis
875+
# Performance Analysis
876876
877-
### Browser-Based vs Traditional Approaches
877+
## Browser-Based vs Traditional Approaches
878878
879879
| Approach | Time | Memory | Data Transfer | Environment |
880880
|----------|------|--------|---------------|-------------|
881881
| **Traditional (pandas)** | 40-150s | 600-1200 MB | 300 MB | Local Python |
882882
| **Our browser approach** | 10-30s | <100 MB | <5 KB + samples | Any browser |
883883
| **Improvement** | **~5x faster** | **~10x less memory** | **~99% less transfer** | **Universal** |
884884
885-
### Key Benefits
885+
## Key Benefits
886886
887887
✅ **Universal Access**: Runs in any modern browser
888888
✅ **Memory Efficient**: Analyze 300MB datasets using <100MB browser memory
@@ -891,7 +891,7 @@ md`
891891
✅ **Scalable**: Same approach works for GB or TB datasets
892892
✅ **Reproducible**: Self-contained analysis with no local setup required
893893
894-
### Technical Achievements
894+
## Technical Achievements
895895
896896
- **HTTP Range Requests**: Only downloads needed data portions
897897
- **Columnar Processing**: Parquet format enables efficient column-wise operations
@@ -903,13 +903,13 @@ This approach enables **big data analysis in any browser** and makes large-scale
903903
`
904904
```
905905

906-
## Additional Resources
906+
# Additional Resources
907907

908908
```{ojs}
909909
//| label: resources
910910
911911
md`
912-
### 📚 Learn More
912+
## 📚 Learn More
913913
914914
- [DuckDB-WASM Documentation](https://duckdb.org/docs/api/wasm/)
915915
- [Observable Plot](https://observablehq.com/plot/)
@@ -918,7 +918,7 @@ md`
918918
- [HTTP Range Requests](https://developer.mozilla.org/en-US/docs/Web/HTTP/Range_requests)
919919
- [iSamples Project](https://www.isamples.org/)
920920
921-
### 🔧 Technical Implementation
921+
## 🔧 Technical Implementation
922922
923923
This notebook demonstrates how to:
924924
1. Connect to remote Parquet files using DuckDB-WASM

0 commit comments

Comments
 (0)