Skip to content

Commit 4f3ea9d

Browse files
authored
Add to age query documentation with range calculations details
1 parent f3ea700 commit 4f3ea9d

File tree

1 file changed

+50
-0
lines changed

1 file changed

+50
-0
lines changed

sphinx/technical_decisions/extended_age_query.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,23 @@ The Extended Age Query (EAQ) feature enhances query capabilities for **Collectio
1818
- **Highest** `StartPeriod` across relevant nodes
1919
Because MYA increases into the past, higher StartPeriod means older boundary.
2020

21+
- **Strictness in Range Calculations**
22+
- an age query start period `x`
23+
- an age query end period `y`
24+
- with constraint that `x >= y`
25+
- for each collection object, a meta start period `a` is decided, and a meta end period `b` is decided.
26+
- with constraint that `a >= b`
27+
28+
Strict Filter: (full overlap, a-b is within x-y)
29+
`a <= x` and `b >= y`
30+
31+
Non-Strict Filter: (partial age range overlap, any overlap so x-y can be within a-b or a-b can be within x-y)
32+
(` a<= x` and `a >= y`) or (`b <= x` and `b >= y`) or (`a >= x` and `b <= y`)
33+
34+
This is omitting the complication of uncertainty values.
35+
The meta age range for each collection object should appear in the age column of the query results.
36+
The "Any" age query bug is being push to a later issue. For now, do a Age Range query from "13800" to "0" to get all COs with age data (query all of time, the age of the universe
37+
2138
## User Interface & Workflow
2239

2340
1. **Add Age Field**
@@ -43,9 +60,42 @@ EAQ applies to the following age contexts within Collection Objects:
4360

4461
- **Absolute Age**
4562
Computes a range using: AbsoluteAge + AgeUncertainty to AbsoluteAge – AgeUncertainty
63+
4664
- **Paleo Context**
4765
Bound by `ChronosStratID` (and optionally `ChronosStratEndID`). The system determines the widest combined range across both IDs using start/end values.
4866

67+
**Table paths from CollectionObject to Absoluteage or GeologicTimePeriod**
68+
69+
| table_path_1 | table_path_2 | table_path_3 | table_path_4 | table_path_5 |
70+
|------------------|-----------------|---------------|-----------------|-------------------|
71+
| collectionobject | absoluteage | | | |
72+
| collectionobject | relativeage | chronostrat | | |
73+
| collectionobject | paleocontext | chronostrat | | |
74+
| collectionobject | collectionevent | paleocontext | chronostrat | |
75+
| collectionobject | collectionevent | locality | paleocontext | chronostrat |
76+
77+
**Field Paths from CollectionObject to Absoluteage or GeologicTimePeriod**
78+
79+
| field_path_1 | field_path_2 | field_path_3 | field_path_4 | field_path_5 | field_path_6 |
80+
|------------------|-----------------|----------------|----------------|------------------|---------------|
81+
| collectionobject | absoluteage | absoluteage | | | |
82+
| collectionobject | relativeage | agename | startperiod | | |
83+
| collectionobject | relativeage | agename | endperiod | | |
84+
| collectionobject | relativeage | agenameend | startperiod | | |
85+
| collectionobject | relativeage | agenameend | endperiod | | |
86+
| collectionobject | paleocontext | chronosstrat | startperiod | | |
87+
| collectionobject | paleocontext | chronosstrat | endperiod | | |
88+
| collectionobject | paleocontext | chronosstratend| startperiod | | |
89+
| collectionobject | paleocontext | chronosstratend| endperiod | | |
90+
| collectionobject | collectingevent | paleocontext | chronosstrat | startperiod | |
91+
| collectionobject | collectingevent | paleocontext | chronosstrat | endperiod | |
92+
| collectionobject | collectingevent | paleocontext | chronosstratend| startperiod | |
93+
| collectionobject | collectingevent | paleocontext | chronosstratend| endperiod | |
94+
| collectionobject | collectingevent | locality | paleocontext | chronosstrat | startperiod |
95+
| collectionobject | collectingevent | locality | paleocontext | chronosstrat | endperiod |
96+
| collectionobject | collectingevent | locality | paleocontext | chronosstratend | startperiod |
97+
| collectionobject | collectingevent | locality | paleocontext | chronosstratend | endperiod |
98+
4999
These three contexts are searched independently according to their respective logic.
50100

51101
## MVP Scope

0 commit comments

Comments
 (0)