DIMEXML for Test Method

CTM 208-September 2011: Method of Test for Apparent Specific Gravity of Fine Aggregates


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 208-September 2011: Method of Test for Apparent Specific Gravity of Fine Aggregates 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 208-September 2011: Method of Test for Apparent Specific Gravity of Fine Aggregates 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 208-September 2011: Method of Test for Apparent Specific Gravity of Fine Aggregates test result element is described, and <ctm_208_v_sep11> is the tag elment for indicating that the test result is for CTM 208-September 2011: Method of Test for Apparent Specific Gravity of Fine Aggregates.

<tests>
  <ctm_208_v_sep11>
    <test_meta_data></test_meta_data>*<!-- complex element, see blow-->
    <test_results></test_results>*<!-- complex element, see below -->
  <ctm_208_v_sep11>
</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

<test_results> requires <data>

<test_results>
  <data></data>*<!-- complex test method variation element, see below -->
</test_results>		
Child Element: <data>

<data>
  <water_temp_initial_CTM208></water_temp_initial_CTM208>*<!-- Initial Water Temperature -->
  <volume_solvent_CTM208></volume_solvent_CTM208>*<!-- Volume of Solvent -->
  <mass_solvent_flask_CTM208></mass_solvent_flask_CTM208>*<!-- Mass of Flask + Solvent -->
  <mass_solvent_flask_sample_CTM208></mass_solvent_flask_sample_CTM208>*<!-- Mass of Flask + Solvent + Sample -->
  <water_temp_final_CTM208></water_temp_final_CTM208>*<!-- Final Water Temperature -->
  <volume_solvent_sample_CTM208></volume_solvent_sample_CTM208>*<!-- Volume of Solvent + Sample -->
  <mass_sample_CTM208></mass_sample_CTM208>*<!-- Mass of Sample -->
  <volume_sample_uncorrected_CTM208></volume_sample_uncorrected_CTM208>*<!-- Volume of Sample (uncorrected) -->
  <temp_change_CTM208></temp_change_CTM208>*<!-- Temperature Change -->
  <volume_sample_corrected_CTM208></volume_sample_corrected_CTM208>*<!-- Volume of Sample (corrected) -->
  <sg_CTM208></sg_CTM208>*<!-- Specific Gravity -->
</data>

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_208_v_sep11*
        • 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 (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

data
Total of 11 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Initial Water Temperaturewater_temp_initial_CTM208Requireddecimalpattern:\d*\.\d{1}YesF
Volume of Solventvolume_solvent_CTM208Requireddecimalpattern:\d*\.\d{1}YesmL
Mass of Flask + Solventmass_solvent_flask_CTM208Requireddecimalpattern:\d*\.\d{1}Yesgrams
Mass of Flask + Solvent + Samplemass_solvent_flask_sample_CTM208Requireddecimalpattern:\d*\.\d{1}Yesgrams
Final Water Temperaturewater_temp_final_CTM208Requireddecimalpattern:\d*\.\d{1}YesF
Volume of Solvent + Samplevolume_solvent_sample_CTM208Requireddecimalpattern:\d*\.\d{1}YesmL
Mass of Samplemass_sample_CTM208Requireddecimalpattern:\d*\.\d{1}Yesgrams
Volume of Sample (uncorrected)volume_sample_uncorrected_CTM208Requireddecimalpattern:\d*\.\d{1}YesmL
Temperature Changetemp_change_CTM208Requireddecimalpattern:-?\d*\.\d{1}YesF
Volume of Sample (corrected)volume_sample_corrected_CTM208Requireddecimalpattern:\d*\.\d{1}YesmL
Specific Gravitysg_CTM208Requireddecimalpattern:\d*\.\d{2}NoN/A

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 208-September 2011: Method of Test for Apparent Specific Gravity of Fine Aggregates test result element is described, and <ctm_208_v_sep11> is the tag elment for indicating that the test result is for CTM 208-September 2011: Method of Test for Apparent Specific Gravity of Fine Aggregates.

<tests>
  <ctm_208_v_sep11>
    <test_meta_data></test_meta_data>*<!-- complex element, see blow-->
    <test_results></test_results>*<!-- complex element, see below -->
  <ctm_208_v_sep11>
</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>

<test_results> requires <data>

<test_results>
  <data></data>*<!-- complex test method variation element, see below -->
</test_results>
Child Element: <data>

<data>
  <water_temp_initial_CTM208></water_temp_initial_CTM208>*<!-- Initial Water Temperature -->
  <volume_solvent_CTM208></volume_solvent_CTM208>*<!-- Volume of Solvent -->
  <mass_solvent_flask_CTM208></mass_solvent_flask_CTM208>*<!-- Mass of Flask + Solvent -->
  <mass_solvent_flask_sample_CTM208></mass_solvent_flask_sample_CTM208>*<!-- Mass of Flask + Solvent + Sample -->
  <water_temp_final_CTM208></water_temp_final_CTM208>*<!-- Final Water Temperature -->
  <volume_solvent_sample_CTM208></volume_solvent_sample_CTM208>*<!-- Volume of Solvent + Sample -->
  <mass_sample_CTM208></mass_sample_CTM208>*<!-- Mass of Sample -->
  <volume_sample_uncorrected_CTM208></volume_sample_uncorrected_CTM208>*<!-- Volume of Sample (uncorrected) -->
  <temp_change_CTM208></temp_change_CTM208>*<!-- Temperature Change -->
  <volume_sample_corrected_CTM208></volume_sample_corrected_CTM208>*<!-- Volume of Sample (corrected) -->
  <sg_CTM208></sg_CTM208>*<!-- Specific Gravity -->
</data>

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_208_v_sep11*
        • 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 (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

data
Total of 11 tags
LabelTagRequired?Base TypeValue RestrictionAttribute "units" Required?Allowed Units
Initial Water Temperaturewater_temp_initial_CTM208Requireddecimalpattern:\d*\.\d{1}YesF
Volume of Solventvolume_solvent_CTM208Requireddecimalpattern:\d*\.\d{1}YesmL
Mass of Flask + Solventmass_solvent_flask_CTM208Requireddecimalpattern:\d*\.\d{1}Yesgrams
Mass of Flask + Solvent + Samplemass_solvent_flask_sample_CTM208Requireddecimalpattern:\d*\.\d{1}Yesgrams
Final Water Temperaturewater_temp_final_CTM208Requireddecimalpattern:\d*\.\d{1}YesF
Volume of Solvent + Samplevolume_solvent_sample_CTM208Requireddecimalpattern:\d*\.\d{1}YesmL
Mass of Samplemass_sample_CTM208Requireddecimalpattern:\d*\.\d{1}Yesgrams
Volume of Sample (uncorrected)volume_sample_uncorrected_CTM208Requireddecimalpattern:\d*\.\d{1}YesmL
Temperature Changetemp_change_CTM208Requireddecimalpattern:-?\d*\.\d{1}YesF
Volume of Sample (corrected)volume_sample_corrected_CTM208Requireddecimalpattern:\d*\.\d{1}YesmL
Specific Gravitysg_CTM208Requireddecimalpattern:\d*\.\d{2}NoN/A