Skip to content

AGS4 and DIGGS mapping

Mapping table 1.2: 25 of 25 groups reviewed

This is mapping table 1.2, used by pydiggs.convert in both directions: ags4_to_diggs, and diggs_to_ags4 and model_to_ags4. A group's status is draft until its rows have been reviewed, and reviewed after. Changing where a heading goes is a new major version of the table; adding groups, headings or codes is a minor one. Corrections from DIGGS and AGS practitioners are welcome: a mapping change is a small diff to the TOML files under src/pydiggs/convert/mappings/.

The converter writes DIGGS 3.0.0. It reads AGS4 4.0.3, 4.0.4, 4.1, 4.1.1, 4.2, and writes AGS4 4.2 (the default) or 4.1.1. As of November 2026 the BGS AGS validator (agsapi.bgs.ac.uk) and python-ags4 1.2.0 accept AGS4 only up to 4.1.1: write ags_version="4.1.1" for files meant for them. No published AGS4 to DIGGS mapping exists, so this table is original work. It holds only AGS4 group and heading names, keys and parent groups; it copies nothing else from the AGS4 data dictionary.

One table drives both directions: DIGGS to AGS4 writes each heading from the DIGGS value it is read into below, and reports every DIGGS value with no heading here as convert.unmapped-element. A heading marked to-diggs is used only from AGS4 to DIGGS, one marked to-ags4 only the other way. pyDIGGS bundles no AGS4 data dictionary, so the TYPE of each heading it writes is the one its values have.

Every non-null value of an AGS4 file is either carried into DIGGS or named by a convert finding (see Findings). A group that is not listed here is reported as convert.unmapped-group; a heading that is listed as not converted, or not listed at all, as convert.unmapped-heading; and anything the file's own DICT group defines as convert.user-defined.

Targets. key: identifies the record; it becomes the gml:id (made a valid XML id) and the gml:name. link: a key of the parent record, used to attach this record to it. field: a value the converter places itself (named in the table). param: a DIGGS element, as Element/child; a measure is written only with a unit DIGGS 3.0.0 allows for it, and is reported otherwise. column: a result column, named by its key in the DIGGS property dictionary. format: AGS4 format information the converter reads; it is not data. not converted: with the reason.

Values are carried as reported. Units are renamed only through the unit table, and nothing is converted numerically.

Depth units. The unit of LOCA_FDEP (m, ft or ftUS; the unit table gives DIGGS m, ft or ft[US]) is the unit of every depth along a feature: it is the unit of each feature's linear referencing system, of the CPT depth column and of an interval that starts at the top of a hole. A file whose LOCA_FDEP has no unit, or one the converter does not carry, is read in metres, as before. A depth heading in a unit other than that of the file is reported as convert.unmapped-unit, naming both units, and not written. No depth is ever converted from one unit to another.

PROJ

pattern project; status reviewed; keys PROJ_ID; DIGGS Project.

AGS4 heading DIGGS target Status
PROJ_ID key gml:name reviewed
PROJ_NAME field name reviewed
PROJ_LOC field locality reviewed
PROJ_CLNT not converted: a client is a business associate, which the converter does not write reviewed
PROJ_CONT not converted: a contractor is a business associate, which the converter does not write reviewed
PROJ_ENG not converted: an engineer is a business associate, which the converter does not write reviewed
PROJ_MEMO field remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

TRAN

pattern transmission; status reviewed; DIGGS DocumentInformation.

AGS4 heading DIGGS target Status
TRAN_ISNO not converted: DocumentInformation has no issue number reviewed
TRAN_DATE field creation_date reviewed
TRAN_PROD not converted: the producer is a business associate, which the converter does not write reviewed
TRAN_STAT not converted: DocumentInformation has no issue status reviewed
TRAN_DESC field description reviewed
TRAN_AGS format: the AGS4 version of the source; it selects how the file is read reviewed
TRAN_RECV not converted: the recipient is a business associate, which the converter does not write reviewed
TRAN_DLIM format: the record link delimiter, an AGS4 format setting reviewed
TRAN_RCON format: the concatenation character, an AGS4 format setting reviewed
TRAN_REM not converted: DocumentInformation has no remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

ABBR

pattern lookup; status reviewed; keys ABBR_HDNG, ABBR_CODE.

AGS4 heading DIGGS target Status
ABBR_HDNG format: abbreviation lists are read by the converter, not converted reviewed
ABBR_CODE format: abbreviation lists are read by the converter, not converted reviewed
ABBR_DESC format: abbreviation lists are read by the converter, not converted reviewed
ABBR_LIST format: abbreviation lists are read by the converter, not converted reviewed
ABBR_REM format: abbreviation lists are read by the converter, not converted reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

UNIT

pattern lookup; status reviewed; keys UNIT_UNIT.

AGS4 heading DIGGS target Status
UNIT_UNIT format: units are mapped through units.toml, not converted reviewed
UNIT_DESC format: units are mapped through units.toml, not converted reviewed
UNIT_REM format: units are mapped through units.toml, not converted reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

TYPE

pattern lookup; status reviewed; keys TYPE_TYPE.

AGS4 heading DIGGS target Status
TYPE_TYPE format: data types are AGS4 format information reviewed
TYPE_DESC format: data types are AGS4 format information reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

DICT

pattern lookup; status reviewed; keys DICT_TYPE, DICT_GRP, DICT_HDNG.

AGS4 heading DIGGS target Status
DICT_TYPE format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
DICT_GRP format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
DICT_HDNG format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
DICT_STAT format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
DICT_DTYP format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
DICT_DESC format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
DICT_UNIT format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
DICT_EXMP format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
DICT_PGRP format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
DICT_REM format: the file's dictionary; user-defined groups and headings are reported, never interpreted reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

LOCA

pattern feature; status reviewed; keys LOCA_ID.

AGS4 heading DIGGS target Status
LOCA_ID key gml:name reviewed
LOCA_TYPE field element reviewed
LOCA_STAT not converted: no DIGGS 3.0.0 target reviewed
LOCA_NATE field location.x reviewed
LOCA_NATN field location.y reviewed
LOCA_GREF field location.crs reviewed
LOCA_GL field location.z reviewed
LOCA_REM field remark reviewed
LOCA_FDEP field total_depth reviewed
LOCA_STAR field when_constructed.start reviewed
LOCA_PURP not converted: boreholePurpose is a code list; AGS4 gives free text reviewed
LOCA_TERM not converted: no DIGGS 3.0.0 target for the reason a hole was ended reviewed
LOCA_ENDD field when_constructed.end reviewed
LOCA_LETT not converted: no DIGGS 3.0.0 target reviewed
LOCA_LOCX not converted: local site coordinates need a local CRS, not converted reviewed
LOCA_LOCY not converted: local site coordinates need a local CRS, not converted reviewed
LOCA_LOCZ not converted: local site coordinates need a local CRS, not converted reviewed
LOCA_LREF not converted: local site coordinates need a local CRS, not converted reviewed
LOCA_DATM not converted: a separate vertical datum is not converted reviewed
LOCA_ETRV not converted: traverse end coordinates are not converted reviewed
LOCA_NTRV not converted: traverse end coordinates are not converted reviewed
LOCA_LTRV not converted: traverse end coordinates are not converted reviewed
LOCA_XTRL not converted: traverse end coordinates are not converted reviewed
LOCA_YTRL not converted: traverse end coordinates are not converted reviewed
LOCA_ZTRL not converted: traverse end coordinates are not converted reviewed
LOCA_LAT field location.lat reviewed
LOCA_LON field location.lon reviewed
LOCA_ELAT not converted: traverse end coordinates are not converted reviewed
LOCA_ELON not converted: traverse end coordinates are not converted reviewed
LOCA_LLZ field location.datum reviewed
LOCA_LOCM not converted: no DIGGS 3.0.0 target for how a location was found reviewed
LOCA_LOCA not converted: a grouping of locations by site sub-division (a tag, often a code in ABBR), not a description of the location reviewed
LOCA_CLST not converted: a grouping of locations, typically by investigation phase; DIGGS 3.0.0 has no target for it reviewed
LOCA_ALID not converted: alignments are not converted reviewed
LOCA_OFFS not converted: alignments are not converted reviewed
LOCA_CNGE not converted: alignments are not converted reviewed
LOCA_TRAN not converted: no DIGGS 3.0.0 target reviewed
LOCA_NATD field location.vertical_datum reviewed
LOCA_ORID not converted: no DIGGS 3.0.0 target reviewed
LOCA_ORJO not converted: no DIGGS 3.0.0 target reviewed
LOCA_ORCO not converted: no DIGGS 3.0.0 target reviewed
LOCA_GLDT not converted: DIGGS 3.0.0 has no date for a ground level reviewed
LOCA_VSSL not converted: a survey vessel has no DIGGS 3.0.0 target reviewed
LOCA_NSRI field location.crs reviewed
LOCA_LSRI not converted: local site coordinates need a local CRS, which the converter does not write reviewed
LOCA_LLSI field location.datum reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

GEOL

pattern interval-observation; status reviewed; keys LOCA_ID, GEOL_TOP, GEOL_BASE; parent LOCA; DIGGS LithologySystem.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
GEOL_TOP field interval.top reviewed
GEOL_BASE field interval.base reviewed
GEOL_DESC param Lithology/lithDescription reviewed
GEOL_LEG param Lithology/legendCode reviewed
GEOL_GEOL not converted: a project geology code; its meaning is in the file's ABBR group, not a unit name reviewed
GEOL_GEO2 not converted: a second geology code has no DIGGS 3.0.0 target reviewed
GEOL_STAT not converted: no DIGGS 3.0.0 target reviewed
GEOL_BGS not converted: a BGS Lexicon code needs a DIGGS code list, not converted reviewed
GEOL_FORM field geologic_unit reviewed
GEOL_BNDF not converted: the base boundary definition is not in the mapping (DIGGS baseBoundary is a candidate for a later table) reviewed
GEOL_REM field remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

SAMP

pattern sample; status reviewed; keys LOCA_ID, SAMP_TOP, SAMP_REF, SAMP_TYPE, SAMP_ID; parent LOCA; DIGGS Sample.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
SAMP_TOP field interval.top reviewed
SAMP_REF param Sample/internalIdentifier reviewed
SAMP_TYPE param Sample/type reviewed
SAMP_ID key gml:name reviewed
SAMP_BASE field interval.base reviewed
SAMP_DTIM field date reviewed
SAMP_UBLO not converted: no DIGGS 3.0.0 target reviewed
SAMP_CONT not converted: no DIGGS 3.0.0 target reviewed
SAMP_PREP not converted: no DIGGS 3.0.0 target reviewed
SAMP_SDIA not converted: no DIGGS 3.0.0 target reviewed
SAMP_WDEP not converted: no DIGGS 3.0.0 target reviewed
SAMP_RECV param SamplingActivity/totalSampleRecovery (Dimensionless measure) reviewed
SAMP_TECH not converted: no DIGGS 3.0.0 target reviewed
SAMP_MATX not converted: sampleMatrix is a code list; not converted reviewed
SAMP_TYPC not converted: no DIGGS 3.0.0 target reviewed
SAMP_WHO not converted: a person is a business associate, which the converter does not write reviewed
SAMP_WHY not converted: no DIGGS 3.0.0 target reviewed
SAMP_REM field remark reviewed
SAMP_DESC field description reviewed
SAMP_DESD not converted: no DIGGS 3.0.0 target reviewed
SAMP_LOG not converted: a person is a business associate, which the converter does not write reviewed
SAMP_COND not converted: no DIGGS 3.0.0 target reviewed
SAMP_CLSS not converted: no DIGGS 3.0.0 target reviewed
SAMP_BAR not converted: no DIGGS 3.0.0 target reviewed
SAMP_TEMP not converted: no DIGGS 3.0.0 target reviewed
SAMP_PRES not converted: no DIGGS 3.0.0 target reviewed
SAMP_FLOW not converted: no DIGGS 3.0.0 target reviewed
SAMP_ETIM not converted: no DIGGS 3.0.0 target reviewed
SAMP_DURN not converted: no DIGGS 3.0.0 target reviewed
SAMP_CAPT not converted: no DIGGS 3.0.0 target reviewed
SAMP_LINK not converted: record links are not converted reviewed
SAMP_RECL not converted: no DIGGS 3.0.0 target reviewed
GEOL_STAT not converted: no DIGGS 3.0.0 target reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

ISPT

pattern test-per-row; status reviewed; keys LOCA_ID, ISPT_TOP; parent LOCA; DIGGS Test; procedure DrivenPenetrationTest; penetrationTestType = SPT.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
ISPT_TOP field location reviewed
ISPT_SEAT not converted: seating drive blows are not converted reviewed
ISPT_MAIN not converted: main drive blows are not converted (the N value is) reviewed
ISPT_NPEN param DrivenPenetrationTest/totalPenetration (Length measure) reviewed
ISPT_NVAL column n_value reviewed
ISPT_N60 column n60 reviewed
ISPT_REP not converted: the reported result text has no DIGGS property reviewed
ISPT_CAS param DrivenPenetrationTest/depthCasing (Length measure) reviewed
ISPT_WAT param DrivenPenetrationTest/waterDepth (Length measure) reviewed
ISPT_TYPE not converted: no DIGGS 3.0.0 target reviewed
ISPT_HAM not converted: hammer identifiers are not converted reviewed
ISPT_ERAT param DrivenPenetrationTest/hammerEfficiency (Dimensionless measure) reviewed
ISPT_INC1 not converted: drive sets are not converted reviewed
ISPT_INC2 not converted: drive sets are not converted reviewed
ISPT_INC3 not converted: drive sets are not converted reviewed
ISPT_INC4 not converted: drive sets are not converted reviewed
ISPT_INC5 not converted: drive sets are not converted reviewed
ISPT_INC6 not converted: drive sets are not converted reviewed
ISPT_PEN1 not converted: drive sets are not converted reviewed
ISPT_PEN2 not converted: drive sets are not converted reviewed
ISPT_PEN3 not converted: drive sets are not converted reviewed
ISPT_PEN4 not converted: drive sets are not converted reviewed
ISPT_PEN5 not converted: drive sets are not converted reviewed
ISPT_PEN6 not converted: drive sets are not converted reviewed
ISPT_ROCK not converted: no DIGGS 3.0.0 target reviewed
ISPT_SWP param DrivenPenetrationTest/selfWeightPenetration (Length measure) reviewed
ISPT_REM field remark reviewed
ISPT_ENV not converted: no DIGGS 3.0.0 target reviewed
ISPT_METH not converted: test method text is not converted reviewed
ISPT_CRED not converted: no DIGGS 3.0.0 target reviewed
TEST_STAT not converted: no DIGGS 3.0.0 target reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

LLPL

pattern test-per-row; status reviewed; keys LOCA_ID, SAMP_TOP, SAMP_REF, SAMP_TYPE, SAMP_ID, SPEC_REF, SPEC_DPTH; parent SAMP; DIGGS Test; procedure AtterbergLimitsTest.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
SAMP_TOP link sampleRef reviewed
SAMP_REF link sampleRef reviewed
SAMP_TYPE link sampleRef reviewed
SAMP_ID link sampleRef reviewed
SPEC_REF field name reviewed
SPEC_DPTH field location reviewed
SPEC_DESC field description reviewed
SPEC_PREP not converted: specimen preparation text is not converted reviewed
LLPL_LL column liquid_limit reviewed
LLPL_PL column plastic_limit reviewed
LLPL_PI column plasticity_index reviewed
LLPL_425 not converted: the percentage passing 425 um has no DIGGS property (DIGGS has percent retained on No. 40) reviewed
LLPL_PREP not converted: specimen preparation text is not converted reviewed
LLPL_METH not converted: test method text is not converted reviewed
LLPL_LAB not converted: a laboratory is a business associate, which the converter does not write reviewed
LLPL_CRED not converted: no DIGGS 3.0.0 target reviewed
LLPL_TYPE not converted: the test method (fall cone or Casagrande) is not in the mapping; DIGGS fallConeTrial and casagrandeTrial are candidates for a later table reviewed
LLPL_POIN not converted: the number of points of a test is not in the mapping reviewed
LLPL_CONE not converted: the type of fall cone is not in the mapping reviewed
LLPL_1PRE not converted: one-point test readings are not in the mapping reviewed
LLPL_1PCF not converted: one-point test readings are not in the mapping reviewed
LLPL_SIZE not converted: the sieve size is not in the mapping (values are never converted to DIGGS percentRetainedNo40) reviewed
LLPL_PASS not converted: the percentage passing the sieve is not in the mapping (values are never converted to DIGGS percentRetainedNo40) reviewed
LLPL_WC not converted: a water content before particles were removed has no DIGGS 3.0.0 property reviewed
LLPL_STAB not converted: stabiliser details have no DIGGS 3.0.0 target reviewed
LLPL_STYP not converted: stabiliser details have no DIGGS 3.0.0 target reviewed
LLPL_REM field remark reviewed
LLPL_DEV not converted: deviations from the method are not converted reviewed
TEST_STAT not converted: no DIGGS 3.0.0 target reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

LNMC

pattern test-per-row; status reviewed; keys LOCA_ID, SAMP_TOP, SAMP_REF, SAMP_TYPE, SAMP_ID, SPEC_REF, SPEC_DPTH; parent SAMP; DIGGS Test; procedure WaterContentTest.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
SAMP_TOP link sampleRef reviewed
SAMP_REF link sampleRef reviewed
SAMP_TYPE link sampleRef reviewed
SAMP_ID link sampleRef reviewed
SPEC_REF field name reviewed
SPEC_DPTH field location reviewed
SPEC_DESC field description reviewed
SPEC_PREP not converted: specimen preparation text is not converted reviewed
LNMC_MC column water_content_natural reviewed
LNMC_TEMP param WaterContentTest/dryingTemperature (ThermodynamicTemperature measure) reviewed
LNMC_STAB not converted: no DIGGS 3.0.0 target reviewed
LNMC_ISNT not converted: read to decide whether LNMC_MC is a natural water content (DIGGS water_content_natural is written only when it is not N); the flag itself is not written reviewed
LNMC_COMM not converted: no DIGGS 3.0.0 target reviewed
LNMC_METH not converted: test method text is not converted reviewed
LNMC_LAB not converted: a laboratory is a business associate, which the converter does not write reviewed
LNMC_CRED not converted: no DIGGS 3.0.0 target reviewed
LNMC_STYP not converted: stabiliser details have no DIGGS 3.0.0 target reviewed
LNMC_REM field remark reviewed
LNMC_DEV not converted: deviations from the method are not converted reviewed
TEST_STAT not converted: no DIGGS 3.0.0 target reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

GRAG

pattern test-table; status reviewed; keys LOCA_ID, SAMP_TOP, SAMP_REF, SAMP_TYPE, SAMP_ID, SPEC_REF, SPEC_DPTH; parent SAMP; DIGGS Test; procedure ParticleSizeTest; data group GRAT.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
SAMP_TOP link sampleRef reviewed
SAMP_REF link sampleRef reviewed
SAMP_TYPE link sampleRef reviewed
SAMP_ID link sampleRef reviewed
SPEC_REF field name reviewed
SPEC_DPTH field location reviewed
SPEC_DESC field description reviewed
SPEC_PREP not converted: specimen preparation text is not converted reviewed
GRAG_UC column coef_uniformity reviewed
GRAG_VCRE not converted: AGS4 fractions use ISO 14688-1 size limits (63 mm, 2 mm, 63 um); the DIGGS 3.0.0 properties use ASTM limits (75 mm, 4.75 mm, 0.075 mm), so the fraction is not converted either way reviewed
GRAG_GRAV not converted: AGS4 fractions use ISO 14688-1 size limits (63 mm, 2 mm, 63 um); the DIGGS 3.0.0 properties use ASTM limits (75 mm, 4.75 mm, 0.075 mm), so the fraction is not converted either way reviewed
GRAG_SAND not converted: AGS4 fractions use ISO 14688-1 size limits (63 mm, 2 mm, 63 um); the DIGGS 3.0.0 properties use ASTM limits (75 mm, 4.75 mm, 0.075 mm), so the fraction is not converted either way reviewed
GRAG_SILT not converted: AGS4 fractions use ISO 14688-1 size limits (63 mm, 2 mm, 63 um); the DIGGS 3.0.0 properties use ASTM limits (75 mm, 4.75 mm, 0.075 mm), so the fraction is not converted either way reviewed
GRAG_CLAY column clay_percent_2_micron reviewed
GRAG_CC column coef_curvature reviewed
GRAG_FINE not converted: AGS4 fractions use ISO 14688-1 size limits (63 mm, 2 mm, 63 um); the DIGGS 3.0.0 properties use ASTM limits (75 mm, 4.75 mm, 0.075 mm), so the fraction is not converted either way reviewed
GRAG_METH not converted: test method text is not converted reviewed
GRAG_LAB not converted: a laboratory is a business associate, which the converter does not write reviewed
GRAG_CRED not converted: no DIGGS 3.0.0 target reviewed
GRAG_PRET not converted: the pre-treatment method is not in the mapping reviewed
GRAG_SUFF not converted: whether the specimen mass was sufficient has no DIGGS 3.0.0 target reviewed
GRAG_EXCL not converted: how excluded material was measured has no DIGGS 3.0.0 target reviewed
GRAG_PDEN not converted: the particle density used is not in the mapping reviewed
GRAG_REM field remark reviewed
GRAG_DEV not converted: deviations from the method are not converted reviewed
TEST_STAT not converted: no DIGGS 3.0.0 target reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

GRAT

pattern test-table; status reviewed; keys LOCA_ID, SAMP_TOP, SAMP_REF, SAMP_TYPE, SAMP_ID, SPEC_REF, SPEC_DPTH, GRAT_SIZE; parent GRAG; DIGGS Grading.

AGS4 heading DIGGS target Status
LOCA_ID link Test reviewed
SAMP_TOP link Test reviewed
SAMP_REF link Test reviewed
SAMP_TYPE link Test reviewed
SAMP_ID link Test reviewed
SPEC_REF link Test reviewed
SPEC_DPTH link Test reviewed
GRAT_SIZE param Grading/particleSize (ParticleSize measure) reviewed
GRAT_PERP param Grading/percentPassing (MassPerMass measure) reviewed
GRAT_TYPE field method reviewed
GRAT_REM field remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

HORN

pattern feature-component; status reviewed; keys LOCA_ID, HORN_TOP, HORN_BASE; parent LOCA.

AGS4 heading DIGGS target Status
LOCA_ID not converted: hole orientation is not converted: AGS4 measures inclination positively down from horizontal, DIGGS 3.0.0 plunge positively up, and values are never converted reviewed
HORN_TOP not converted: hole orientation is not converted: AGS4 measures inclination positively down from horizontal, DIGGS 3.0.0 plunge positively up, and values are never converted reviewed
HORN_BASE not converted: hole orientation is not converted: AGS4 measures inclination positively down from horizontal, DIGGS 3.0.0 plunge positively up, and values are never converted reviewed
HORN_ORNT not converted: hole orientation is not converted: DIGGS 3.0.0 gives one bearing per feature, AGS4 one per section reviewed
HORN_INCL not converted: hole orientation is not converted: AGS4 measures inclination positively down from horizontal, DIGGS 3.0.0 plunge positively up, and values are never converted reviewed
HORN_REM not converted: hole orientation is not converted reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

HDIA

pattern feature-component; status reviewed; keys LOCA_ID, HDIA_DPTH; parent LOCA; DIGGS BoreholeDiameter; held by the feature's holeDiameter; each section starts at the base of the one above (the first at 0).

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
HDIA_DPTH field interval.base reviewed
HDIA_DIAM param BoreholeDiameter/diameter (Length measure) reviewed
HDIA_REM field remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

CDIA

pattern feature-component; status reviewed; keys LOCA_ID, CDIA_DPTH; parent LOCA; DIGGS Casing; held by the feature's casing; each runs from the surface (0) to its depth.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
CDIA_DPTH field interval.base reviewed
CDIA_DIAM not converted: AGS4 gives a casing diameter without saying inside or outside; DIGGS 3.0.0 has casingOutsideDiameter and casingInsideDiameter, and the converter does not choose reviewed
CDIA_REM field remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

BKFL

pattern feature-component; status reviewed; keys LOCA_ID, BKFL_TOP; parent LOCA; DIGGS BackfillLayer; held by the feature's backfill; inside a Backfill.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
BKFL_TOP field interval.top reviewed
BKFL_BASE field interval.base reviewed
BKFL_DESC param BackfillLayer/backfillMaterial reviewed
BKFL_LEG not converted: a backfill legend code has no DIGGS 3.0.0 target reviewed
BKFL_DATE not converted: AGS4 gives the date the backfill was completed; DIGGS 3.0.0 gives the interval a layer was placed in reviewed
BKFL_REM field remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

WSTG

pattern feature-component; status reviewed; keys LOCA_ID, WSTG_DPTH; parent LOCA; DIGGS WaterStrike; data group WSTD; held by the feature's waterStrike.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
WSTG_DPTH field strike.location reviewed
WSTG_DTIM field strike.dateTime reviewed
WSTG_SEAL field location reviewed
WSTG_CAS field bottomCasing reviewed
WSTG_REM field remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

WSTD

pattern feature-component; status reviewed; keys LOCA_ID, WSTG_DPTH, WSTD_NMIN; parent WSTG; DIGGS LinkedWSReading; held by the feature's linkedReading.

AGS4 heading DIGGS target Status
LOCA_ID link WaterStrike reviewed
WSTG_DPTH link WaterStrike reviewed
WSTD_NMIN param LinkedWSReading/elapsedTime (Time measure) reviewed
WSTD_POST field location reviewed
WSTD_REM field remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

LDEN

pattern test-per-row; status reviewed; keys LOCA_ID, SAMP_TOP, SAMP_REF, SAMP_TYPE, SAMP_ID, SPEC_REF, SPEC_DPTH; parent SAMP; DIGGS Test; procedure LabDensityTest.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
SAMP_TOP link sampleRef reviewed
SAMP_REF link sampleRef reviewed
SAMP_TYPE link sampleRef reviewed
SAMP_ID link sampleRef reviewed
SPEC_REF field name reviewed
SPEC_DPTH field location reviewed
SPEC_DESC field description reviewed
SPEC_PREP not converted: specimen preparation text is not in the mapping reviewed
SPEC_BASE not converted: the base of a specimen has no target on a test located at a point reviewed
LDEN_TYPE not converted: the kind of density test is an AGS4 abbreviation with no DIGGS code reviewed
LDEN_COND not converted: read to leave out LDEN_BDEN and LDEN_MC of a recompacted specimen (DIGGS bulk_density and water_content_natural are natural conditions); the condition itself has no DIGGS code reviewed
LDEN_SMTY not converted: the sample type is an AGS4 abbreviation with no DIGGS code reviewed
LDEN_MC column water_content_natural reviewed
LDEN_BDEN column bulk_density reviewed
LDEN_DDEN column dry_density reviewed
LDEN_METH not converted: test method text is not in the mapping reviewed
LDEN_LAB not converted: a laboratory is a business associate, which the converter does not write reviewed
LDEN_CRED not converted: no DIGGS 3.0.0 target for an accreditation reviewed
LDEN_REM field remark reviewed
LDEN_DEV not converted: deviations from the method are not in the mapping reviewed
TEST_STAT not converted: no DIGGS 3.0.0 target for a test status reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

SCPG

pattern test-table; status reviewed; keys LOCA_ID, SCPG_TESN; parent LOCA; DIGGS Test; procedure StaticConePenetrationTest; data group SCPT; written for AGS4 4.0.3, 4.0.4, 4.1, 4.1.1.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
SCPG_TESN field name reviewed
SCPG_TYPE not converted: read to leave out ball and T-bar tests (their resistance is not a cone resistance); the penetrometer type itself is not written reviewed
SCPG_REF not converted: cone test details are not in the mapping reviewed
SCPG_CSA not converted: cone test details are not in the mapping reviewed
SCPG_RATE not converted: cone test details are not in the mapping reviewed
SCPG_FILT not converted: cone test details are not in the mapping reviewed
SCPG_FRIC not converted: cone test details are not in the mapping reviewed
SCPG_WAT not converted: cone test details are not in the mapping reviewed
SCPG_WATA not converted: cone test details are not in the mapping reviewed
SCPG_ENV not converted: cone test details are not in the mapping reviewed
SCPG_CONT not converted: cone test details are not in the mapping reviewed
SCPG_METH not converted: cone test details are not in the mapping reviewed
SCPG_CRED not converted: cone test details are not in the mapping reviewed
SCPG_CAR not converted: cone test details are not in the mapping reviewed
SCPG_SLAR not converted: cone test details are not in the mapping reviewed
SCPG_OPER not converted: cone test details are not in the mapping reviewed
SCPG_REM field remark reviewed
TEST_STAT not converted: no DIGGS 3.0.0 target for a test status reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

SCPT

pattern test-table; status reviewed; keys LOCA_ID, SCPG_TESN, SCPT_DPTH; parent SCPG; DIGGS Test.

AGS4 heading DIGGS target Status
LOCA_ID link Test reviewed
SCPG_TESN link Test reviewed
SCPT_DPTH field index.position reviewed
SCPT_RES column tip_resistance reviewed
SCPT_FRES column sleeve_friction reviewed
SCPT_PWP1 column pore_pressure_u1 reviewed
SCPT_PWP2 column pore_pressure_u2 reviewed
SCPT_PWP3 column pore_pressure_u3 reviewed
SCPT_QT column tip_resistance_corrected reviewed
SCPT_CON not converted: DIGGS has conductivity, but uS/cm has no entry in the unit table reviewed
SCPT_TEMP column temperature reviewed
SCPT_PH not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
SCPT_SLP1 not converted: a slope indicator reading; DIGGS inclination_x and inclination_y are per axis, and the converter does not choose reviewed
SCPT_SLP2 not converted: a slope indicator reading; DIGGS inclination_x and inclination_y are per axis, and the converter does not choose reviewed
SCPT_REDX not converted: DIGGS has redox_potential, but mV has no entry in the unit table reviewed
SCPT_MAGT not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
SCPT_MAGX not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
SCPT_MAGY not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
SCPT_MAGZ not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
SCPT_SMP column soil_moisture_content reviewed
SCPT_NGAM not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
SCPT_FRR column friction_ratio reviewed
SCPT_FT not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
SCPT_QE not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
SCPT_BDEN not converted: an assumed bulk density used in the derived values; no DIGGS property for this reading reviewed
SCPT_CPO not converted: an in situ stress used in the derived values; no DIGGS property for this reading reviewed
SCPT_CPOD not converted: an in situ stress used in the derived values; no DIGGS property for this reading reviewed
SCPT_ISPP not converted: an in situ pore pressure used in the derived values; no DIGGS property for this reading reviewed
SCPT_QNET not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
SCPT_FRRC not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
SCPT_EXPP not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
SCPT_BQ not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
SCPT_NQT not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
SCPT_NFR not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
SCPT_REM field remark reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

CPTG

pattern test-table; status reviewed; keys LOCA_ID, CPTG_TESN; parent LOCA; DIGGS Test; procedure StaticConePenetrationTest; data group CPTT; written for AGS4 4.2.

AGS4 heading DIGGS target Status
LOCA_ID link samplingFeatureRef reviewed
CPTG_TESN field name reviewed
CPTG_TYPE not converted: read to leave out ball and T-bar tests (their resistance is not a cone resistance); the penetrometer type itself is not written reviewed
CPTG_APCL not converted: cone test details are not in the mapping reviewed
CPTG_CAR not converted: cone test details are not in the mapping reviewed
CPTG_CDDT not converted: cone test details are not in the mapping reviewed
CPTG_CFOA not converted: cone test details are not in the mapping reviewed
CPTG_CFOS not converted: cone test details are not in the mapping reviewed
CPTG_CORR not converted: cone test details are not in the mapping reviewed
CPTG_CPC not converted: cone test details are not in the mapping reviewed
CPTG_CPCL not converted: cone test details are not in the mapping reviewed
CPTG_CRDT not converted: cone test details are not in the mapping reviewed
CPTG_CSA not converted: cone test details are not in the mapping reviewed
CPTG_CSAN not converted: cone test details are not in the mapping reviewed
CPTG_DATE not converted: cone test details are not in the mapping reviewed
CPTG_DAZV not converted: cone test details are not in the mapping reviewed
CPTG_EQPT not converted: cone test details are not in the mapping reviewed
CPTG_FILL not converted: cone test details are not in the mapping reviewed
CPTG_FILT not converted: cone test details are not in the mapping reviewed
CPTG_FPC not converted: cone test details are not in the mapping reviewed
CPTG_FRIC not converted: cone test details are not in the mapping reviewed
CPTG_FRID not converted: cone test details are not in the mapping reviewed
CPTG_FRIS not converted: cone test details are not in the mapping reviewed
CPTG_LCA not converted: cone test details are not in the mapping reviewed
CPTG_MAN not converted: cone test details are not in the mapping reviewed
CPTG_ORNT not converted: cone test details are not in the mapping reviewed
CPTG_PED not converted: cone test details are not in the mapping reviewed
CPTG_RATE not converted: cone test details are not in the mapping reviewed
CPTG_REF not converted: cone test details are not in the mapping reviewed
CPTG_RLOC not converted: cone test details are not in the mapping reviewed
CPTG_SAT not converted: cone test details are not in the mapping reviewed
CPTG_SHA not converted: cone test details are not in the mapping reviewed
CPTG_SLA not converted: cone test details are not in the mapping reviewed
CPTG_SLAN not converted: cone test details are not in the mapping reviewed
CPTG_SLAR not converted: cone test details are not in the mapping reviewed
CPTG_TBD not converted: cone test details are not in the mapping reviewed
CPTG_TBL not converted: cone test details are not in the mapping reviewed
CPTG_TERM not converted: cone test details are not in the mapping reviewed
CPTG_UPC not converted: cone test details are not in the mapping reviewed
CPTG_WAT not converted: cone test details are not in the mapping reviewed
CPTG_WATA not converted: cone test details are not in the mapping reviewed
CPTG_OPER not converted: cone test details are not in the mapping reviewed
CPTG_CRED not converted: cone test details are not in the mapping reviewed
CPTG_METH not converted: cone test details are not in the mapping reviewed
CPTG_ENV not converted: cone test details are not in the mapping reviewed
CPTG_CONT not converted: cone test details are not in the mapping reviewed
CPTG_ANBY not converted: cone test details are not in the mapping reviewed
CPTG_DEV not converted: deviations from the method are not in the mapping reviewed
CPTG_REM field remark reviewed
TEST_STAT not converted: no DIGGS 3.0.0 target for a test status reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

CPTT

pattern test-table; status reviewed; keys LOCA_ID, CPTG_TESN, CPTT_REDN; parent CPTG; DIGGS Test.

AGS4 heading DIGGS target Status
LOCA_ID link Test reviewed
CPTG_TESN link Test reviewed
CPTT_REDN not converted: a reading number is not held: the readings are ordered by depth (DIGGS to AGS4 numbers them 1, 2, 3 ...) reviewed
CPTT_DPTH field index.position reviewed
CPTT_QC column tip_resistance reviewed
CPTT_FS column sleeve_friction reviewed
CPTT_U1 column pore_pressure_u1 reviewed
CPTT_U2 column pore_pressure_u2 reviewed
CPTT_U3 column pore_pressure_u3 reviewed
CPTT_QT column tip_resistance_corrected reviewed
CPTT_PLEN not converted: the penetration length; the readings are indexed by depth (the PLEN index is a candidate for a later table) reviewed
CPTT_INCX column inclination_x reviewed
CPTT_INCY column inclination_y reviewed
CPTT_TIME not converted: a clock time; the converter writes result columns as numbers reviewed
CPTT_DUR column elapsed_time reviewed
CPTT_TF not converted: the total thrust has no DIGGS 3.0.0 property reviewed
CPTT_RF column friction_ratio reviewed
CPTT_BDEN not converted: an assumed bulk density used in the derived values; no DIGGS property for this reading reviewed
CPTT_CPO not converted: an in situ stress used in the derived values; no DIGGS property for this reading reviewed
CPTT_ISPP not converted: an in situ pore pressure used in the derived values; no DIGGS property for this reading reviewed
CPTT_CPOD not converted: an in situ stress used in the derived values; no DIGGS property for this reading reviewed
CPTT_FT not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
CPTT_QNET not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
CPTT_QE not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
CPTT_RFT not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
CPTT_EXPP not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
CPTT_BQ not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
CPTT_NQT not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
CPTT_NFR not converted: a value derived from the readings; the bundled DIGGS 3.0.0 property dictionary has no property for it reviewed
CPTT_MAGX not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_MAGY not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_MAGZ not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_MAGT not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_MAGG not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_CON not converted: DIGGS has conductivity, but uS/cm has no entry in the unit table reviewed
CPTT_TEMP column temperature reviewed
CPTT_TPQC not converted: a sensor temperature; DIGGS temperature is the soil temperature (CPTT_TEMP) reviewed
CPTT_TPFS not converted: a sensor temperature; DIGGS temperature is the soil temperature (CPTT_TEMP) reviewed
CPTT_TPU not converted: a sensor temperature; DIGGS temperature is the soil temperature (CPTT_TEMP) reviewed
CPTT_PH not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_REDX not converted: DIGGS has redox_potential, but mV has no entry in the unit table reviewed
CPTT_SMP column soil_moisture_content reviewed
CPTT_NGAM not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_FFD1 not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_FFD2 not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_PID not converted: the bundled DIGGS 3.0.0 property dictionary has no property for this reading reviewed
CPTT_FID not converted: DIGGS has flame_ionization_measurement, but uV has no entry in the unit table reviewed
CPTT_REM not converted: a reading remark has no place in a DIGGS result table reviewed
FILE_FSET not converted: files named in the FILE group are never opened or converted reviewed

Units

An AGS4 unit with no row here is reported as convert.unmapped-unit.

AGS4 unit DIGGS unit
m m
mm mm
cm cm
km km
um um
ft ft
ftUS ft[US]
in in
% %
kPa kPa
MPa MPa
kN/m2 kN/m2
bar bar
kN kN
N N
kN/m3 kN/m3
Mg/m3 Mg/m3
g/cm3 g/cm3
kg kg
g g
deg dega
DegC degC
degC degC
s s
min min
h h
m/s m/s
mg/kg mg/kg
ppm ppm
l L
ml mL

Codes

An AGS4 code with no row here, or with no DIGGS code, is reported as convert.unmapped-code. Codes are matched as AGS4 says abbreviations are, not case sensitive, and a value joined by the file's TRAN_RCON (+ by default) matches the row that joins the same codes in either order. Where two AGS4 codes share one DIGGS code, DIGGS to AGS4 writes the first; a value matching a later row is written as the DIGGS code and the AGS4 code is reported.

AGS4 heading AGS4 code DIGGS element DIGGS code
LOCA_TYPE CP Borehole CP (boreholeType)
LOCA_TYPE RC Borehole RC (boreholeType)
LOCA_TYPE CP+RC Borehole CP-RC (boreholeType)
LOCA_TYPE HA Borehole HA (boreholeType)
LOCA_TYPE RO Borehole
LOCA_TYPE WS Borehole
LOCA_TYPE WLS Borehole
LOCA_TYPE TP TrialPit the element itself
LOCA_TYPE CPT Sounding
LOCA_TYPE SCP Sounding
LOCA_TYPE DP Sounding
LOCA_TYPE SNC Borehole SNC (boreholeType)
LOCA_TYPE VE Borehole VE (boreholeType)
LOCA_TYPE VC Borehole VC (boreholeType)
LOCA_TYPE AUGH Borehole HSA (boreholeType)
LOCA_TYPE AUGS Borehole SSA (boreholeType)
LOCA_TYPE TT TrialPit
SAMP_TYPE U open_tube (sampleType)
SAMP_TYPE UT thin_walled_tube (sampleType)
SAMP_TYPE P piston (sampleType)
SAMP_TYPE D small_disturbed (sampleType)
SAMP_TYPE B bulk (sampleType)
SAMP_TYPE LB large_bulk (sampleType)
SAMP_TYPE BLK block (sampleType)
SAMP_TYPE C rotary_core (sampleType)
SAMP_TYPE W water_sample (sampleType)
SAMP_TYPE G gas_sample (sampleType)
SAMP_TYPE L windowless (sampleType)
SAMP_TYPE SPTLS split_barrel_liner (sampleType)
SAMP_TYPE M triple_tube_soil (sampleType)
SAMP_TYPE TW thin_walled_tube (sampleType)
SAMP_TYPE EW water_sample (sampleType)
GRAT_TYPE WS Grading
GRAT_TYPE DS Grading
GRAT_TYPE HY Sedimentation the element itself

Coordinate reference systems

LOCA_GREF names the CRS of LOCA_NATE and LOCA_NATN; EPSG:<number> is read as that EPSG code, and an AGS4 4.2 LOCA_NSRI (an EPSG code) is read before LOCA_GREF, which is reported when it disagrees. LOCA_LLZ names the datum of LOCA_LAT and LOCA_LON, and a 4.2 LOCA_LLSI is read before it. Any other value is reported, and nothing is guessed from the coordinates. Grid coordinates and ground levels are written only in the unit of the CRS's axes. A ground level is written as the third coordinate: in the compound CRS a LOCA_NATD row gives with its horizontal CRS, and otherwise in the grid CRS, which does not state the level's vertical datum (reported as convert.assumed). Values are matched not case sensitively. DIGGS to AGS4 writes the first row of each CRS, and for AGS4 4.2 also LOCA_NSRI or LOCA_LLSI.

AGS4 heading AGS4 value DIGGS srsName Axis unit With horizontal CRS
LOCA_GREF OSGB http://www.opengis.net/def/crs/EPSG/0/27700 m
LOCA_GREF OSGB36 http://www.opengis.net/def/crs/EPSG/0/27700 m
LOCA_GREF British National Grid http://www.opengis.net/def/crs/EPSG/0/27700 m
LOCA_GREF ITM http://www.opengis.net/def/crs/EPSG/0/2157 m
LOCA_GREF Irish Grid http://www.opengis.net/def/crs/EPSG/0/29903 m
LOCA_GREF OSI http://www.opengis.net/def/crs/EPSG/0/29903 m
LOCA_NATD OD Newlyn http://www.opengis.net/def/crs/EPSG/0/7405 m http://www.opengis.net/def/crs/EPSG/0/27700
LOCA_NATD ODN http://www.opengis.net/def/crs/EPSG/0/7405 m http://www.opengis.net/def/crs/EPSG/0/27700
LOCA_NATD Ordnance Datum Newlyn http://www.opengis.net/def/crs/EPSG/0/7405 m http://www.opengis.net/def/crs/EPSG/0/27700
LOCA_LLZ WGS84 http://www.opengis.net/def/crs/EPSG/0/4326
LOCA_LLZ WGS 84 http://www.opengis.net/def/crs/EPSG/0/4326
LOCA_LLZ ETRS89 http://www.opengis.net/def/crs/EPSG/0/4258