# Chat Transcript
Exploring the SAWGraph Hydrology Knowledge Graph
š¤ **User**
@hydrologykg
---
š§ **Assistant**
I'll help you explore the hydrologykg knowledge graph. Let me first get information about what this knowledge graph contains.
The **SAWGraph Hydrology KG** is now accessible. This knowledge graph integrates surface and groundwater data to help trace pollutant pathways and understand water connectivity. Here's what you can explore:
## Key Features:
**Surface Water:**
- Rivers, streams, lakes, and catchments from NHDPlus
- Flow paths and hydrological connectivity (upstream/downstream relationships)
- Water bodies like canals, estuaries, lagoons, and impoundments
**Groundwater:**
- Wells from Maine and Illinois geological surveys
- Aquifers and aquifer systems
- Well depths, purposes, yields, and types
**Public Water Systems:**
- Community and non-community water systems
- Water sources (groundwater vs. surface water)
- Service connections and population served
**Spatial Integration:**
- S2 cells (Level 13) for precise location
- Administrative regions (counties, states)
- ZIP code areas
- Topological relationships (contains, touches, crosses, overlaps)
## What would you like to explore?
Some example queries you could ask:
- Find wells in a specific county or state
- Trace upstream or downstream flow paths from a location
- Find public water systems and their sources
- Identify aquifers and connected wells
- Explore water features in specific catchments
What interests you?
---
š¤ **User**
Visualize the schema
---
š§ **Assistant**
I'll create a visual diagram of the SAWGraph Hydrology KG schema using Mermaid.
Here's the SAWGraph Hydrology KG schema visualization:
```mermaid
classDiagram
direction TB
%% Core Water Feature Classes
class WaterFeature {
<<abstract>>
}
class SurfaceWaterFeature
class SubsurfaceWaterFeature
class WaterFeatureRepresentation
%% Surface Water Features
class HY_HydroFeature {
<<abstract>>
}
class HY_WaterBody
class HY_Lake
class HY_River
class HY_Estuary
class HY_Lagoon
class HY_Impoundment
class HY_Canal
class HY_MainStem
%% Flow Paths and Catchments
class HY_FlowPath
class HY_ElementaryFlowPath
class HY_Catchment
class HY_CatchmentRealization
%% Groundwater Features
class GW_Aquifer {
+aquiferType
}
class AquiferWaterFeature
class MGS-Well {
+wellDepth
+wellOverburden
+wellType
+wellUse
}
class ISGS-Well {
+wellDepth
+wellPurpose
+wellYield
+owner
+ISWSId
}
%% Public Water Systems
class PublicWaterSystem {
+populationServed
+serviceConnections
+ownership
+firstReport
+lastReport
+deactivationDate
}
class PublicWaterSystem-CWS
class PublicWaterSystem-NCWS
class PublicWaterSystem-NTNCWS
class PublicWaterSystem-TNCWS
class PublicWaterSystem-GW
class PublicWaterSystem-SW
class PWS-SubFeature {
+activity
+type
+method
}
class PWS-ServiceArea {
+serviceAreaType
}
class CombinedDistributionSystem
%% Spatial Classes
class Feature
class SpatialObject
class Geometry
class Polygon
class MultiPolygon
class S2Cell
class S2Cell_Level13
class Region
class AdministrativeRegion
class ZipCodeArea
class RoadSegment
%% Measurement Classes
class QuantityValue {
+numericValue
+unit
}
class QuantityKind
class Unit
class FlowPathLength
%% Inheritance Relationships
WaterFeature <|-- SurfaceWaterFeature
WaterFeature <|-- SubsurfaceWaterFeature
SubsurfaceWaterFeature <|-- AquiferWaterFeature
HY_HydroFeature <|-- HY_WaterBody
HY_WaterBody <|-- HY_Lake
HY_WaterBody <|-- HY_River
HY_WaterBody <|-- HY_Estuary
HY_WaterBody <|-- HY_Lagoon
HY_WaterBody <|-- HY_Impoundment
HY_River <|-- HY_MainStem
HY_HydroFeature <|-- HY_Canal
HY_HydroFeature <|-- HY_FlowPath
HY_FlowPath <|-- HY_ElementaryFlowPath
HY_HydroFeature <|-- HY_Catchment
PublicWaterSystem <|-- PublicWaterSystem-CWS
PublicWaterSystem <|-- PublicWaterSystem-NCWS
PublicWaterSystem-NCWS <|-- PublicWaterSystem-NTNCWS
PublicWaterSystem-NCWS <|-- PublicWaterSystem-TNCWS
PublicWaterSystem <|-- PublicWaterSystem-GW
PublicWaterSystem <|-- PublicWaterSystem-SW
SpatialObject <|-- Feature
SpatialObject <|-- Geometry
Feature <|-- Region
Region <|-- AdministrativeRegion
Feature <|-- Cell
Cell <|-- S2Cell
S2Cell <|-- S2Cell_Level13
Geometry <|-- Polygon
Geometry <|-- MultiPolygon
%% Key Relationships
HY_FlowPath --> HY_FlowPath : downstreamFlowPath
HY_FlowPath --> HY_FlowPath : upstreamFlowPath
HY_FlowPath --> HY_FlowPath : downstreamFlowPathTC
HY_Catchment --> HY_CatchmentRealization : realizedCatchment
HY_HydroFeature --> HY_Catchment : encompassingCatchment
HY_FlowPath --> FlowPathLength : hasFlowPathLength
GW_Aquifer --> GW_Aquifer : gwAquiferSystemPart
GW_Aquifer --> GW_Aquifer : gwAquiferSystem
PublicWaterSystem --> PWS-SubFeature : hasPart
PublicWaterSystem --> PWS-ServiceArea : serviceArea
PublicWaterSystem --> PublicWaterSystem : buysFrom
PublicWaterSystem --> PublicWaterSystem : sellsTo
PublicWaterSystem --> CombinedDistributionSystem : inCombinedSystem
PWS-SubFeature --> PublicWaterSystem : partOf
Feature --> Geometry : hasGeometry
Feature --> Geometry : hasDefaultGeometry
S2Cell_Level13 --> Feature : sfContains
S2Cell_Level13 --> Feature : sfWithin
AdministrativeRegion --> Feature : sfContains
QuantityValue --> Unit : hasUnit
QuantityValue --> QuantityKind : hasQuantityKind
FlowPathLength --> QuantityValue : quantityValue
MGS-Well --> QuantityValue : wellDepth
MGS-Well --> QuantityValue : wellOverburden
ISGS-Well --> QuantityValue : wellDepth
ISGS-Well --> QuantityValue : wellYield
```
The diagram shows the main components of the SAWGraph Hydrology KG organized into five major categories:
1. **Water Features** - Abstract hierarchy for surface and subsurface water
2. **Surface Water** - Rivers, lakes, flow paths, and catchments with upstream/downstream connectivity
3. **Groundwater** - Aquifers and wells from Maine (MGS) and Illinois (ISGS) surveys
4. **Public Water Systems** - Community and non-community systems with their sources and service areas
5. **Spatial Integration** - S2 cells and administrative regions for geospatial queries
Key relationships enable tracing water flow and contamination pathways throughout the hydrological network.
---
*Created by [mcp-proto-okn](https://github.com/sbl-sdsc/mcp-proto-okn) 0.4.0 for hydrologykg on 2025-12-24*
claude-sonnet-4-20250514
