ANZSoilML
1.0.0

Package ANZSoilML.ANZSoilML_Soil

Author:
Version:1.0.1
Notes:The ANZSoilML_Soil Package contains classes representing notional soil units, soil profiles and soil layers whose complete and precise extent is inferred to exist. Explicit spatial properties are available through association with a SpatialEntity via the AbstractSoil generalization.

Soils includes both formal units (i.e. formally adopted and named in the official lexicon) and informal units (i.e. named but not promoted to the lexicon) and unnamed units (i.e. recognisable and described and delineable in the field but not otherwise formalised).

Class Summary

NameNotes
<<FeatureType>>AbstractSoilName: AbstractSoil

Definition:
AbstractSoil is an abstract soil domain feature that provides a link between the SoilFeatures and the Landscape features, via landscapeContext, the spatial distribution of the SoilFeatures via the occurrence property, and the metadata properties.
<<CodeList>>ArtificialFragmentTermTerms to describe the size of the artificial fragment
<<CodeList>>BoundaryShapeTermTerms to describe the shape of boundaries
ASLS Field Handbook p200
<<CodeList>>BoundaryTypeTermTerms to describe the distinctness of the boundary
<<DataType>>ColourThe soil colour as measured on a freshly broken aggregate of (usually) moist soil.
the colour scheme used (eg Munsell, RGB triplet), its value (eg 10YR4/2, 0,0,100), and whether the soil is moist or not.
<<CodeList>>ColourValueTerm
<<DataType>>ConsistenceConsistence refers to the strength of cohesion and adhesion in soil. Strength will vary according to soil water status.
<<CodeList>>ContrastTermTerms to describe the distinctness of the contrast between mottles (p160) or distinctness of cutans (p183).
ASLS Field Handbook p160
<<DataType>>CutansA cutan is a modification of the texture, structure or fabric at natural surfaces in soil materials; it arises from concentration of particular soil constituents or in situ modification of the plasma. Cutans comprise any of the component substances of the soil material.
<<CodeList>>CutanTypeTerm
<<CodeList>>DescriptionPurposeCodes used for the specification of the intended purpose/level of abstraction for a given feature or object instance, ie the reason for the existence of the SoilFeature.
Values: instance, typicalNorm, definingNorm.
<<CodeList>>DrainageTermTerms that summarise the local soil wetness conditions
ASLS Field Handbook p202
<<CodeList>>EffervescenceTermA term to describe the effervescence of carbonate in fine earth
ASLS Field Handbook p198
<<DataType>>Field_pHThe soil pH determined in the field.
<<CodeList>>FragmentDistributionTermTerms to describe the distribution of coarse fragments in the soil profile.
ASLS Field Handbook p170
<<CodeList>>GeneticTypeTermTerms to describe the genetic type of the substrate masses (ASLS Field Handbook p217)
<<FeatureType>>JointA placeholder to handle substrate discontinuities.
To be replaced by GeoSciML 'Joint' feature class.
<<CodeList>>LandformPositionTermThe vertical position of the site within the height of the landform element.
ASLS Field Handbook p27
<<CodeList>>MagnetismTermTerm to describe broad magnetic characteristics.
ASLS Field Handbook p198
<<CodeList>>MassStrengthTermTerms to describe broad strength classes
ASLS Field Handbook p211
<<DataType>>MicroReliefThe relief (up to a few metres) about the plane of the land surface. It includes gilfai, hummocky, biotic and other microrelief.
ASLS Field Handbook p129
<<CodeList>>MicroReliefComponentTermComponents that make up the microrelief.
ASLS Field Handbook p129ff includes these in the microrelief type classification (except biotic).
As such a full dictionary should possibly include these other terms (eg terracettes, sinkhole, trench)
<<CodeList>>MicroReliefProportionTermTerms to describe the relative proportions of each of the components
ASLS Field Handbook p130
<<CodeList>>MicroReliefTypeTermA term to describe the microrelief.
To come from a controlled vocabulary
<<CodeList>>MoistureStatusTermMoisture status of soil.
<<DataType>>MottleMottles are spots, blotches or streaks of subdominant colours different from the matrix colour and different from the ped surface colour.
<<CodeList>>MottleTypeTermTerms to describe the types of mottles from ASLS Field Handbook p160
<<CodeList>>PanCementationTermTerms to describe the degree of pan cementation after water soaking.
ASLS Field Handbook p192
<<CodeList>>PanContinuityTermTerms to describe continuity of a pan.
<<CodeList>>PanStructureTermTerms to describe the structure of the pan.
<<CodeList>>PanTypeTermThe type of pan.
ASLS Field Handbook p192
<<CodeList>>ParentConfidenceTermterms to describe the confidence that the observable substrate material is the parent material of the observed soil profile or a major part of that profile (i.e. of the B horizon).
ASLS Field Handbook p206
<<CodeList>>PedGradeTermTerms to describe the degree of development and distinctness of peds.
<<FeatureType>>PedsPeds is a specialization of SoilMaterial to allow describing individual natural soil aggregates consisting of a cluster of primary particles (peds). Peds are separated from adjoining peds by surfaces of weakness that are recognizable as natural voids or by the occurrence of cutans (ASLS Field Handbook p 171).

Properties different from those of SoilMaterials include the ped type (platy, prismatic, columnar, angular blocky), and the grade (degree of development and distinctness of peds, e.g. single grain, massive, weak, moderate, strong).

Inherited property particleGeometry:particleType is used to specify that the particle is an artificial fragment of type 'clod' or 'fragment' and its ConstituentPart:role is ped.
ConstituentPart:relatedMaterial is used to identify parting between peds.
<<CodeList>>PedTypeTermTerms to describe the type of Ped
<<CodeList>>PlasticityDegreeTermTerms to describe the ability to change and retain the shape after the stress is removed.
The degree of plasticity applies only to normal plasticity (see plasticityType)
ASLS Field Handbook p188
<<CodeList>>PlasticityTypeTermTerms to describe the type of plasticity
ASLS Field Handbook p188
<<CodeList>>PropertyTermValueTermPropertyTermValueTerm
<<DataType>>QuantitativeMeasureA generic class to capture simple observation data without dealing with complete O&M.
<<CodeList>>QuantitativeObservationMethodTerm
<<CodeList>>RootAbundanceTermThe number of roots per 0.01 m2 (100 mm x 100 mm).
The abundance term will depend on the size of the roots, whether very fine and ASLS Field Handbook p199
<<DataType>>RootsThe presence and description of plant roots within soil layers (p199)
<<CodeList>>SegregationFormTermForm of the segregations.
ASLS Field Handbook p196
<<DataType>>Segregationsdiscrete segregations that have accumulated in the soil because of the concentration of some constituent, usually by chemical or biological action (ASLS Field Handbook p195)
<<CodeList>>SegregationTypeTermTerms to describe the nature of the segregations ASLS Field Handbook p196
<<FeatureType>>SoilSoil is a natural body consisting of layers (soil horizons or layers) of primarily mineral constituents of variable thicknesses, which differ from the parent materials in their texture, structure, consistence, colour, chemical, biological and other physical characteristics
(after wikipedia).
<<DataType>>SoilClassification
<<CodeList>>SoilClassificationTermA term from an appropriate soil classification (In Australia the 'Australian Soil Classification").
<<CodeList>>SoilDisturbanceTerm
<<FeatureType>>SoilFeatureThe abstract SoilFeature class represents a conceptual feature that is hypothesized to exist coherently in the world.
* this corresponds with a "Soil Unit", comprising a set of similar soil profiles with a mappable distribution in some "Soil Landscape", a Soil Profile or its constituent parts;

The implemented SoilFeature instance acts as the "description package"

* the description package is classified according to its purpose as an Instance, TypicalNorm, or DefiningNorm.
<<FeatureType>>SoilHorizonA SoilHorizon is a layer of soil, approximately parallel to the land surface, with mostly homogenous morphological properties different from layers below and/or above it. (p148)
Distinguished from SoilLayers in that it is developed in a parent material layer through pedogenic processes or made up of in-situ sedimented organic residues of up-growing plants (peat) (INSPIRE), and therefore can be classified with a horizon notation.
<<FeatureType>>SoilLayerDocumentation from INSPIRE:
-- Name --
Soil layer

-- Definition --
domain of a soil with a certain vertical extension developed through non-pedogenic processes, displaying an unconformity to possibly over- or underlying adjacent domains.

-- Description --
NOTE1 Different kinds of layer concepts are covered by this definition.

EXAMPLE 1 Geogenic layers: These are domains, resulting from e.g. sedimentation (as non-pedogenic) processes, that display an unconformity to possibly over- or underlying adjacent domains.

EXAMPLE 2 Topsoil and Subsoil: These can be domains that group different soil horizon types (e.g. A vs. B horizons), or a special case of fixed depths with only two depth ranges (e.g. 0-15 cm: topsoil and, 15-75 cm: subsoil).

EXAMPLE 3 Depth intervals: They are often used in soil monitoring, sampling of contaminated sites and in modelling and include: (i) depth increments (also called fixed depths) that are often used for sampling, e.g. 0-30cm, 30-60cm, and so on, (ii) a single depth range in which a soil sample (”specimen”) is taken and for which the analytical result is valid, and (iii) soil slicing, that is, profile segmentation according to a specified vector, for instance, either regularly spaced intervals (1cm), or a user-defined vector of segment boundaries (i.e. 0-10, 10-25, 25-50, 50-100). Slicing is used in modelling to generate continuous depth functions for soil properties.

EXAMPLE 4: In the framework of soils deeply modified by human activity, artificial layers may be due to different kinds of deposits (concrete, bricks, …).
SOURCE WD ISO28258

For OzSoilML a Soil Horizon is considered a further specialization of a SoilLayer
<<type>>SoilMaterialThe physical properties and appearance of the soil
<<CodeList>>SoilObservationMethodTermSoilObservationMethodTerm is aterm from a vocabulary indicating how the soil feature was determined.
(eg: soil pit, existing vertical exposure, undisturbed soil core, auger boring, outcrop)
<<DataType>>SoilPanA pan is an indurated and/or cemented soil horizon (ASLS Field Handbook p192).
However, treated as property of SoilLayer in OzSoilML as NatSoil doesn't record depth of Pan, often doesn't assign Horizon identifiers.
<<FeatureType>>SoilProfile-- Name --
soil profile

-- Definition --
description of the soil that is characterized by a vertical succession of profile elements.

-- Description --
NOTE The soil profile is abstracted from observations in a trial pit or a boring, or derived from expert knowledge using other soil profiles.
<<FeatureType>>SoilProfileElementThe elements that make up the Soil Profile
SoilRelationshipThe SoilRelationship class is used to define relationships between soilfeatures, ie. SoilProfile-SoilProfile, Soil-Soil relationships.

Relationships are always binary and directional. There is always a single source and a single target. The relationship is always defined from the perspective of the Source and is generally an active verb.

Example: a Source may point to a Soil forming a component of a soil complex. In this case, the Target would point to the appropriate Soil representing the complex and the relationship attribute would be 'soil complex component'. Other appropriate relationship attributes might include: catena component, buried soil

Two or more SoilFeatures are associated in aSoilRelationship; each has a role in the relationship. Examples of soil roles include "component part", "complex soil", "overlies", "underlies", "catena part", and so forth.
<<CodeList>>SoilRelationshipTermTerm to describe the relationship between two Soil Features.
SoilSubstrateRelationshipDescribes the relationship between the Substrate and the Soil
<<FeatureType>>SoilSurfaceThe Soil as it appears at the surface.
This can be considered as analogous to a Soil Layer with a depth of 0.
<<CodeList>>SoilSurfaceConditionTermTerms to describe the condition of the soil surface when dry
ASLS Field Handbook p189
<<FeatureType>>SoilThematicObject-- Name --
soil thematic object

-- Definition --
spatial object representing a soil related property derived from one or more soil properties.

-- Description --
NOTE Soil thematic maps can be derived directly from the involved soil database (organic matter content, pH, texture, etc.) or they can be derived by using Pedotransfer Functions (water availability…).
<<CodeList>>SoilThematicPropertyTerm-- Name --
SoilThematicPropertyTerm

-- Definition --
Terms from a vocabulary that are appropriate to describe the soil related property that the soil thematic results relate to within the soil thematic object.

The SoilThematicPropertyTerms shall be a phenomenon associated with soil features.
<<CodeList>>StickinessTermASLS Field Handbook p187
<<CodeList>>StrengthTermStregth of segregations
ASLS Field Handbook p197
<<FeatureType>>SubstrateMaterial and mass of the earth or rock that do not show pedological development. They are not soils but typically underlie them. The substrate includes the R horizon and that part of the C horizon that shows no pedological development. The substrate beneath the soil may or may not be the parent material of the soil.
The Substrate is clearly related to the GeoSciML GeologicUnit. However, as the observations typically made on the substrate by soil scientists are different to those made by geologists, it is considered a separate class here. Future harmonization between domains should resolve these differences.
<<CodeList>>TextureQualificationTermTerms to qualify the non-clay field texture grades.
These terms should probably be combined with the Texture grade classification, as per the clay textures.
ASLS Field Handbook p166
<<type>>VoidVoid is a general term for pore space and other openings in soils not occupied by solid mineral matter
<<CodeList>>WaterRepellenceTermTerms to describe the water repellence properties of the soil.
ASLS Field Handbook (p191)

Tagged Value

TagValueNotes
classMaphttps://svnserv.csiro.au/svn/TernSoils/ANZSoilML/1.0.0/ANZSoilML_Soil/xmi/ClassMap_ANZSoilML_Soil_v1.xml
gmlProfileSchema
ownerCSIRO Land and Water
schemaLocationhttps://svnserv.csiro.au/svn/TernSoils/ANZSoilML/1.0.0/ANZSoilML_Soil/xsd
targetNamespacehttp://xmlns.anzsoil.org/ANZSoilML-Soil/1.0Default: FIXME
Description: Target XML namespace of the application schema
version1.0.0
xmlnsanzsmls
xsdDocumentanzsoilml-soil.xsd
xsdEncodingRuleiso19136_2007

UML Diagram: CodeLists: Soil

UML Diagram: Conceptual: SoilMaterial

UML Diagram: Summary: Soil

UML Diagram: Summary: SoilMaterial

UML Diagram: Context Diagram : AbstractSoil

UML Diagram: Context Diagram : ArtificialFragmentTerm

UML Diagram: Context Diagram : BoundaryShapeTerm

UML Diagram: Context Diagram : BoundaryTypeTerm

UML Diagram: Context Diagram : Colour

UML Diagram: Context Diagram : ColourValueTerm

UML Diagram: Context Diagram : Consistence

UML Diagram: Context Diagram : ContrastTerm

UML Diagram: Context Diagram : Cutans

UML Diagram: Context Diagram : CutanTypeTerm

UML Diagram: Context Diagram : DescriptionPurpose

UML Diagram: Context Diagram : DrainageTerm

UML Diagram: Context Diagram : EffervescenceTerm

UML Diagram: Context Diagram : Field_pH

UML Diagram: Context Diagram : FragmentDistributionTerm

UML Diagram: Context Diagram : GeneticTypeTerm

UML Diagram: Context Diagram : Joint

UML Diagram: Context Diagram : LandformPositionTerm

UML Diagram: Context Diagram : MagnetismTerm

UML Diagram: Context Diagram : MassStrengthTerm

UML Diagram: Context Diagram : MicroRelief

UML Diagram: Context Diagram : MicroReliefComponentTerm

UML Diagram: Context Diagram : MicroReliefProportionTerm

UML Diagram: Context Diagram : MicroReliefTypeTerm

UML Diagram: Context Diagram : MoistureStatusTerm

UML Diagram: Context Diagram : Mottle

UML Diagram: Context Diagram : MottleTypeTerm

UML Diagram: Context Diagram : PanCementationTerm

UML Diagram: Context Diagram : PanContinuityTerm

UML Diagram: Context Diagram : PanStructureTerm

UML Diagram: Context Diagram : PanTypeTerm

UML Diagram: Context Diagram : ParentConfidenceTerm

UML Diagram: Context Diagram : PedGradeTerm

UML Diagram: Context Diagram : Peds

UML Diagram: Context Diagram : PedTypeTerm

UML Diagram: Context Diagram : PlasticityDegreeTerm

UML Diagram: Context Diagram : PlasticityTypeTerm

UML Diagram: Context Diagram : PropertyTermValueTerm

UML Diagram: Context Diagram : QuantitativeMeasure

UML Diagram: Context Diagram : QuantitativeObservationMethodTerm

UML Diagram: Context Diagram : RootAbundanceTerm

UML Diagram: Context Diagram : Roots

UML Diagram: Context Diagram : SegregationFormTerm

UML Diagram: Context Diagram : Segregations

UML Diagram: Context Diagram : SegregationTypeTerm

UML Diagram: Context Diagram : Soil

UML Diagram: Context Diagram : SoilClassification

UML Diagram: Context Diagram : SoilClassificationTerm

UML Diagram: Context Diagram : SoilDisturbanceTerm

UML Diagram: Context Diagram : SoilFeature

UML Diagram: Context Diagram : SoilHorizon

UML Diagram: Context Diagram : SoilLayer

UML Diagram: Context Diagram : SoilMaterial

UML Diagram: Context Diagram : SoilObservationMethodTerm

UML Diagram: Context Diagram : SoilPan

UML Diagram: Context Diagram : SoilProfile

UML Diagram: Context Diagram : SoilProfileElement

UML Diagram: Context Diagram : SoilRelationship

UML Diagram: Context Diagram : SoilRelationshipTerm

UML Diagram: Context Diagram : SoilSubstrateRelationship

UML Diagram: Context Diagram : SoilSurface

UML Diagram: Context Diagram : SoilSurfaceConditionTerm

UML Diagram: Context Diagram : SoilThematicObject

UML Diagram: Context Diagram : SoilThematicPropertyTerm

UML Diagram: Context Diagram : StickinessTerm

UML Diagram: Context Diagram : StrengthTerm

UML Diagram: Context Diagram : Substrate

UML Diagram: Context Diagram : TextureQualificationTerm

UML Diagram: Context Diagram : Void

UML Diagram: Context Diagram : WaterRepellenceTerm

UML Diagram: Package dependencies