Versions Compared

Old Version 18

changes.mady.by.user Camille Woods

Saved on

compared with

New Version 19

changes.mady.by.user Ingrid Garcia-Solera

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
stylecircle

Element Description

The Tiling Identification System element defines a named two-dimensional tiling system related to the collection. 

Best Practices

A tiling identification system is a defined 2-D grid which covers the surface of the Earth. An example of a tiling identification system is the Worldwide Reference System (WRS) where the surface of the Earth is split into numbered paths and rows. The WRS-2 system is used to catalog Landsat data and is a popular way to search for Landsat data. Another example are the various MODIS grids, such as the MODIS Sinusoidal Tile Grid system which divides the Earth into 595 10 x 10 degree tiles.    

There are five sub-elements used to specify a tiling identification system. If provided, all of the sub-fields are required:

Tiling Identification System Name: This field identifies the name of the tiling identification system. The name must be selected from a controlled enumeration list which includes the following values: CALIPSO, MISR, MODIS Tile EASE, MODIS Tile SIN, WELD Alaska Tile, WELD CONUS Tile, WRS-1, WRS-2  

Coordinate 1/ Minimum Value: Identifies the minimum value for one dimension (e.g. horizontal) of the two dimensional tiling system. 

Coordinate 1/ Maximum Value: Identifies the maximum value for one dimension (e.g. horizontal) of the two dimensional tiling system.

Coordinate 2/ Minimum Value: Identifies the minimum value for the other dimension (e.g. vertical) of the two dimensional tiling system.

Coordinate 2/ Maximum Value: Identifies the maximum value for the other dimension (e.g. vertical) of the two dimensional tiling system. 


Examples:

TilingIdentificationSystemName: MISR

Coordinate1/MinimumValue: 1

Coordinate2/MaximumValue: 233

Coordinate2/MinimumValue: 1 

Coordinate2/MaximumValue: 80


TilingIdentificationSystemName: MODIS Tile SIN

Coordinate1/MinimumValue: 0

Coordinate2/MaximumValue: 35

Coordinate2/MinimumValue: 0 

Coordinate2/MaximumValue: 17


Element Specification

Providing a Tiling Identification System is optional. An unlimited amount of Tiling Identification Systems may be provided (Cardinality: 0..*)

ModelElementTypeUsable Valid ValuesConstraintsRequired?CardinalityNotes
UMM-CommonTilingIdentificationSystem/TilingIdentificationSystemNameEnumeration

CALIPSO

MISR

MODIS Tile EASE

MODIS Tile SIN

WELD Alaska Tile

WELD CONUS Tile

WRS-1

WRS-2

n/a

Yes, if applicable1Location of the TilingIdentificationSystemNameEnum in the UMM version 1.10.0 schema: https://git.earthdata.nasa.gov/projects/EMFD/repos/unified-metadata-model/browse/collection/v1.10/umm-cmn-json-schema.json#1580
UMM-CommonTilingIdentificationSystem/Coordinate1/MinimumValueNumbern/an/aYes, if applicable1
UMM-CommonTilingIdentificationSystem/Coordinate1/MaximumValueNumbern/an/aYes, if applicable1
UMM-CommonTilingIdentificationSystem/Coordinate2/MinimumValueNumbern/an/aYes, if applicable1
UMM-CommonTilingIdentificationSystem/Coordinate2/MaximumValueNumbern/an/aYes, if applicable1



Metadata Validation and QA/QC

All metadata entering the CMR goes through the below process to ensure metadata quality requirements are met. All records undergo CMR validation before entering the system. The process of QA/QC is slightly different for NASA and non-NASA data providers. Non-NASA providers include interagency and international data providers and are referred to as the International Directory Network (IDN).

Lucidchart
rich-viewerfalse
autofittrue
nameCopy of Wiki Page Metadata Evaluation Workflow-1939-51df84
width1102
pages-to-display
id98e5dc28-3252-4209-953f-66f1378e1cf4
alignLeft
height299

Please see the expandable sections below for flowchart details.


Expand
titleGCMD Metadata QA/QC
  • Manual Review
    • Check that the purpose description is appropriate for the data set.
  • Automated Review
    • Check that the field has been populated.
    • Check that the field length is not greater than 1000 characters.
Expand
titleCMR Validation

<>

Expand
titleARC Metadata QA/QC

ARC Priority Matrix

Priority CategorizationJustification

This element is categorized as highest priority when:

  • The tiling identification system name does not match an enumeration value (CALIPSO, MISR, MODIS Tile EASE, MODIS Tile SIN, WELD Alaska Tile, WELD CONUS Tile, WRS-1, WRS-2).
  • The tiling identification system provided is incorrect for the data set.

This element is categorized as medium priority when:

  • The tiling identification system name does not match an enumeration value when the metadata format is anything other than UMM-JSON (this field is not controlled in other metadata dialects).

This element is categorized as medium priority when:

  • A recommendation is made to add a tiling identification system to the metadata when appropriate.

The element is provided, and follows all applicable criteria specified in the best practices section above.

ARC Automated Rules

Dialect Mappings

Expand
titleDIF 9

DIF 9 (Note: DIF-9 is being phased out and will no longer be supported after 2018)

Expand
titleDIF 10

DIF 10

Providing a TwoD_Coordinate_System is optional. An unlimited amount of TwoD_Coordinate_Systems may be provided (Cardinality: 0..*)

UMM-C ElementDIF 10
Specification
PathTypeConstraintsRequired in DIF 10?Cardinality
DIF 10/DIF/
TilingIdentificationSystem/TilingIdentificationSystemName  Spatial_Coverage/Spatial_Info/TwoD_Coordinate_System/TwoD_Coordinate_System_Name

String


Yes, if applicable

1
DIF 10
TilingIdentificationSystem/
DIF
Coordinate1/MinimumValueSpatial_Coverage/Spatial_Info/TwoD_Coordinate_System/Coordinate1/Minimum_ValueDecimal
Yes, if applicable1
DIF 10
TilingIdentificationSystem/
DIF
Coordinate1/MaximumValueSpatial_Coverage/Spatial_Info/TwoD_Coordinate_System/Coordinate1/Maximum_ValueDecimal
Yes, if applicable1
DIF 10
TilingIdentificationSystem/
DIF
Coordinate2/MinimumValueSpatial_Coverage/Spatial_Info/TwoD_Coordinate_System/Coordinate2/Minimum_ValueDecimal
Yes, if applicable1
DIF 10
TilingIdentificationSystem/
DIF
Coordinate2/MaximumValueSpatial_Coverage/Spatial_Info/TwoD_Coordinate_System/Coordinate2/Maximum_ValueDecimal
Yes, if applicable1


Example Mapping

Section
Column
width50%

DIF 10

No Format
<Spatial_Coverage>
  <Spatial_Info>
    <TwoD_Coordinate_System>
      <TwoD_Coordinate_System_Name>MODIS Tile EASE</TwoD_Coordinate_System_Name>
      <Coordinate1>
        <Minimum_Value>0</Minimum_Value>
        <Maximum_Value>18</Maximum_Value>
      </Coordinate1>
      <Coordinate2>
        <Minimum_Value>0</Minimum_Value>
        <Maximum_Value>38</Maximum_Value>
      </Coordinate2>
    </TwoD_Coordinate_System>
  </Spatial_Info>
</Spatial_Coverage>
Column
width50%

UMM

No Format
"TilingIdentificationSystems": [
  {
    "TilingIdentificationSystemName": "MODIS Tile EASE",
    "Coordinate1": {
      "MinimumValue": 0.0,
      "MaximumValue": 18.0
    },
    "Coordinate2": {
      "MinimumValue": 0.0,
      "MaximumValue": 38.0
    }
  }
]
Expand
titleECHO 10

ECHO 10

Providing a TwoDCoordinateSystem is optional. An unlimited amount of TwoDCoordinateSystems may be provided (Cardinality: 0..*)

UMM-C ElementECHO 10
Specification
PathTypeConstraintsRequired in ECHO10?
ECHO 10/Collection/
TilingIdentificationSystem/Coordinate1TwoDCoordinateSystems/TwoDCoordinateSystem/TwoDCoordinateSystemNameString

1 - 80 characters

Yes, if applicable
ECHO 10
TilingIdentificationSystem/
Collection
Coordinate1/MinimumValueTwoDCoordinateSystems/TwoDCoordinateSystem/Coordinate1/MinimumValueDecimaln/aYes, if applicable
ECHO 10
TilingIdentificationSystem/
Collection
Coordinate1/MaximumValue TwoDCoordinateSystems/TwoDCoordinateSystem/Coordinate1/MaximumValueDecimaln/aYes, if applicable
ECHO 10
TilingIdentificationSystem/
Collection
Coordinate2/MinimumValueTwoDCoordinateSystems/TwoDCoordinateSystem/Coordinate2/MinimumValueDecimaln/aYes, if applicable
ECHO 10
TilingIdentificationSystem/
Collection
Coordinate2/MaximumValue  TwoDCoordinateSystems/TwoDCoordinateSystem/Coordinate2/MaximumValueDecimaln/aYes, if applicable


Example Mapping

Section
Column
width50%

ECHO 10

No Format
<TwoDCoordinateSystems>
  <TwoDCoordinateSystem>
    <TwoDCoordinateSystemName>MODIS Tile EASE</TwoDCoordinateSystemName>
    <Coordinate1>
      <MinimumValue>0</MinimumValue>
      <MaximumValue>18</MaximumValue>
    </Coordinate1>
    <Coordinate2>
      <MinimumValue>0</MinimumValue>
      <MaximumValue>38</MaximumValue>
    </Coordinate2>
  </TwoDCoordinateSystem>
</TwoDCoordinateSystems>
Column
width50%

UMM

No Format
"TilingIdentificationSystems": [
  {
    "TilingIdentificationSystemName": "MODIS Tile EASE",
    "Coordinate1": {
      "MinimumValue": 0.0,
      "MaximumValue": 18.0
    },
    "Coordinate2": {
      "MinimumValue": 0.0,
      "MaximumValue": 38.0
    }
  }
]
Expand
titleISO 19115-2 MENDS

ISO 19115-2 MENDS

Providing a Tiling Identification System is optional. An unlimited amount of Tiling Identification Systems may be provided (Cardinality: 0..*)

UMM-C Element

ISO 19115-2 MENDS 

Specification

Path

TypeNotes
ISO 19115-2 MENDS
TilingIdentificationSystem/TilingIdentificationSystemName 

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicIdentifier/gmd:MD_Identifier/gmd:description/gco:CharacterString

with

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent gmd:EX_Extent id="TilingIdentificationSystem"

with

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:description/gco:CharacterString="Tiling Identification System"

with

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.tilingidentificationsystem

String

Maps to the UMM element "Tiling Identification System Name".

The actual name of the tiling identification system (e.g. 'MODIS Tile SIN') goes in the first path listed. This field is not controlled in ISO, however, the UMM requires that the name be selected from a controlled enumeration list with the following options: CALIPSO, MISR, MODIS Tile EASE, MODIS Tile SIN, WELD Alaska Tile, WELD CONUS Tile, WRS-1, WRS-

2  

2.  

An EX_Extent id of "TilingIdentificationSystem" should be provided so that CMR can properly parse out the tiling identification system fields.

Similarly, a description field with the string "Tiling Identification System" should be provided,

 and the value of "gov.nasa.esdis.umm.tilingidentificationsystem" should be provided in gmd:CodeSpace field so that CMR can properly parse out the tiling identification system fields.

ISO 19115-2 MENDSThe prefix "c1
TilingIdentificationSystem/Coordinate1/MinimumValue

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString= c1-min:

String

Maps to the UMM element "TilingIdentificationSystem/Coordinate1/MinimumValue"

The prefix "c1-min: " must be provided in front of the minimum coordinate to differentiate it from the other coordinate values.

ISO 19115-2 MENDS
TilingIdentificationSystem/Coordinate1/MaximumValue/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString= c1-max:String
Maps to the UMM element "TilingIdentificationSystem/Coordinate1/MaximumValue"

The prefix "c1-max: " must be provided in front of the maximum coordinate to differentiate it from the other coordinate values.


ISO 19115-2 MENDS

 

TilingIdentificationSystem/Coordinate2/MinimumValue/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString= c2-min:String

Maps to the UMM element "TilingIdentificationSystem/Coordinate2/MinimumValue"

The prefix "c2-min: " must be provided in front of the minimum coordinate to differentiate it from the other coordinate values.


 

TilingIdentificationSystem/Coordinate2/MaximumValue
ISO 19115-2 MENDSThe prefix "
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString= c2-max:String

Maps to the UMM element "TilingIdentificationSystem/Coordinate2/MaximumValue"

The prefix "c2-max: " must be provided in front of the maximum coordinate to differentiate it from the other coordinate values. 


Example Mapping

Section
Column
width50%

ISO 19115-2 MENDS

No Format
<gmi:MI_Metadata>
  <gmd:identificationInfo>
    <gmd:MD_DataIdentification>
      <gmd:extent>
        <gmd:EX_Extent id="TilingIdentificationSystem">
          <gmd:description>
            <gco:CharacterString>Tiling Identification System</gco:CharacterString>
          </gmd:description>
          <gmd:geographicElement>
            <gmd:EX_GeographicDescription>
              <gmd:geographicIdentifier>
                <gmd:MD_Identifier>
                  <gmd:code>
                    <gco:CharacterString>c1-min: 0.0 c1-max: 18.0 c2-min: 0.0 c2-max: 38.0</gco:CharacterString>
                  </gmd:code>
                  <gmd:codeSpace>
                    <gco:CharacterString>gov.nasa.esdis.umm.tilingidentificationsystem</gco:CharacterString>
                  </gmd:codeSpace>
                </gmd:MD_Identifier>
              </gmd:geographicIdentifier>
            </gmd:EX_GeographicDescription>
          </gmd:geographicElement>
        </gmd:EX_Extent>
      </gmd:extent>
    </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
</gmi:MI_Metadata>
Column
width50%

UMM

No Format
"TilingIdentificationSystems": [
  {
    "TilingIdentificationSystemName": "MODIS Tile EASE",
    "Coordinate1": {
      "MinimumValue": 0.0,
      "MaximumValue": 18.0
    },
    "Coordinate2": {
      "MinimumValue": 0.0,
      "MaximumValue": 38.0
    }
  }
]
Expand
titleISO 19115-2 SMAP

ISO 19115-2 SMAP

Providing a Tiling Identification System is optional. An unlimited amount of Tiling Identification Systems may be provided (Cardinality: 0..*)

UMM-C Element

ISO 19115-2 SMAP 

Specification

Path

TypeNotes
ISO 19115-2 SMAPTilingIdentificationSystem/TilingIdentificationSystemName /gmd:DS_Series/gmd:seriesMetadata/

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicIdentifier/gmd:MD_Identifier/gmd:description/gco:CharacterString

with

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent gmd:EX_Extent id="TilingIdentificationSystem"

with

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:description/gco:CharacterString="Tiling Identification System"

with

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.tilingidentificationsystem

String

Maps to the UMM element "Tiling Identification System Name". The actual name of the tiling identification system (e.g. 'MODIS Tile SIN') goes in the first path listed. This field is not controlled in ISO, however, the UMM requires that the name be selected from a controlled enumeration list with the following options: CALIPSO, MISR, MODIS Tile EASE, MODIS Tile SIN, WELD Alaska Tile, WELD CONUS Tile, WRS-1, WRS-2  2.  

An EX_Extent id of "TilingIdentificationSystem" should be provided so that CMR can properly parse out the tiling identification system fields.

Similarly, a description field with the string "Tiling Identification System" should be provided, and the value of "gov.nasa.esdis.umm.tilingidentificationsystem" should be provided in gmd:CodeSpace field so that CMR can properly parse out the tiling identification system fields.

ISO 19115-2 SMAP
TilingIdentificationSystem/Coordinate1/MinimumValue/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString= c1-min:StringMaps to the UMM element "TilingIdentificationSystem/Coordinate1/MinimumValue"

The prefix "c1-min: " must be provided in front of the minimum coordinate to differentiate it from the other coordinate values.

ISO 19115-2 SMAP
TilingIdentificationSystem/Coordinate1/MinimumValue/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString= c1-max:String

Maps to the UMM element "TilingIdentificationSystem/Coordinate1/MinimumValue"

The prefix "c1-max: " must be provided in front of the maximum coordinate to differentiate it from the other coordinate values.

ISO 19115-2 SMAP
TilingIdentificationSystem/Coordinate1/MinimumValue/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString= c2-min:StringMaps to the UMM element "TilingIdentificationSystem/Coordinate1/MinimumValue"

The prefix "c2-min: " must be provided in front of the minimum coordinate to differentiate it from the other coordinate values.

ISO 19115-2 SMAP
TilingIdentificationSystem/Coordinate1/MinimumValue/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/ gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString= c2-max:String

Maps to the UMM element "TilingIdentificationSystem/Coordinate1/MinimumValue"

The prefix "c2-max: " must be provided in front of the maximum coordinate to differentiate it from the other coordinate values.


Example Mapping

Section
Column
width50%

ISO 19115-2 SMAP

No Format
<gmd:DS_Series>
<gmd:seriesMetadata>
<gmi:MI_Metadata>
  <gmd:identificationInfo>
    <gmd:MD_DataIdentification>
      <gmd:extent>
        <gmd:EX_Extent id="TilingIdentificationSystem">
          <gmd:description>
            <gco:CharacterString>Tiling Identification System</gco:CharacterString>
          </gmd:description>
          <gmd:geographicElement>
            <gmd:EX_GeographicDescription>
              <gmd:geographicIdentifier>
                <gmd:MD_Identifier>
                  <gmd:code>
                    <gco:CharacterString>c1-min: 0.0 c1-max: 18.0 c2-min: 0.0 c2-max: 38.0</gco:CharacterString>

                  </gmd:code>
                  <gmd:codeSpace>
                    <gco:CharacterString>gov.nasa.esdis.umm.tilingidentificationsystem</gco:CharacterString>
                  </gmd:codeSpace>
                </gmd:MD_Identifier>
              </gmd:geographicIdentifier>
            </gmd:EX_GeographicDescription>
          </gmd:geographicElement>
        </gmd:EX_Extent>
      </gmd:extent>
    </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
</gmi:MI_Metadata>
</gmd:seriesMetadata>
</gmd:DS_Series>
Column
width50%

UMM

No Format
"TilingIdentificationSystems": [
  {
    "TilingIdentificationSystemName": "MODIS Tile EASE",
    "Coordinate1": {
      "MinimumValue": 0.0,
      "MaximumValue": 18.0
    },
    "Coordinate2": {
      "MinimumValue": 0.0,
      "MaximumValue": 38.0
    }
  }
]

UMM Migration

UMM Version 1.9.0Translation DirectionUMM Version 1.10.0



Future Mappings

Expand
titleISO 19115-1

ISO 19115-1

Providing a

There is currently no mapping between UMM-C and ISO 19115-1 for Tiling Identification System

is optional

.

An unlimited amount of Tiling Identification Systems may be provided (Cardinality: 0..*)

UMM-C Element

ISO 19115-1 

ISO 19115-1
Specification

Path

TypeNotes/mdb:MD_Metadata/

String

Example Mapping
Tiling Identification SystemN/A

String

There is currently no mapping between UMM-C and ISO 19115-1 for Tiling Identification System.


Example Mapping

Section
Column
width
Section
Column
width50%

ISO 19115-1

No Format
<mdb:MD_Metadata>
  
</mdb:MD_Metadata>N/A
Column
width50%

UMM

No Format
"TilingIdentificationSystems": [
  {
    "TilingIdentificationSystemName": "MODIS Tile EASE",
    "Coordinate1": {
      "MinimumValue": 0.0,
      "MaximumValue": 18.0
    },
    "Coordinate2": {
      "MinimumValue": 0.0,
      "MaximumValue": 38.0
    }
  }
]N/A

History

UMM Versioning

VersionDateWhat Changed
1.12.001/22/2019No changes were made for Tiling Identification System during the transition from version 1.11.0 to 1.12.0.
1.11.011/28/2018No changes were made for Tiling Identification System during the transition from version 1.10.0 to 1.11.0.
1.10.005/02/2018

During the transition from version 1.9.0 to 1.10.0, an enumeration list was created for Tiling Identification System. Values in the enumeration include: CALIPSO, MISR, MODIS Tile EASE, MODIS Tile SIN, WELD Alaska Tile, WELD CONUS Tile, WRS-1, WRS-2.  

1.9.0

ARC Documentation

VersionDateWhat ChangedAuthor
1.010/26/18Recommendations/priority matrix transferred from internal ARC documentation to wiki spaceJeanne' le Roux