ADR - Add Bin Grid Squaring endpoint to CRS Conversion helper service

Decision Title

New Bin Grid convert endpoint in CRS Convert helper service

Status

• Proposed
• Approved
• Implementing (incl. documenting)
• Testing
• Released

Context & Scope

This ADR is on the recommendation of the OSDU Geomatics Integration workstream to address a gap in platform functionality to check bin grids and "square" them.

The proposed endpoint is described at https://gitlab.opengroup.org/osdu/subcommittees/ea/projects/geomatics/home/-/issues/27

• Bin grid "squareness" checking is a well known process.
• conversion basically is simply calling the CRS convert service. e squaring is This is a
• Shell is willing to donate the algorithm spec, code, and developer

Decision to be made

• Accept the new endpoint to be added to CRS conversion service.
• Define action parties (it is unclear to me if Shell donates/works this - how do we collaborate with CSPs?)

Rationale

• Enable better data management processes on bin grid loading (seismic mainly).
• Enable applications that require data persisted in a new geometry to use the new endpoint.
• Consistent squaring algorithm for all parties, math properly documented.

Consequences

• New endpoint available
• For CSPs to support new endpoint in CRS Service I'd think they won't need to do anything other than deploy latest added code.

When to revisit

• ? (not)

---

Tradeoff Analysis - Input to decision

• See information posted in "Context & Scope".
• The main tradeoff is that if this function is not offered as part of the platform helper services "CRS conversion" (sic) then individual parties need to implement this independently.

Alternatives and implications

• Not having this function requires each other party to implement their own solutions, or no solutions, potentially leading to loading bin grids with 4 corner definitions that are not checked and not "square". This can lead to geodetic integrity failures for seismic volumes.
• This will not resolve/not enable working with bin grids in Web Mercator. The squaring algorithm will lead to large trace mislocation there for large grids. The proper way to store is in the original "square" geometry and work/visualize in a "warped geometry" as needed in another CRS. However, "squaring" is often pragmatic after transformation (very small error if datum changes but map projection is the same) and is needed for QC also in the original geometry.
• In 2019 there was a note written on this by Thomas.

Decision criteria and tradeoffs

• No dependencies (except on CRS convert).

Decision timeline

• Decision ready to be made.