Skip to content

Commit ef4bda3

Browse files
committed
borehole reqs images and tables
1 parent 4fea725 commit ef4bda3

16 files changed

Lines changed: 1761 additions & 1856 deletions

part1_core/document.asciidoc.log.txt

Lines changed: 135 additions & 125 deletions
Original file line numberDiff line numberDiff line change
@@ -2496,81 +2496,48 @@ For example:
24962496

24972497
=== GeoSciML Borehole Requirements Class (Normative)
24982498

2499-
[width="100%",cols="18%,82%",options="header",]
2500-
|===
2501-
|*Requirements Class* |
2502-
|/req/gsml4-borehole |
2503-
|*Target type* |Encoding
2504-
|*Dependency* |/req/gsml4-core
2505-
|*Dependency* |ISO 19103 Conceptual Model Language
2506-
|*Dependency* |ISO 19107 Spatial Schema
2507-
|*Dependency* |ISO-19156 Observations and Measurements (OGC Topic 20)
2508-
|*Dependency* |SWE Common 2.0 08-094r1 Clause 7
2509-
|*Dependency* |ISO 19108 Temporal Schema
2510-
|*Dependency* |ISO 19115-3 Citation
2511-
|*Requirement* a|
2512-
/req/gsml4-borehole/value-intervalBegin
2513-
2514-
The value of intervalBegin SHALL be less or equal to the value of intervalEnd.
2515-
2516-
|*Requirement* a|
2517-
/req/gsml4-borehole/drill-interval-1D
2518-
2519-
Interval SHALL be encoded with GM++_++LineString with two 1D points.
2520-
2521-
|*Requirement* a|
2522-
/req/gsml4-borehole/drill-interval-1D-CRS
2523-
2524-
Coordinate Reference System shall be a reference to the borehole geometry.
2525-
2526-
|*Requirement* a|
2527-
/req/gsml4-borehole/value-mappedIntervalBegin
2528-
2529-
The value of mappedIntervalBegin SHALL be less or equal to the value of mappedIntervalEnd.
2530-
2531-
|*Requirement* a|
2532-
/req/gsml4-borehole/interval-1D
2533-
2534-
Interval SHALL be encoded with GM++_++LineString with two 1D points.
2535-
2536-
|*Requirement* a|
2537-
/req/gsml4-borehole/interval-1D-CRS
2538-
2539-
Coordinate Reference System of interval geometries SHALL use the borehole geometry.
2540-
2541-
|*Requirement* a|
2542-
/req/gsml4-borehole/borehole-position-null
2543-
2544-
If no GM++_++Point is available, an OGC nil value SHALL be used.
2545-
2546-
|*Recommendation* a|
2547-
/req/gsml4-borehole/borehole-3d
2548-
2549-
Implementers delivering 3-D origin locations SHOULD provide an elevation.
2550-
2551-
|*Requirement* a|
2552-
/req/gsml4-borehole/borehole-elevation-dim
2553-
2554-
Origin elevation SHALL be a geometry with a dimension of 1.
2499+
[[req_class_gsml-borehole]]
25552500

2556-
|*Requirement* a|
2557-
/req/gsml4-borehole/borehole-elevation-CRS
2501+
[requirements_class]
2502+
.Requirements Class 'GeoSciML Borehole'
2503+
====
2504+
[%metadata]
2505+
identifier:: link:++http://www.opengis.net/spec/geosciml/5.0/req/gsml-borehole++[]
2506+
subject:: Encoding
2507+
inherit:: /req/gsml-core
2508+
inherit:: ISO 19103 Conceptual Model Language
2509+
inherit:: ISO 19107 Spatial Schema
2510+
inherit:: ISO-19156 Observations and Measurements (OGC Topic 20)
2511+
inherit:: SWE Common 2.0 08-094r1 Clause 7
2512+
inherit:: ISO 19108 Temporal Schema
2513+
inherit:: ISO 19115-3 Citation
2514+
requirement:: /req/gsml-borehole/value-intervalBegin
2515+
requirement:: /req/gsml-borehole/drill-interval-1D
2516+
requirement:: /req/gsml-borehole/drill-interval-1D-CRS
2517+
requirement:: /req/gsml-borehole/value-mappedIntervalBegin
2518+
requirement:: /req/gsml-borehole/interval-1D
2519+
requirement:: /req/gsml-borehole/interval-1D-CRS
2520+
requirement:: /req/gsml-borehole/borehole-3d
2521+
requirement:: /req/gsml-borehole/borehole-elevation-dim
2522+
requirement:: /req/gsml-borehole/borehole-elevation-CRS
2523+
====
25582524

2559-
Origin elevation srsName identifier SHALL be a vertical CRS having a EPSG in the range 5600-5799
25602525

2561-
|===
25622526

25632527
The GeoSciML Borehole package contains an information model for boreholes and related artefacts. This is primarily through re-use of standard components from the Observations and Measurements (ISO19156).
25642528

2565-
image::images/image75.png[Borehole dependency diagram.,width=601,height=559]Figure: 73: Borehole dependency diagram.
2529+
.Borehole dependency diagram
2530+
image::images/image75.png[Borehole dependency diagram.,width=601,height=559]
25662531

2567-
image::images/image76.png[Borehole summary diagram.,width=601,height=498]Figure: 74: Borehole summary diagram.
2532+
.Borehole summary diagram
2533+
image::images/image76.png[Borehole summary diagram.,width=601,height=498]
25682534

25692535
==== Borehole
25702536

25712537
This requirements class describes Borehole and BoreholeInterval and related data types.  This package describes a borehole as a means to sample geologic units underground and thus provide a linear map of the geology.
25722538

2573-
image::images/image77.png[Borehole context diagram.,width=601,height=331]Figure: 75: Borehole context diagram.
2539+
.Borehole context diagram
2540+
image::images/image77.png[Borehole context diagram.,width=601,height=331]
25742541

25752542
===== Borehole
25762543

@@ -2603,7 +2570,8 @@ Borehole inherits sampledFeature from OM::SF++_++SamplingFeature, which links th
26032570

26042571
DrillingDetails is a class that captures the description of drilling methods and hole diameters down the drilling path.  Properties that apply to the Borehole as a whole are managed in BoreholeDetails (8.7.1.4).
26052572

2606-
image::images/image78.png[Drilling details,width=601,height=387]Figure 76: Drilling details
2573+
.Drilling details
2574+
image::images/image78.png[Drilling details,width=601,height=387]
26072575

26082576
====== drillingMethod
26092577

@@ -2617,11 +2585,15 @@ The boreholeDiameter property (SWE::Quantity) contains a measurement (a value an
26172585

26182586
The intervalBegin property (SWE::Quantity) contains a measurement (a value and a unit of measurement) that corresponds to the measured distance of the start of the interval along the path of the borehole. The measured value must be less than or equal to the intervalEnd value.
26192587

2620-
[width="100%",cols="100%",options="header",]
2621-
|===
2622-
|*Requirement /req/gsml4-borehole/value-intervalBegin*
2623-
|The value of intervalBegin SHALL be less or equal to the value of intervalEnd.
2624-
|===
2588+
2589+
[[req_gsml-borehole_value-intervalBegin]]
2590+
2591+
[requirement]
2592+
====
2593+
[%metadata]
2594+
identifier:: /req/gsml-borehole/value-intervalBegin
2595+
part:: The value of intervalBegin SHALL be less or equal to the value of intervalEnd.
2596+
====
26252597

26262598
====== intervalEnd
26272599

@@ -2631,27 +2603,36 @@ The property intervalEnd (SWE::Quantity) contains a measurement (a value and a u
26312603

26322604
The property interval:GM++_++Object is a shape that is a 1-D interval (e.g., a “from” and “to”, or “top” and “base” measurements) that is equivalent (represents the same distance) as the one represented by intervalBegin and intervalEnd.  The geometry shall use a reference to the borehole geometry as its CRS.
26332605

2634-
[width="100%",cols="100%",options="header",]
2635-
|===
2636-
|*Requirement /req/gsml4-borehole/drill-interval-1D*
2637-
|Interval SHALL be encoded with GM++_++LineString with two 1D points.
2638-
|===
26392606

2607+
[[req_gsml-borehole_drill-interval-1D]]
2608+
2609+
[requirement]
2610+
====
2611+
[%metadata]
2612+
identifier:: /req/gsml-borehole/drill-interval-1D
2613+
part:: Interval SHALL be encoded with GM_LineString with two 1D points.
2614+
====
26402615

26412616

2642-
[width="100%",cols="100%",options="header",]
2643-
|===
2644-
|*Requirement /req/gsml4-borehole/drill-interval-1D-CRS*
2645-
|Coordinate Reference System shall be a reference to the borehole geometry.
2646-
|===
2617+
2618+
[[req_gsml-borehole_drill-interval-1D-CRS]]
2619+
2620+
[requirement]
2621+
====
2622+
[%metadata]
2623+
identifier:: /req/gsml-borehole/drill-interval-1D-CRS
2624+
part:: Coordinate Reference System shall be a reference to the borehole geometry.
2625+
====
26472626

26482627
Encoding of the drilled interval using GEO::GM++_++LineString shall consist of two 1D points only (the start and end point of the interval, measured as distance from the borehole collar), with a 1-D CRS referencing the borehole shape.
26492628

26502629
===== BoreholeInterval
26512630

26522631
A BoreholeInterval is similar to a MappedFeature (8.4.1.2) whose shape is 1-D interval and uses the SRS of the containing borehole.  The "mappedIntervalBegin" and "mappedIntervalEnd" properties are alternative to the 1D geometry to overcome problems with the delivery and ease of queryability of 1D GML shapes.
26532632

2654-
image::images/image79.png[Borehole interval context diagram.,width=601,height=439]Figure: 77: Borehole interval context diagram.
2633+
2634+
.Borehole interval context diagram
2635+
image::images/image79.png[Borehole interval context diagram.,width=601,height=439]
26552636

26562637
====== observationMethod
26572638

@@ -2665,11 +2646,15 @@ The specification property is an association between a BoreholeInterval and a GF
26652646

26662647
The property mappedIntervalBegin (SWE::Quantity) is a measurement (a value and a unit of measurement) corresponding to the measured distance of the start of the mapped interval along the path of the borehole. The measured value must be less than or equal to the mappedIntervalEnd value.
26672648

2668-
[width="100%",cols="100%",options="header",]
2669-
|===
2670-
|*Requirement /req/gsml4-borehole/value-mappedIntervalBegin*
2671-
|The value of mappedIntervalBegin SHALL be less than or equal to the value of mappedIntervalEnd.
2672-
|===
2649+
2650+
[[req_gsml-borehole_value-mappedIntervalBegin]]
2651+
2652+
[requirement]
2653+
====
2654+
[%metadata]
2655+
identifier:: /req/gsml-borehole/value-mappedIntervalBegin
2656+
part:: The value of mappedIntervalBegin SHALL be less or equal to the value of mappedIntervalEnd.
2657+
====
26732658

26742659
====== mappedIntervalEnd
26752660

@@ -2689,35 +2674,44 @@ The property shape:GM++_++Object is a 1-D interval (e.g., a “from” and “to
26892674

26902675
Encoding of an interval within the borehole using GEO::GM++_++LineString shall consist of two 1D points only (the start and end point of the interval, measured as distance from the borehole collar), with CRS corresponding to the borehole shape.
26912676

2692-
[width="100%",cols="100%",options="header",]
2693-
|===
2694-
|*Requirement /req/gsml4-borehole/interval-1D*
2695-
|Interval SHALL be encoded with GM++_++LineString with two 1D points.
2696-
|===
26972677

2698-
 
2678+
[[req_gsml-borehole_interval-1D]]
26992679

2700-
[width="100%",cols="100%",options="header",]
2701-
|===
2702-
|*Requirement /req/gsml4-borehole/interval-1D-CRS*
2703-
|Coordinate Reference System of interval geometries SHALL use the borehole geometry.
2704-
|===
2680+
[requirement]
2681+
====
2682+
[%metadata]
2683+
identifier:: /req/gsml-borehole/interval-1D
2684+
part:: Interval SHALL be encoded with GM_LineString with two 1D points.
2685+
====
27052686

2706-
 
2687+
2688+
[[req_gsml-borehole_interval-1D-CRS]]
2689+
2690+
[requirement]
2691+
====
2692+
[%metadata]
2693+
identifier:: /req/gsml-borehole/interval-1D-CRS
2694+
part:: Coordinate Reference System of interval geometries SHALL use the borehole geometry.
2695+
====
27072696

27082697
Instance example for Klčovo and Lastomir Formation adapted from Túnyi ++[++18++]++:
27092698

2710-
image::images/image80.png[Top part of Figure 2 from Túnyi ++[++18++]++,width=426,height=549]Figure: 78: Top part of Figure 2 from Túnyi ++[++18++]++
2699+
[[img_top__part_tunyi]]
2700+
.Top part of Figure 2 from Túnyi ++[++18++]++
2701+
image::images/image80.png[width=426,height=549]
27112702

2712-
Figure 79 shows an encoding of the first lithostratigraphic and magnetostratigraphic units from Figure 78 showing how the collection identifiers group BoreholeIntervals into two groups.
2703+
<<img_encoding_of_a_borehole_with_two_logs>> shows an encoding of the first lithostratigraphic and magnetostratigraphic units from <<img_top__part_tunyi>> showing how the collection identifiers group BoreholeIntervals into two groups.
27132704

2714-
image::images/image81.png[Encoding of a borehole with two distinct logs (collectionIdentifier).,width=601,height=398]Figure: 79: Encoding of a borehole with two distinct logs (collectionIdentifier).
2705+
[[img_encoding_of_a_borehole_with_two_logs]]
2706+
.Encoding of a borehole with two distinct logs (collectionIdentifier).
2707+
image::images/image81.png[width=601,height=398]
27152708

27162709
===== BoreholeDetails
27172710

27182711
BoreholeDetails describes borehole-specific index data, often termed “header information”. It contains metadata about the parties involved in the drilling, the storage of drilled material and other information relevant to the borehole as a whole.  Properties that may vary along the borehole path are managed in DrillingDetails (8.7.1.2).
27192712

2720-
image::images/image82.png[Borehole details context diagram.,width=601,height=570]Figure: 80: Borehole details context diagram.
2713+
.Borehole details context diagram
2714+
image::images/image82.png[Borehole details context diagram.,width=601,height=570]
27212715

27222716
====== operator
27232717

@@ -2759,7 +2753,8 @@ The property boreholeLength (SWE::Quantity) contains a measurement (a value and
27592753

27602754
A borehole OriginPosition is a feature corresponding to the start point of a borehole log.  This may correspond to the borehole collar location (e.g., kelly bush).
27612755

2762-
image::images/image83.png[Origin position context diagram.,width=518,height=456]Figure: 81: Origin position context diagram.
2756+
.Origin position context diagram
2757+
image::images/image83.png[Origin position context diagram.,width=518,height=456]
27632758

27642759
If a text description of the location is available, it should be reported in the description property, inherited from GM:GFI++_++Feature. 
27652760

@@ -2769,47 +2764,62 @@ The property location contains a geometry corresponding to the location of the b
27692764

27702765
If no GEO::GM++_++Point is available, an OGC nil value shall be used.
27712766

2772-
[width="100%",cols="100%",options="header",]
2773-
|===
2774-
|*Requirement /req/gsml4-borehole/borehole-position-null*
2775-
|If no GM++_++Point is available, an OGC nil value SHALL be used.
2776-
|===
2767+
2768+
[[req_gsml-borehole_borehole-position-null]]
2769+
2770+
[requirement]
2771+
====
2772+
[%metadata]
2773+
identifier:: /req/gsml-borehole/borehole-position-null
2774+
part:: If no GM_Point is available, an OGC nil value SHALL be used.
2775+
====
27772776

27782777
In situations where the origin position changes over the life of the borehole (e.g., due to subsidence or destruction of the original collar), the origin position should be updated to the new location.
27792778

27802779
====== elevation
27812780

27822781
Implementers delivering 3-D origin locations should provide an elevation to improve interoperability.
27832782

2784-
[width="100%",cols="100%",options="header",]
2785-
|===
2786-
|*Requirement /req/gsml4-borehole/borehole-3d*
2787-
|Implementers delivering 3-D origin locations SHOULD provide an elevation.
2788-
|===
2783+
2784+
[[req_gsml-borehole_borehole-3d]]
2785+
2786+
[requirement]
2787+
====
2788+
[%metadata]
2789+
identifier:: /req/gsml-borehole/borehole-3d
2790+
part:: Implementers delivering 3-D origin locations SHOULD provide an elevation.
2791+
====
27892792

27902793
The elevation:DirectPosition property is a compromise approach to supply elevation explicitly for location; this is to allow for software that cannot process 3-D GM++_++Point. Null shall be used if elevation is unknown. A DirectPosition shall have a dimension of 1, and CRS will be a “vertical” CRS (e.g. EPSG CRSs in the range 5600-5799).
27912794

2792-
[width="100%",cols="100%",options="header",]
2793-
|===
2794-
|*Requirement /req/gsml4-borehole/borehole-elevation-dim*
2795-
|Origin elevation SHALL be a geometry with a dimension of 1.
2796-
|===
27972795

2798-
 
2796+
[[req_gsml-borehole-borehole-elevation-dim]]
27992797

2800-
[width="100%",cols="100%",options="header",]
2801-
|===
2802-
|*Requirement /req/gsml4-borehole/borehole-elevation-CRS*
2803-
|Origin elevation srsName identifier SHALL be a vertical CRS having an EPSG in the range 5600-5799.
2804-
|===
2798+
[requirement]
2799+
====
2800+
[%metadata]
2801+
identifier:: /req/gsml-borehole/borehole-elevation-dim
2802+
part:: Origin elevation SHALL be a geometry with a dimension of 1.
2803+
====
2804+
2805+
2806+
[[req_gsml-borehole_borehole-elevation-CRS]]
2807+
2808+
[requirement]
2809+
====
2810+
[%metadata]
2811+
identifier:: /req/gsml-borehole/borehole-elevation-CRS
2812+
part:: Origin elevation srsName identifier SHALL be a vertical CRS having a EPSG in the range 5600-5799
2813+
====
28052814

28062815
==== GeoSciML Borehole vocabularies
28072816

2808-
Vocabularies used in Borehole package are listed in Table 7.
2817+
Vocabularies used in Borehole package are listed in <<tbl_geosciml_borehole_vocabularies>>.
28092818

2819+
[[tbl_geosciml_borehole_vocabularies]]
2820+
.GeoSciML Borehole vocabularies
28102821
[width="100%",cols="^32%,^68%",options="header",]
28112822
|===
2812-
|*Table 7: GeoSciML Borehole vocabularies.* |
28132823
|*Vocabulary* |*Description*
28142824
|*BoreholeDrillingMethodCode* |This class is an indicative placeholder only for a vocabulary of terms describing the borehole drilling method.  Users are encouraged to use a vocabulary of terms managed by the CGI vocabularies working group. (e.g., auger, hand auger, air core, cable tool, diamond core, rotary air blast, etc.).
28152825
|*BoreholeInclinationCode* a|

0 commit comments

Comments
 (0)