|
NGen
|
Reads a hydrofabric v2.2 GeoPackage. More...
#include <GeoPackageHydrofabricReader.hpp>
Inheritance diagram for ngen::hydrofabric::V2_2GeoPackageHydrofabricReader:
Collaboration diagram for ngen::hydrofabric::V2_2GeoPackageHydrofabricReader:Public Member Functions | |
| V2_2GeoPackageHydrofabricReader (geopackage::GeoPackageReader divides_reader, std::optional< geopackage::GeoPackageReader > nexus_reader) | |
| geojson::GeoJSON | read_divides (const std::vector< std::string > &ids={}) override |
| Read the hydrofabric's divides. | |
| geojson::GeoJSON | read_nexus (const std::vector< std::string > &ids={}) override |
| Read the hydrofabric's nexuses. | |
Protected Member Functions | |
| void | normalize_divides (geojson::FeatureCollection ÷s) const override |
| Bring a freshly read divides collection into ngen's canonical vocabulary, in place. | |
| void | normalize_nexus (geojson::FeatureCollection &nexus) const override |
| Bring a freshly read nexus collection into ngen's canonical vocabulary, in place. | |
| const geopackage::GeoPackageReader & | reader_for (const std::string &layer) const |
The reader for the file holding layer. | |
| HydrofabricVersion | version () const noexcept |
| The detected schema version, for the version-keyed schema utilities. | |
| virtual void | check_required_columns (const std::string &layer) const |
Verify up front that layer carries the columns this version needs. | |
Private Attributes | |
| geopackage::GeoPackageReader | divides_reader_ |
| std::optional< geopackage::GeoPackageReader > | nexus_reader_ |
| const HydrofabricVersion | version_ |
Reads a hydrofabric v2.2 GeoPackage.
v2.2 is the schema ngen's property names were taken from, so nothing needs translating; the only version-specific behavior is resolving the divides id column, which ngen::get_layer_id_column() already handles.
| ngen::hydrofabric::V2_2GeoPackageHydrofabricReader::V2_2GeoPackageHydrofabricReader | ( | geopackage::GeoPackageReader | divides_reader, |
| std::optional< geopackage::GeoPackageReader > | nexus_reader ) |
| [in] | divides_reader | Reader for the GeoPackage holding the divides layer |
| [in] | nexus_reader | Reader for the nexus layer's GeoPackage, if a separate file |
|
protectedvirtualinherited |
Verify up front that layer carries the columns this version needs.
Checking before the read means a file missing a required column is reported as the schema problem it is, rather than as a failure to find a column mid-row. The default checks nothing.
| [in] | layer | Hydrofabric layer about to be read |
| std::runtime_error | if a required column is absent |
Reimplemented in ngen::hydrofabric::AbstractV4GeoPackageHydrofabricReader, ngen::hydrofabric::V4_0Beta1GeoPackageHydrofabricReader, and ngen::hydrofabric::V4_0GeoPackageHydrofabricReader.
Referenced by ngen::hydrofabric::GeoPackageHydrofabricReader::read_divides(), and ngen::hydrofabric::GeoPackageHydrofabricReader::read_nexus().
|
overrideprotectedvirtual |
Bring a freshly read divides collection into ngen's canonical vocabulary, in place.
The generic read stores each column under the file's own name for it, but for simplicity, ngen's consumers key on specific names: "id" and "toid". A version that names them differently aliases its columns onto those names here, leaving the originals in place. Implementations also validate the rows they translate and summarize outcomes worth a warning.
| [in,out] | divides | Divides collection to update in place |
| std::runtime_error | if a row cannot be translated |
Implements ngen::hydrofabric::GeoPackageHydrofabricReader.
|
overrideprotectedvirtual |
Bring a freshly read nexus collection into ngen's canonical vocabulary, in place.
The generic read stores each column under the file's own name for it, but for simplicity, ngen's consumers key on specific names: "id" and "toid". A version that names them differently aliases its columns onto those names here, leaving the originals in place. Implementations also validate the rows they translate and summarize outcomes worth a warning.
| [in,out] | nexus | Nexus collection to update in place |
| std::runtime_error | if a row cannot be translated |
Implements ngen::hydrofabric::GeoPackageHydrofabricReader.
|
overridevirtualinherited |
Read the hydrofabric's divides.
| [in] | ids | Optional subset of divide IDs to capture; if empty, all divides are read. IDs that the hydrofabric does not contain are silently ignored, so the result is the intersection of the hydrofabric and ids. |
| std::runtime_error | if the divides cannot be read |
Implements ngen::hydrofabric::HydrofabricReader.
Reimplemented in ngen::hydrofabric::V4_0Beta1GeoPackageHydrofabricReader.
References ngen::hydrofabric::GeoPackageHydrofabricReader::check_required_columns(), ngen::geopackage::GeoPackageReader::db(), ngen::hydrofabric::DIVIDES_LAYER, ngen::hydrofabric::get_layer_id_column(), ngen::hydrofabric::GeoPackageHydrofabricReader::normalize_divides(), ngen::geopackage::GeoPackageReader::read(), ngen::hydrofabric::GeoPackageHydrofabricReader::reader_for(), and ngen::hydrofabric::GeoPackageHydrofabricReader::version_.
Referenced by ngen::hydrofabric::V4_0Beta1GeoPackageHydrofabricReader::read_divides().
|
overridevirtualinherited |
Read the hydrofabric's nexuses.
| [in] | ids | Optional subset of nexus IDs to capture; if empty, all nexuses are read. IDs that the hydrofabric does not contain are silently ignored. |
| std::runtime_error | if the nexuses cannot be read |
Implements ngen::hydrofabric::HydrofabricReader.
References ngen::hydrofabric::GeoPackageHydrofabricReader::check_required_columns(), ngen::geopackage::GeoPackageReader::db(), ngen::hydrofabric::get_layer_id_column(), ngen::hydrofabric::NEXUS_LAYER, ngen::hydrofabric::GeoPackageHydrofabricReader::normalize_nexus(), ngen::geopackage::GeoPackageReader::read(), ngen::hydrofabric::GeoPackageHydrofabricReader::reader_for(), and ngen::hydrofabric::GeoPackageHydrofabricReader::version_.
|
protectedinherited |
The reader for the file holding layer.
The two hydrofabric roles are the whole domain: "nexus" resolves to the second file when there is one and otherwise to the single shared file, and "divides" always resolves to the file it was constructed from. Any other name is refused rather than guessed at – in a split hydrofabric there is no honest answer for which file holds a layer this class does not know, and a guess would surface later as a missing-table error naming the wrong file.
| [in] | layer | Hydrofabric layer name, "divides" or "nexus" |
| std::logic_error | if layer is neither "divides" nor "nexus" |
References ngen::hydrofabric::DIVIDES_LAYER, ngen::hydrofabric::GeoPackageHydrofabricReader::divides_reader_, ngen::hydrofabric::NEXUS_LAYER, and ngen::hydrofabric::GeoPackageHydrofabricReader::nexus_reader_.
Referenced by ngen::hydrofabric::AbstractV4GeoPackageHydrofabricReader::check_required_columns(), ngen::hydrofabric::V4_0Beta1GeoPackageHydrofabricReader::check_required_columns(), ngen::hydrofabric::V4_0GeoPackageHydrofabricReader::check_required_columns(), ngen::hydrofabric::GeoPackageHydrofabricReader::read_divides(), ngen::hydrofabric::V4_0Beta1GeoPackageHydrofabricReader::read_divides(), and ngen::hydrofabric::GeoPackageHydrofabricReader::read_nexus().
|
protectednoexceptinherited |
The detected schema version, for the version-keyed schema utilities.
References ngen::hydrofabric::GeoPackageHydrofabricReader::version_.
Referenced by ngen::hydrofabric::AbstractV4GeoPackageHydrofabricReader::check_required_columns(), ngen::hydrofabric::V4_0Beta1GeoPackageHydrofabricReader::check_required_columns(), ngen::hydrofabric::V4_0GeoPackageHydrofabricReader::check_required_columns(), ngen::hydrofabric::AbstractV4GeoPackageHydrofabricReader::normalize_divides(), ngen::hydrofabric::AbstractV4GeoPackageHydrofabricReader::normalize_nexus(), and ngen::hydrofabric::V4_0Beta1GeoPackageHydrofabricReader::read_divides().
|
privateinherited |
Referenced by ngen::hydrofabric::GeoPackageHydrofabricReader::reader_for().
|
privateinherited |
Referenced by ngen::hydrofabric::GeoPackageHydrofabricReader::reader_for().
|
privateinherited |