Skip to content

Commit 2600f54

Browse files
rdhyeeclaude
andauthored
refactor: Replace Path 1/Path 2 terminology with typed edge vocabulary (#44)
Replace ambiguous "Path 1" and "Path 2" terminology with precise typed edge vocabulary throughout tutorial documentation: - Path 1 → "Direct Location (EVENT_SAMPLE_LOCATION)" - Path 2 → "Site-Mediated Location (EVENT_SAMPLING_SITE → SITE_LOCATION)" Add documentation of the 14 iSamples typed edge types which provide unambiguous vocabulary for describing relationships: - MSR_PRODUCED_BY, EVENT_SAMPLE_LOCATION, EVENT_SAMPLING_SITE, SITE_LOCATION, etc. Updated files: - parquet_cesium.qmd: Full documentation section rewrite, code comments, UI text - parquet_cesium_wide.qmd: Same refactoring with wide format column mappings - oc_parquet_enhanced.qmd: 2 Path references updated This change improves documentation precision and aligns with Eric's canonical query formulation which requires both direct location AND site provenance. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude <[email protected]>
1 parent c291881 commit 2600f54

File tree

3 files changed

+206
-164
lines changed

3 files changed

+206
-164
lines changed

tutorials/oc_parquet_enhanced.qmd

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -190,16 +190,16 @@ viewof relationshipTable = Inputs.table(relationshipPatterns, {
190190
**Common Mistake**: Assuming direct Sample → Location relationships
191191
**Reality**: All location queries require multi-hop traversal through SamplingEvent
192192

193-
### The Correct Paths Discovered
193+
### The Correct Traversals Discovered (Using Typed Edges)
194194

195-
**Path 1: Direct Event Location**
195+
**Direct Location (via EVENT_SAMPLE_LOCATION)**
196196
```
197-
MaterialSampleRecord → produced_by → SamplingEvent → sample_location → GeospatialCoordLocation
197+
MaterialSampleRecord → MSR_PRODUCED_BY → SamplingEvent → EVENT_SAMPLE_LOCATION → GeospatialCoordLocation
198198
```
199199

200-
**Path 2: Via Site Location**
200+
**Site-Mediated Location (via EVENT_SAMPLING_SITE → SITE_LOCATION)**
201201
```
202-
MaterialSampleRecord → produced_by → SamplingEvent → sampling_site → SamplingSite → site_location → GeospatialCoordLocation
202+
MaterialSampleRecord → MSR_PRODUCED_BY → SamplingEvent → EVENT_SAMPLING_SITE → SamplingSite → SITE_LOCATION → GeospatialCoordLocation
203203
```
204204

205205
This discovery unlocked **1,096,274 samples** that were previously inaccessible due to incorrect query patterns!

0 commit comments

Comments
 (0)