changed design pattern 1 over to facility location

Author: CBP1012

documentation/user-guides/design-patterns/Design Pattern 1/CQ1.sparql

@@ -0,0 +1,103 @@
+# Pattern Name
+Facility Location
+
+# Intent
+
+To represent location relationships where material entities (e.g., facilities, equipment, infrastructure) are situated within progressively larger geographic regions or sites (e.g., building → campus → city → state → country), enabling multi-level location queries and reasoning. The specific entity types and site hierarchies shown are examples. This pattern generalizes to any material entity that can be located at sites, and any hierarchical organization of sites.
+
+# Competency Questions
+
+1. Where is a specific facility located?
+2. What bigger site is this facility located in, and are there smaller sites that the facility is located in that are also located in the bigger site?
+3. What are all the facilities located within a particular site?
+
+# Structure
+
+Represents the location of a site and their appropriate relations with a broader area.
+
+Helps with creating transitive relations between sites.
+
+Visual model through mermaid and png.
+
+*Note: Entity types and location hierarchies shown are illustrative examples. This pattern applies to any material entities and site taxonomies relevant to your domain.*
+```mermaid
+flowchart BT
+    A@{ label: "<font color=\"#000000\">Facility 1</font>" } -- LocatedIn<br>BFO:0000171 --> B@{ label: "<font color=\"#000000\">City 1</font>" }
+    B -- LocatedIn<br>BFO:0000171 --> C@{ label: "<font color=\"#000000\">State 1</font>" }
+    A -- rdf:type --> D@{ label: "<span style=\"color:black\"><b>Facility<br>ont00000192</b></span><br>" }
+    B -- rdf:type --> E@{ label: "<span style=\"color:black\"><b>Site<br>BFO_0000029</b></span><br>" }
+    C -- rdf:type --> E
+    A -. rdfs:label .-> F["Building 1"]
+    B -. rdfs:label .-> G["NY City"]
+    C -. rdfs:label .-> H["NY State"]
+
+    subgraph Legend[" "]
+    direction LR
+    AA{Individual}
+    BB[Class]
+    CC[data]
+    AA --> |relation| CC
+    end
+
+    A ~~~ Legend
+
+    A@{ shape: diam}
+    B@{ shape: diam}
+    C@{ shape: diam}
+    D@{ shape: rect}
+    E@{ shape: rect}
+    F@{ shape: rect}
+    G@{ shape: rect}
+    H@{ shape: rect}
+    A:::purple
+    B:::purple
+    C:::purple
+    D:::yellow
+    E:::yellow
+    F:::white
+    G:::white
+    H:::white
+    classDef yellow fill:#ffe680
+    classDef purple fill:#dbc9ef
+    classDef white fill:#FFFFFF
+    class BB yellow
+    class AA purple
+    class CC white
+```
+
+# File Structure
+```
+facility-location/
+├── README.md
+├── mermaid/
+│   ├── FacilityLocation.md        # Mermaid source file
+│   └── FacilityLocation.png        # Exported PNG diagram
+└── sparql/
+    ├── CQ1.sparql     # Where is a specific facility located?
+    ├── CQ2.sparql        # What larger/smaller sites contain this facility?
+    ├── CQ3.sparql    # What facilities are within a particular site?
+    └── example.ttl                  # Test data for SPARQL queries
+```
+
+## File Descriptions
+
+### mermaid/
+| File | Description |
+|------|-------------|
+| `FacilityLocation.md` | Mermaid diagram source showing the pattern structure |
+| `FacilityLocation.png` | PNG export of the diagram for documentation |
+
+### sparql/
+| File | Competency Question |
+|------|---------------------|
+| `CQ1.sparql` | Where is a specific facility located? |
+| `CQ2.sparql` | What bigger site is this facility located in, and are there smaller sites that the facility is located in that are also located in the bigger site? |
+| `CQ3.sparql` | What are all the facilities located within a particular site? |
+| `example.ttl` | Turtle file with test instances (states, cities, campuses, buildings, facilities) |
+
+# Additional Notes
+
+- Related pattern: Geospatial Coordinate Pattern
+- Key classes: `obo:BFO_0000029` (Site), `cco:ont00000192` (Facility)
+- Key property: `obo:BFO_0000171` (located in)
+

documentation/user-guides/design-patterns/Design Pattern 1/CQ2.sparql

@@ -0,0 +1,43 @@
+flowchart BT
+    A@{ label: "<font color=\"#000000\">Facility 1</font>" } -- LocatedIn<br>BFO:0000171 --> B@{ label: "<font color=\"#000000\">City 1</font>" }
+    B -- LocatedIn<br>BFO:0000171 --> C@{ label: "<font color=\"#000000\">State 1</font>" }
+    A -- rdf:type --> D@{ label: "<span style=\"color:black\"><b>Facility<br>ont00000192</b></span><br>" }
+    B -- rdf:type --> E@{ label: "<span style=\"color:black\"><b>Site<br>BFO_0000029</b></span><br>" }
+    C -- rdf:type --> E
+    A -. rdfs:label .-> F["Building 1"]
+    B -. rdfs:label .-> G["NY City"]
+    C -. rdfs:label .-> H["NY State"]
+
+    subgraph Legend[" "]
+    direction LR
+    AA{Individual}
+    BB[Class]
+    CC[data]
+    AA --> |relation| CC
+    end
+
+    A ~~~ Legend
+
+    A@{ shape: diam}
+    B@{ shape: diam}
+    C@{ shape: diam}
+    D@{ shape: rect}
+    E@{ shape: rect}
+    F@{ shape: rect}
+    G@{ shape: rect}
+    H@{ shape: rect}
+    A:::purple
+    B:::purple
+    C:::purple
+    D:::yellow
+    E:::yellow
+    F:::white
+    G:::white
+    H:::white
+    classDef yellow fill:#ffe680
+    classDef purple fill:#dbc9ef
+    classDef white fill:#FFFFFF
+    class BB yellow
+    class AA purple
+    class CC white
+

documentation/user-guides/design-patterns/Design Pattern 1/CQ3.sparql

@@ -0,0 +1,15 @@
+# CQ1: Where is a specific facility located?
+# Returns the immediate site(s) where a given facility is located
+
+PREFIX : <https://www.commoncoreontologies.org/CommonCoreOntologiesMerged/>
+PREFIX cco: <https://www.commoncoreontologies.org/>
+PREFIX obo: <http://purl.obolibrary.org/obo/>
+PREFIX rdfs: <http://www.w3.org/2000/01/rdf-schema#>
+
+SELECT ?facility ?facilityLabel ?site ?siteLabel
+WHERE {
+    ?facility a cco:ont00000192 ;
+              rdfs:label ?facilityLabel ;
+              obo:BFO_0000171 ?site .
+    ?site rdfs:label ?siteLabel .
+}