Skip to Main Content U.S. Department of Energy
EARTH at PNNL

Frames 1x

Soil Concentration File (.SCF)

There are currently four qualified types of the SCF, those qualifiers are: "Soil", "Soil-Dissolved" "Sediment", "Sediment-Dissolved". When the qualifiers "Soil" or "Sediment" are used, "-Total" is implied. The constituent concentrations are a spatial average throughout the volume of the soil/sediment zone. The concentrations units in the zone depend on whether the constituent is a radionuclide or chemical and which qualifiers is used and constituent phase measured. These concentration values are the instantaneous values at that specified time, not an average. Every data set denotes another location, in most cases a downstream icon, but not always so. There are NO limits on number of data sets, constituents, progeny, and time/concentration pairs.

The following outline is a description of the basic information provided in an SCF. This file may be modified through an API. See the Software Development Kit (SDK) for more information. An example SCF is included after the outline. Comparing the line-by-line description in the outline to the example should clarify and help locate data contained in the SCF. Lines beginning with ';' are descriptive comments only and will not appear in the actual SCF.



For each 'Module' producing an SCF section
  A line with:
    Module Name - [STRING]
    Number of Lines in section - [INTEGER]
  End Line
  A line with:
    Number of Header Lines - [INTEGER]
  End Line
  For each 'Header Line'
    A line with:
      Header information - [STRING]
    End Line
  Next 'Header Line'
  A line with:
    Number of Data Sets - [INTEGER]
  End Line
  For each 'Data Set'
    A line with:
      Data Set name - [STRING]
        ;This is the location name or ID.
        ;If the set is intended for a particular consumming module's use then
        ;  'Data Set Name' = Consuming Module ID
        ;ElseIf the set is intended for any and all consuming modules then
        ;  'Data Set Name' = "All" or user may be module defined
        ;  'Number of Data Sets' = 1
        ;EndIf
      Valid SCF Qualifier for this data set - [STRING]
        ;"Soil" / "Soil-Dissolved" / "Sediment / "Sediment-Dissolved"
      x Dimension of volume - [FLOAT]
      x Dimension unit - [Const STRING] - "m"
      y Dimension of volume - [FLOAT]
      y Dimension unit - [Const STRING] - "m"
      z Dimension of volume - [FLOAT]
      z Dimension unit - [Const STRING] - "m"
      Number of Constituents - [INTEGER]
      Centroid Easting - [FLOAT]
      Easting unit - [Const STRING] - "m"
      Centroid Northing - [FLOAT]
      Northing unit - [Const STRING] - "m"
      Centroid Depth below ground level - [FLOAT]
      Depth unit - [Const STRING] - "m"
    End Line
    For each 'Constituent'
      A line with:
        Constituent Name - [STRING]
        Constituent ID - [STRING]
        Time unit - [Const STRING] - "yr"
        Concentration unit - [Const STRING]
          ;File qualifier determines concentration units and aids in connection scheme:
            ;Soil - "pCi/kg" / "mg/kg" - Total constituent mass per dry weight of soil
            ;Soil-Dissolved - "pCi/L" / "mg/L" - Dissolved constituent mass per volume of soil water
            ;Sediment - "pCi/kg" / "mg/kg" - Total constituent mass per dry weight of sediment
            ;Sediment-Dissolved - "pCi/L" / mg/L - Dissolved mass in water per volume of water
        Number of Time Concentration Pairs - [INTEGER]
        Number of progeny - [const INTEGER] - 0
        ;  must be set to zero for 1.6+ specifications
      End Line
      For each 'Time Concentration Pair'
        A line with:
          Time - [FLOAT]
          Constituent Concentration - [FLOAT]
        End Line
      Next 'Time Concentration Pair'
    Next 'Constituent'
  Next 'Data Set'
Next 'Module'

This SCF Example was created using the case_01 test case. For testing information visit the Frames Wiki Wiki Testing page.

Go to Specifications | Go to Top

EARTH

APPLICATION

DESIGN

SOFTWARE &
DEVELOPMENT TOOLS

TRAINING

Related EARTH Links