DIMEXML for Test Method

CTM 204-June 2010: Method of Test for Liquid Limit, Plastic Limit and Plasticity Index of Soils


The Office of Structural Material (OSM) of Caltrans has defined an XML schema for each of the material types for the purpose of storing and sharing material test data. An XML schema defines a type of XML format. An XML file is accepted by a system if and only if the XML file can be validated against the schema defined by or supported by the system. For a more descriptive explanation, please visit Wiki: XML Schema. In order to use the batch upload feature to submit data to DIME, the test data has to be written in XML format that can be validated against one of the DIMEXML schemas. These files are referred to as DIMEXML files hereon.

DIMEXML files, or XML files in general, can be created with any text edidtor. However, it is strongly encouraged to have XML file created by software if a data management system is already in place to manage lab test data. Please remember, an XML file must be validated against one of the DIMEXML Schemas before it can be uploaded to DIME.

This page illustrates what are included in an DIMEXML file with a single CTM 204-June 2010: Method of Test for Liquid Limit, Plastic Limit and Plasticity Index of Soils test result. Please note, however, that each of the DIMEXML schemas allows a sample to include any number of test results from any combination of test methods.

DIME allows users to submit brand new samples or to add new test results to existing samples by uploading DIMEXML files. While these two use cases require two different DIMEXML formats, please be sure to view the correct tab below for the intended purpose.

Below are some links that you may find helpful:
  • Not registered for DIME? Check this page out to find out how you can register for DIME: Register for DIME.
  • Not sure what DIME Project ID is for your project? Look it up on this page: DIME Project ID Lookup.
  • DIME also supports submitting data using online forms. Instructions for submitting data using online forms are available Here .
  • To see a full list of supported test methods, please visit Test Catalog Page.
  • To view or download the complete DIMEXML schemas, visit DIMEXML Schema Page.
  • There are many XML validation tools. For a free online tool, try XML Validation Tool.
  • DIMEXML empty structures will be available for download for each of the variations for the test method. Check back later.
  • Instructions on how to upload DIMEXML files to DIME: Upload DIMEXML Instructions

CTM 204-June 2010: Method of Test for Liquid Limit, Plastic Limit and Plasticity Index of Soils DIMEXML Structure

DIMEXML structure for a sample that includes test results for this test method is described in three sections on the page.
  • Element by Elment section describes the structure element by element starting from the root with a depth-first approach until all elements are mentioned.
  • Treeview section provides an complete overview of DIMEXML in a tree-like structure.
  • Tag Definitions section describes each of the tag elments in greater details.
  • * indicates required fields
Also, there are minor differences in the the DIMEXML structures for a new sample record and for an existing sample record. Be sure to look at the "DIMEXML Structure for New Sample" tab for new samples and "DIMEXML Structure for Exiting Sample" tab for existing samples.

Element by Element

Jump to Treeview | Jump to Tag Definitions
Root Element: <Aggregate_dimexml>

The root element for a new sample in Aggregate DIMEXML format is Aggregate_dimexml, and it requires two child elements, new_sample and tests.

<Aggregate_dimexml>
  <new_sample></new_sample>*<!-- complex element. See Child Element: <new_sample> below. -->
  <tests></tests>*<!-- complex element.  See Child Element: <tests> below. -->
</Aggregate_dimexml>*

Child Element: <new_sample> Jump to tag definitions

new_sample requires two fields and two complext types.

<new_sample>
  <sample_project_id></sample_project_id>*<!-- DIME Project ID, look it up using the DIME Project ID Lookup page at https://dime.dot.ca.gov/index.php?r=project/projectIDLookup. -->
  <sample_taken_date></sample_taken_date>*<!-- sample taken date, must be in date format: yyyy-mm-dd -->
  <sample_meta_data></sample_meta_data>*<!-- complex element, see below -->
  <material_identification></material_identification>*<!-- complex element, see below -->
</new_sample>*
Child Element: <sample_meta_data> Jump to tag definitions

sample_meta_data is for storing sample meta data about the sample.

<sample_meta_data>
  <sample_received></sample_received>*<!-- Will the laboratory/organization for which you are a member perform testing on this material sample? -->
  <sample_date_received></sample_date_received><!-- Date that the sample was received by the laboratory/organization performing the testing -->
  <sample_type_name></sample_type_name>*<!-- Sample type -->
  <sample_constitutes></sample_constitutes>*<!-- The quantity of what the sample constitutes -->
  <sample_description></sample_description>*<!-- A brief description of the sample -->
  <sampler_first_name></sampler_first_name>*<!-- First name of sampler or witnessed by -->
  <sampler_last_name></sampler_last_name>*<!-- Last name of sampler or witnessed by -->
  <sampler_title></sampler_title><!-- Title of sampler -->
  <sampler_telephone></sampler_telephone><!-- Telephone number of sampler -->
  <sample_taken_from_source></sample_taken_from_source>*<!-- From where was the sample collected -->
  <sample_source_name></sample_source_name>*<!-- The fabricator/manufacturer/facility name -->
  <sample_laboratory_id></sample_laboratory_id><!-- Laboratory sample identification -->
  <linked_sample></linked_sample><!-- Linked DIME Sample ID -->
  <sample_tl_number></sample_tl_number><!-- Transportation Laboratory (TL) Number -->
  <lot_number_on_tl></lot_number_on_tl><!-- Inspector Lot Number from the Transportation Laboratory (TL) Form -->
  <structure_unique_id></structure_unique_id><!-- Structure unique identifier -->
  <structure_name></structure_name><!-- Structure name -->
</sample_meta_data>	
Child Element: <material_identification> Jump to tag definitions

material_identification is for sample's material identification information.

<material_identification>
  <material_source_ident></material_source_ident>*<!-- Source Identification (SMARA or name of Pit) -->
  <material_product_name></material_product_name><!-- The fabricator's/manufacturer's product name for the sample -->
  <material_designation></material_designation><!-- The fabricator/manufacturer designation for the sample -->
  <material_plant_number></material_plant_number><!-- The plant number -->
  <material_location_description></material_location_description>*<!-- A detailed description of where the material sample was collected -->
  <material_placement></material_placement><!-- Where the material sample would have been placed if not sampled -->
  <primary_aggregate_nominal_size></primary_aggregate_nominal_size>*<!-- Primary Aggregate Nominal Size -->
  <material_concrete_mix_num></material_concrete_mix_num><!-- The concrete mix design number -->
  <lot_number></lot_number><!-- Lot number -->
  <sublot_number></sublot_number><!-- Sublot number -->
</material_identification>
Child Element: <tests>

tests element may contain any number of test results from any combinations of test methods made for this sample. However, in this page, only the CTM 204-June 2010: Method of Test for Liquid Limit, Plastic Limit and Plasticity Index of Soils test result element is described, and <ctm_204_v_jun10_2> is the tag elment for indicating that the test result is for CTM 204-June 2010: Method of Test for Liquid Limit, Plastic Limit and Plasticity Index of Soils.

<tests>
  <ctm_204_v_jun10_2>
    <test_meta_data></test_meta_data>*<!-- complex element, see blow-->
    <test_results></test_results>*<!-- complex element, see below -->
  <ctm_204_v_jun10_2>
</tests>
Child Element: <test_meta_data> Jump to tag definitions

<test_meta_data> requires name_tester and date_tested, and allows for the following optional fields, result_compliance_status, result_compliance_status_comments, test_comments.

<test_meta_data>
  <name_tester></name_tester>*<!-- Tester's full name -->
  <date_tested></date_tested>*<!-- Date of test -->
  <test_comments></test_comments><!-- General comments (publicly viewable) (Max 250 characters) -->
  <result_compliance_status></result_compliance_status><!-- Test result compliance -->
  <result_compliance_status_comments></result_compliance_status_comments><!-- Project test result compliance comments (Max 250 characters) -->
</test_meta_data>
Child Element: <test_results> Jump to tag definitions

This test method requires users to answer the following question(s) before the required/optional field(s) are determined.

  • (Tag ID: 6374) - The test method used?. Possible answers: iquid Limit-Method A,Liquid Limit-Method B,Plastic Limit,Plastic Index
Combining each answer from the questions above, this test method allows for the following variations. However, the DIMEXML schema requires the DIMEXML files to have one and only one of the variations for test results.

<test_results>
  <data__6374__Liquid_Limit-Method_A></data__6374__Liquid_Limit-Method_A>*<!-- complex test method variation element, see below -->
  <data__6374__Liquid_Limit-Method_B></data__6374__Liquid_Limit-Method_B>*<!-- complex test method variation element, see below -->
  <data__6374__Plastic_Limit></data__6374__Plastic_Limit>*<!-- complex test method variation element, see below -->
  <data__6374__Plastic_Index></data__6374__Plastic_Index>*<!-- complex test method variation element, see below -->
</test_results>		
Child Element: <data__6374__Liquid_Limit-Method_A>

This element is used when the following answer(s) are provided:

  • The test method used?: Liquid_Limit-Method_A

<data__6374__Liquid_Limit-Method_A>
  <percent_moisture_CTM204_1></percent_moisture_CTM204_1>*<!-- Percent moisture (measure 1) -->
  <liquid_limit_CTM204></liquid_limit_CTM204>*<!-- Liquid Limit (LL) -->
  <percent_moisture_CTM204_2></percent_moisture_CTM204_2>*<!-- Percent moisture (measure 2) -->
  <percent_moisture_CTM204_3></percent_moisture_CTM204_3>*<!-- Percent moisture (measure 3) -->
  <percent_moisture_CTM204_4></percent_moisture_CTM204_4><!-- Percent moisture (measure 4) -->
  <percent_moisture_CTM204_5></percent_moisture_CTM204_5><!-- Percent moisture (measure 5) -->
  <weight_od_soil_CTM204></weight_od_soil_CTM204>*<!-- Weight of oven-dried soil -->
  <percent_moisture_CTM204_6></percent_moisture_CTM204_6><!-- Percent moisture (measure 6) -->
  <weight_wc_CTM204_1></weight_wc_CTM204_1>*<!-- Weight of water content (measure 1) -->
  <percent_moisture_CTM204_7></percent_moisture_CTM204_7><!-- Percent moisture (measure 7) -->
  <weight_wc_CTM204_2></weight_wc_CTM204_2>*<!-- Weight of water content (measure 2) -->
  <percent_moisture_CTM204_8></percent_moisture_CTM204_8><!-- Percent moisture (measure 8) -->
  <weight_wc_CTM204_3></weight_wc_CTM204_3>*<!-- Weight of water content (measure 3) -->
  <weight_wc_CTM204_4></weight_wc_CTM204_4><!-- Weight of water content (measure 4) -->
  <weight_wc_CTM204_5></weight_wc_CTM204_5><!-- Weight of water content (measure 5) -->
  <weight_wc_CTM204_6></weight_wc_CTM204_6><!-- Weight of water content (measure 6) -->
  <weight_wc_CTM204_7></weight_wc_CTM204_7><!-- Weight of water content (measure 7) -->
  <weight_wc_CTM204_8></weight_wc_CTM204_8><!-- Weight of water content (measure 8) -->
  <shocks_CTM204_1></shocks_CTM204_1>*<!-- Number of shocks to close the groove (measure 1) -->
  <shocks_CTM204_2></shocks_CTM204_2>*<!-- Number of shocks to close the groove (measure 2) -->
  <shocks_CTM204_3></shocks_CTM204_3>*<!-- Number of shocks to close the groove (measure 3) -->
  <shocks_CTM204_4></shocks_CTM204_4><!-- Number of shocks to close the groove (measure 4) -->
  <shocks_CTM204_5></shocks_CTM204_5><!-- Number of shocks to close the groove (measure 5) -->
  <shocks_CTM204_6></shocks_CTM204_6><!-- Number of shocks to close the groove (measure 6) -->
  <shocks_CTM204_7></shocks_CTM204_7><!-- Number of shocks to close the groove (measure 7) -->
  <shocks_CTM204_8></shocks_CTM204_8><!-- Number of shocks to close the groove (measure 8) -->
</data__6374__Liquid_Limit-Method_A>
Child Element: <data__6374__Liquid_Limit-Method_B>

This element is used when the following answer(s) are provided:

  • The test method used?: Liquid_Limit-Method_B

<data__6374__Liquid_Limit-Method_B>
  <corrected_liquid_limit_CTM204></corrected_liquid_limit_CTM204>*<!-- Liquid limit corrected for closure at 25 blows (LL) -->
  <shocks_CTM204_9></shocks_CTM204_9>*<!-- Number of blows causing closure of the groove -->
  <water_content_CTM204></water_content_CTM204>*<!-- Sample water content -->
</data__6374__Liquid_Limit-Method_B>
Child Element: <data__6374__Plastic_Limit>

This element is used when the following answer(s) are provided:

  • The test method used?: Plastic_Limit

<data__6374__Plastic_Limit>
  <plastic_limit_CTM204_1></plastic_limit_CTM204_1>*<!-- Plastic limit (PL) -->
  <weight_od_soil_CTM204></weight_od_soil_CTM204>*<!-- Weight of oven-dried soil -->
  <weight_wc_CTM204_9></weight_wc_CTM204_9>*<!-- Weight of water content -->
</data__6374__Plastic_Limit>
Child Element: <data__6374__Plastic_Index>

This element is used when the following answer(s) are provided:

  • The test method used?: Plastic_Index

<data__6374__Plastic_Index>
  <plastic_index_CTM204></plastic_index_CTM204>*<!-- Plastic Index(PI) -->
  <liquid_limit_CTM204></liquid_limit_CTM204>*<!-- Liquid Limit (LL) -->
  <plastic_limit_CTM204_2></plastic_limit_CTM204_2>*<!-- Plastic Limit (PL) -->
</data__6374__Plastic_Index>

DIMEXML Structure Treeviews

Jump to Element by Element | Jump to Tag Definitions
- Click the icons to collapse the DIMEXML sample structure tree.
- * indicates required fields
- indiciates tags can be referred to the corresponding tables for detailed requirements.
  • Aggregate_dimexml
    • new_sample*Jump to tag definitions
      • dime_project_id*
      • sample_taken_date*
      • sample_meta_data*Jump to tag definitions
        • sample_received*
        • sample_date_received
        • sample_type_name*
        • sample_constitutes*
        • sample_description*
        • sampler_first_name*
        • sampler_last_name*
        • sampler_title
        • sampler_telephone
        • sample_taken_from_source*
        • sample_source_name*
        • sample_laboratory_id
        • linked_sample
        • sample_tl_number
        • lot_number_on_tl
        • structure_unique_id
        • structure_name
      • material_identification*Jump to tag definitions
        • sample_received*
        • sample_date_received
        • sample_type_name*
        • sample_constitutes*
        • sample_description*
        • sampler_first_name*
        • sampler_last_name*
        • sampler_title
        • sampler_telephone
        • sample_taken_from_source*
        • sample_source_name*
        • sample_laboratory_id
        • linked_sample
        • sample_tl_number
        • lot_number_on_tl
        • structure_unique_id
        • structure_name
    • tests*
      • ctm_204_v_jun10_2*
        • test_meta_data*Jump to tag definitions
          • name_tester*
          • date_tested*
          • result_compliance_status
          • result_compliance_status_comments
          • test_comments
        • test_results * (Requires Tags from One of Test Method Variations Below) Jump to tag definitions
          • data__6374__Liquid_Limit-Method_A (DIMEXML template for this variation available soon)
          • data__6374__Liquid_Limit-Method_B (DIMEXML template for this variation available soon)
          • data__6374__Plastic_Limit (DIMEXML template for this variation available soon)
          • data__6374__Plastic_Index (DIMEXML template for this variation available soon)

Tag Definitions

Jump to Element by Element | Jump to Treeview
new_sample
Total of 3 tags
LabelTagRequired?Base TypeValue RestrictionUnit Required?Unit Restriction
DIME Project IDsample_project_idRequiredstringpattern:\d{1,25}NoN/A
Date the sample is takensample_taken_dateRequireddate NoN/A
Sample unique sequential digitssample_unique_keyOptionalstringpattern:\d{8,16}NoN/A
sample_meta_data
Total of 17 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Will the laboratory/organization for which you are a member perform testing on this material sample?sample_receivedRequiredstringenumeration:,Yes,NoNoN/A
Date that the sample was received by the laboratory/organization performing the testingsample_date_receivedOptionaldate NoN/A
Sample typesample_type_nameRequiredstringenumeration: ,Quality Control,Verification,Quality Assurance,Dispute Resolution,Acceptance,Annual Source Testing,Per Request,Preliminary,Independent Assurance,Informational,Control Sample,Stock,Authorization,Proficiency,Recertification,Retest,Aggregate Prequalification ProgramNoN/A
The quantity of what the sample constitutessample_constitutesRequiredstringpattern:.{1,100}NoN/A
A brief description of the samplesample_descriptionRequiredstringpattern:.{1,255}NoN/A
First name of sampler or witnessed bysampler_first_nameRequiredstringpattern:[\w\s]{1,100}NoN/A
Last name of sampler or witnessed bysampler_last_nameRequiredstringpattern:[\w\s]{1,100}NoN/A
Title of samplersampler_titleOptionalstringpattern:[\w\s]{0,100}NoN/A
Telephone number of samplersampler_telephoneOptionalstringpattern:[0-9\(\)\- ]{9,20}|UnknownNoN/A
From where was the sample collectedsample_taken_from_sourceRequiredstringenumeration:,Source,Job Site,Fabricator,Manufacturer,Distributor,OtherNoN/A
The fabricator/manufacturer/facility namesample_source_nameRequiredstringpattern:[\w\s,-]{1,100}NoN/A
Laboratory sample identificationsample_laboratory_idOptionalstringpattern:[\w\s,+-]{1,100}NoN/A
Linked DIME Sample IDlinked_sampleOptionalstring NoN/A
Transportation Laboratory (TL) Numbersample_tl_numberOptionalstringpattern:[\w\s+-]{1,100}NoN/A
Inspector Lot Number from the Transportation Laboratory (TL) Formlot_number_on_tlOptionalstringpattern:[\w\s,/-]{1,255}NoN/A
Structure unique identifierstructure_unique_idOptionalstringpattern:\d{2}\-.*NoN/A
Structure namestructure_nameOptionalstringpattern:[\w\s-,/]{1,100}NoN/A
material_identification
Total of 10 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Source Identification (SMARA or name of Pit)material_source_identRequiredstringpattern:[\w\s/\-:,.()\#]{1,100}NoN/A
The fabricator's/manufacturer's product name for the samplematerial_product_nameOptionalstringpattern:[\w\s-./]{0,100}NoN/A
The fabricator/manufacturer designation for the samplematerial_designationOptionalstringpattern:[\w\s-./]{0,100}NoN/A
The plant numbermaterial_plant_numberOptionalstringpattern:[\w\s]{0,100}NoN/A
A detailed description of where the material sample was collectedmaterial_location_descriptionRequiredstringpattern:[\w\s\-,.@]{1,100}NoN/A
Where the material sample would have been placed if not sampledmaterial_placementOptionalstringpattern:[\w\s]{0,100}NoN/A
Primary Aggregate Nominal Sizeprimary_aggregate_nominal_sizeRequiredstringenumeration:,1-1/2 inch,1 inch,3/4 inch,1/2 inch,3/8 inch,1/4 inch,fineNoN/A
The concrete mix design numbermaterial_concrete_mix_numOptionalstringpattern:[\w\s+-]{1,20}NoN/A
Lot numberlot_numberOptionalstringpattern:(Unknown|[0-9]|1[0-9]|20)NoN/A
Sublot numbersublot_numberOptionalstringpattern:(Unknown|[0-9]|1[0-9]|20)NoN/A
test_meta_data
Total of 6 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Test identification numbersample_id_numberOptionalstringpattern:\d{1,8}NoN/A
Tester's full namename_testerRequiredstringpattern:[\w\s\\/,.-]{1,100}NoN/A
Date of testdate_testedRequireddate NoN/A
General comments (publicly viewable) (Max 250 characters)test_commentsOptionalstringpattern:[=!@#&amp;$%*()-,.\w\s\d\-:;\\/]{0,250}NoN/A
Test result complianceresult_compliance_statusOptionalstringenumeration: ,complies,does not comply,not applicableNoN/A
Project test result compliance comments (Max 250 characters)result_compliance_status_commentsOptionalstringpattern:[=!@#&amp;$%*()-,.\w\s\d\-:]{0,250}NoN/A
Test Method Variation Tables

Variation(combo tag): data__6374__Liquid_Limit-Method_A

data__6374__Liquid_Limit-Method_A
Total of 26 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Percent moisture (measure 1)percent_moisture_CTM204_1Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Liquid Limit (LL)liquid_limit_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+|Undetermined)Yes%
Percent moisture (measure 2)percent_moisture_CTM204_2Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Percent moisture (measure 3)percent_moisture_CTM204_3Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Percent moisture (measure 4)percent_moisture_CTM204_4Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Percent moisture (measure 5)percent_moisture_CTM204_5Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Weight of oven-dried soilweight_od_soil_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Percent moisture (measure 6)percent_moisture_CTM204_6Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Weight of water content (measure 1)weight_wc_CTM204_1Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Percent moisture (measure 7)percent_moisture_CTM204_7Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Weight of water content (measure 2)weight_wc_CTM204_2Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Percent moisture (measure 8)percent_moisture_CTM204_8Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Weight of water content (measure 3)weight_wc_CTM204_3Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 4)weight_wc_CTM204_4Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 5)weight_wc_CTM204_5Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 6)weight_wc_CTM204_6Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 7)weight_wc_CTM204_7Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 8)weight_wc_CTM204_8Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Number of shocks to close the groove (measure 1)shocks_CTM204_1Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 2)shocks_CTM204_2Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 3)shocks_CTM204_3Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 4)shocks_CTM204_4Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 5)shocks_CTM204_5Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 6)shocks_CTM204_6Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 7)shocks_CTM204_7Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 8)shocks_CTM204_8Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A

Variation(combo tag): data__6374__Liquid_Limit-Method_B

data__6374__Liquid_Limit-Method_B
Total of 3 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Liquid limit corrected for closure at 25 blows (LL)corrected_liquid_limit_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Number of blows causing closure of the grooveshocks_CTM204_9Requireddecimalpattern:\d+NoN/A
Sample water contentwater_content_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%

Variation(combo tag): data__6374__Plastic_Limit

data__6374__Plastic_Limit
Total of 3 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Plastic limit (PL)plastic_limit_CTM204_1Requireddecimalpattern:\d+Yes%
Weight of oven-dried soilweight_od_soil_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water contentweight_wc_CTM204_9Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg

Variation(combo tag): data__6374__Plastic_Index

data__6374__Plastic_Index
Total of 3 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Plastic Index(PI)plastic_index_CTM204Requireddecimalpattern:([+-]?\d+|[+-]?\d+\.|\d*\.\d+|Undetermined|NP)NoN/A
Liquid Limit (LL)liquid_limit_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+|Undetermined)Yes%
Plastic Limit (PL)plastic_limit_CTM204_2Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+|Undetermined)Yes%

Element by Element

Jump to Treeview | Jump to Tag Definitions
Root Element: <Aggregate_dimexml>

The root element for an existing sample in Aggregate DIMEXML format is Aggregate_dimexml, and it requires two child elements, existing_sample and tests.

<Aggregate_dimexml>
  <existing_sample></existing_sample>*<!-- complex element. See Child Element: <existing_sample> below. -->
  <tests></tests>*<!-- complex element.  See Child Element: <tests> below. -->
</Aggregate_dimexml>*
Child Element: <existing_sample> Jump to Tag Definitions

existing_sample requires three fields, sample_project_id, sample_taken_date, sample_unique_key

<existing_sample>
  <sample_project_id></sample_project_id>*<!-- DIME Project ID, look it up using the DIME Project ID Lookup page at https://dime.dot.ca.gov/index.php?r=project/projectIDLookup. -->
  <sample_taken_date></sample_taken_date>*<!-- sample taken date, must be in date format: yyyy-mm-dd -->
  <sample_unique_key></sample_unique_key>*<!-- sample unique key, must be a minimum of 8 numerical characters, ie. 0-9 -->
</existing_sample>*
Child Element: <tests>

tests element may contain any number of test results from any combinations of test methods made for this sample. However, in this page, only the CTM 204-June 2010: Method of Test for Liquid Limit, Plastic Limit and Plasticity Index of Soils test result element is described, and <ctm_204_v_jun10_2> is the tag elment for indicating that the test result is for CTM 204-June 2010: Method of Test for Liquid Limit, Plastic Limit and Plasticity Index of Soils.

<tests>
  <ctm_204_v_jun10_2>
    <test_meta_data></test_meta_data>*<!-- complex element, see blow-->
    <test_results></test_results>*<!-- complex element, see below -->
  <ctm_204_v_jun10_2>
</tests>
Child Element: <test_meta_data> Jump to Tag Definitions

<test_meta_data> requires name_tester and date_tested, and allows for the following optional fields, result_compliance_status, result_compliance_status_comments, test_comments.

<test_meta_data>
  <name_tester></name_tester>*<!-- Tester's full name -->
  <date_tested></date_tested>*<!-- Date of test -->
  <test_comments></test_comments><!-- General comments (publicly viewable) (Max 250 characters) -->
  <result_compliance_status></result_compliance_status><!-- Test result compliance -->
  <result_compliance_status_comments></result_compliance_status_comments><!-- Project test result compliance comments (Max 250 characters) -->
</test_meta_data>
Child Element: <test_results>

This test method requires users to answer the following question(s) before the required/optional field(s) are determined.

  • (Tag ID: 6374) - The test method used?. Possible answers: iquid Limit-Method A,Liquid Limit-Method B,Plastic Limit,Plastic Index
Combining each answer from the questions above, this test method allows for the following variations. However, the DIMEXML schema requires the DIMEXML files to have one and only one of the variations for test results.

<test_results>
  <data__6374__Liquid_Limit-Method_A></data__6374__Liquid_Limit-Method_A>*<!-- complex test method variation element, see below -->
  <data__6374__Liquid_Limit-Method_B></data__6374__Liquid_Limit-Method_B>*<!-- complex test method variation element, see below -->
  <data__6374__Plastic_Limit></data__6374__Plastic_Limit>*<!-- complex test method variation element, see below -->
  <data__6374__Plastic_Index></data__6374__Plastic_Index>*<!-- complex test method variation element, see below -->
</test_results>
Child Element: <data__6374__Liquid_Limit-Method_A>

This element is used when the following answer(s) are provided:

  • The test method used?: Liquid_Limit-Method_A

<data__6374__Liquid_Limit-Method_A>
  <percent_moisture_CTM204_1></percent_moisture_CTM204_1>*<!-- Percent moisture (measure 1) -->
  <liquid_limit_CTM204></liquid_limit_CTM204>*<!-- Liquid Limit (LL) -->
  <percent_moisture_CTM204_2></percent_moisture_CTM204_2>*<!-- Percent moisture (measure 2) -->
  <percent_moisture_CTM204_3></percent_moisture_CTM204_3>*<!-- Percent moisture (measure 3) -->
  <percent_moisture_CTM204_4></percent_moisture_CTM204_4><!-- Percent moisture (measure 4) -->
  <percent_moisture_CTM204_5></percent_moisture_CTM204_5><!-- Percent moisture (measure 5) -->
  <weight_od_soil_CTM204></weight_od_soil_CTM204>*<!-- Weight of oven-dried soil -->
  <percent_moisture_CTM204_6></percent_moisture_CTM204_6><!-- Percent moisture (measure 6) -->
  <weight_wc_CTM204_1></weight_wc_CTM204_1>*<!-- Weight of water content (measure 1) -->
  <percent_moisture_CTM204_7></percent_moisture_CTM204_7><!-- Percent moisture (measure 7) -->
  <weight_wc_CTM204_2></weight_wc_CTM204_2>*<!-- Weight of water content (measure 2) -->
  <percent_moisture_CTM204_8></percent_moisture_CTM204_8><!-- Percent moisture (measure 8) -->
  <weight_wc_CTM204_3></weight_wc_CTM204_3>*<!-- Weight of water content (measure 3) -->
  <weight_wc_CTM204_4></weight_wc_CTM204_4><!-- Weight of water content (measure 4) -->
  <weight_wc_CTM204_5></weight_wc_CTM204_5><!-- Weight of water content (measure 5) -->
  <weight_wc_CTM204_6></weight_wc_CTM204_6><!-- Weight of water content (measure 6) -->
  <weight_wc_CTM204_7></weight_wc_CTM204_7><!-- Weight of water content (measure 7) -->
  <weight_wc_CTM204_8></weight_wc_CTM204_8><!-- Weight of water content (measure 8) -->
  <shocks_CTM204_1></shocks_CTM204_1>*<!-- Number of shocks to close the groove (measure 1) -->
  <shocks_CTM204_2></shocks_CTM204_2>*<!-- Number of shocks to close the groove (measure 2) -->
  <shocks_CTM204_3></shocks_CTM204_3>*<!-- Number of shocks to close the groove (measure 3) -->
  <shocks_CTM204_4></shocks_CTM204_4><!-- Number of shocks to close the groove (measure 4) -->
  <shocks_CTM204_5></shocks_CTM204_5><!-- Number of shocks to close the groove (measure 5) -->
  <shocks_CTM204_6></shocks_CTM204_6><!-- Number of shocks to close the groove (measure 6) -->
  <shocks_CTM204_7></shocks_CTM204_7><!-- Number of shocks to close the groove (measure 7) -->
  <shocks_CTM204_8></shocks_CTM204_8><!-- Number of shocks to close the groove (measure 8) -->
</data__6374__Liquid_Limit-Method_A>
Child Element: <data__6374__Liquid_Limit-Method_B>

This element is used when the following answer(s) are provided:

  • The test method used?: Liquid_Limit-Method_B

<data__6374__Liquid_Limit-Method_B>
  <corrected_liquid_limit_CTM204></corrected_liquid_limit_CTM204>*<!-- Liquid limit corrected for closure at 25 blows (LL) -->
  <shocks_CTM204_9></shocks_CTM204_9>*<!-- Number of blows causing closure of the groove -->
  <water_content_CTM204></water_content_CTM204>*<!-- Sample water content -->
</data__6374__Liquid_Limit-Method_B>
Child Element: <data__6374__Plastic_Limit>

This element is used when the following answer(s) are provided:

  • The test method used?: Plastic_Limit

<data__6374__Plastic_Limit>
  <plastic_limit_CTM204_1></plastic_limit_CTM204_1>*<!-- Plastic limit (PL) -->
  <weight_od_soil_CTM204></weight_od_soil_CTM204>*<!-- Weight of oven-dried soil -->
  <weight_wc_CTM204_9></weight_wc_CTM204_9>*<!-- Weight of water content -->
</data__6374__Plastic_Limit>
Child Element: <data__6374__Plastic_Index>

This element is used when the following answer(s) are provided:

  • The test method used?: Plastic_Index

<data__6374__Plastic_Index>
  <plastic_index_CTM204></plastic_index_CTM204>*<!-- Plastic Index(PI) -->
  <liquid_limit_CTM204></liquid_limit_CTM204>*<!-- Liquid Limit (LL) -->
  <plastic_limit_CTM204_2></plastic_limit_CTM204_2>*<!-- Plastic Limit (PL) -->
</data__6374__Plastic_Index>

DIMEXML Structure Treeviews

Jump to Element by Element | Jump to Tag Definitions
- Click the icons to collapse the DIMEXML sample structure tree.
- * indicates required fields
- indiciates tags can be referred to the corresponding tables for detailed requirements.
  • Aggregate_dimexml
    • existing_sample*Jump to Tag Definitions
      • sample_project_id*
      • sample_taken_date*
      • sample_unique_key*
    • tests*
      • ctm_204_v_jun10_2*
        • test_meta_data*Jump to Tag Definitions
          • name_tester*
          • date_tested*
          • result_compliance_status
          • result_compliance_status_comments
          • test_comments
        • test_results * (Requires Tags from One of Test Method Variations Below) Jump to Tag Definitions
          • data__6374__Liquid_Limit-Method_A (DIMEXML template for this variation available soon)
          • data__6374__Liquid_Limit-Method_B (DIMEXML template for this variation available soon)
          • data__6374__Plastic_Limit (DIMEXML template for this variation available soon)
          • data__6374__Plastic_Index (DIMEXML template for this variation available soon)

Tag Definitions

Jump to Element by Element | Jump to Treeview
existing_sample
Total of 3 tags
LabelTagRequired?Base TypeValue RestrictionUnit Required?Unit Restriction
DIME Project IDsample_project_idRequiredstringpattern:\d{1,25}NoN/A
Date the sample is takensample_taken_dateRequireddate NoN/A
Sample unique sequential digitssample_unique_keyRequiredstringpattern:\d{8,16}NoN/A
test_meta_data
Total of 6 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Test identification numbersample_id_numberOptionalstringpattern:\d{1,8}NoN/A
Tester's full namename_testerRequiredstringpattern:[\w\s\\/,.-]{1,100}NoN/A
Date of testdate_testedRequireddate NoN/A
General comments (publicly viewable) (Max 250 characters)test_commentsOptionalstringpattern:[=!@#&amp;$%*()-,.\w\s\d\-:;\\/]{0,250}NoN/A
Test result complianceresult_compliance_statusOptionalstringenumeration: ,complies,does not comply,not applicableNoN/A
Project test result compliance comments (Max 250 characters)result_compliance_status_commentsOptionalstringpattern:[=!@#&amp;$%*()-,.\w\s\d\-:]{0,250}NoN/A
Test Method Variation Tables

Variation(combo tag): data__6374__Liquid_Limit-Method_A

data__6374__Liquid_Limit-Method_A
Total of 26 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Percent moisture (measure 1)percent_moisture_CTM204_1Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Liquid Limit (LL)liquid_limit_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+|Undetermined)Yes%
Percent moisture (measure 2)percent_moisture_CTM204_2Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Percent moisture (measure 3)percent_moisture_CTM204_3Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Percent moisture (measure 4)percent_moisture_CTM204_4Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Percent moisture (measure 5)percent_moisture_CTM204_5Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Weight of oven-dried soilweight_od_soil_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Percent moisture (measure 6)percent_moisture_CTM204_6Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Weight of water content (measure 1)weight_wc_CTM204_1Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Percent moisture (measure 7)percent_moisture_CTM204_7Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Weight of water content (measure 2)weight_wc_CTM204_2Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Percent moisture (measure 8)percent_moisture_CTM204_8Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Weight of water content (measure 3)weight_wc_CTM204_3Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 4)weight_wc_CTM204_4Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 5)weight_wc_CTM204_5Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 6)weight_wc_CTM204_6Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 7)weight_wc_CTM204_7Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water content (measure 8)weight_wc_CTM204_8Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Number of shocks to close the groove (measure 1)shocks_CTM204_1Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 2)shocks_CTM204_2Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 3)shocks_CTM204_3Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 4)shocks_CTM204_4Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 5)shocks_CTM204_5Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 6)shocks_CTM204_6Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 7)shocks_CTM204_7Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A
Number of shocks to close the groove (measure 8)shocks_CTM204_8Optionaldecimalpattern:(\d+|\d+\.|\d*\.\d+)NoN/A

Variation(combo tag): data__6374__Liquid_Limit-Method_B

data__6374__Liquid_Limit-Method_B
Total of 3 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Liquid limit corrected for closure at 25 blows (LL)corrected_liquid_limit_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%
Number of blows causing closure of the grooveshocks_CTM204_9Requireddecimalpattern:\d+NoN/A
Sample water contentwater_content_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yes%

Variation(combo tag): data__6374__Plastic_Limit

data__6374__Plastic_Limit
Total of 3 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Plastic limit (PL)plastic_limit_CTM204_1Requireddecimalpattern:\d+Yes%
Weight of oven-dried soilweight_od_soil_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg
Weight of water contentweight_wc_CTM204_9Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+)Yesg

Variation(combo tag): data__6374__Plastic_Index

data__6374__Plastic_Index
Total of 3 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Plastic Index(PI)plastic_index_CTM204Requireddecimalpattern:([+-]?\d+|[+-]?\d+\.|\d*\.\d+|Undetermined|NP)NoN/A
Liquid Limit (LL)liquid_limit_CTM204Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+|Undetermined)Yes%
Plastic Limit (PL)plastic_limit_CTM204_2Requireddecimalpattern:(\d+|\d+\.|\d*\.\d+|Undetermined)Yes%