2.2.4.2.2.15 MiningStructure

This complex type MAY<91> represent a mining structure.

   <xsd:complexType name="MiningStructure">
     <xsd:all>
       <!--These elements are common to each MajorObject-->
       <xsd:element name="Name"  type="xsd:string" />
       <xsd:element name="ID"  type="xsd:string" minOccurs="0" />
       <xsd:element name="CreatedTimestamp" type="xsd:dateTime" minOccurs="0" />
       <xsd:element name="LastSchemaUpdate" type="xsd:dateTime" minOccurs="0" />
       <xsd:element name="Description" type="xsd:string" minOccurs="0" />
       <xsd:element name="Annotations"  minOccurs="0" >
         <xsd:complexType>
           <xsd:sequence>
             <xsd:element name="Annotation" type="Annotation" minOccurs="0"
                          maxOccurs="unbounded" />
           </xsd:sequence>
         </xsd:complexType>
       </xsd:element>
       <!--Extended elements for MiningStructure object-->
       <xsd:element name="Source" type="Binding" minOccurs="0" />
       <xsd:element name="LastProcessed" type="xsd:dateTime" minOccurs="0"/>
       <xsd:element name="Translations" minOccurs="0">
         <xsd:complexType>
           <xsd:sequence>
             <xsd:element name="Translation"  type="Translation" minOccurs="0"
                          maxOccurs="unbounded"/>
           </xsd:sequence>
         </xsd:complexType>
       </xsd:element>
       <xsd:element name="Language" type="xsd:integer" minOccurs="0"/>
       <xsd:element name="Collation" type="xsd:string" minOccurs="0"/>
       <xsd:element name="ErrorConfiguration" type="ErrorConfiguration"
                    minOccurs="0" />
       <xsd:element name="CacheMode" minOccurs="0" >
         <xsd:simpleType>
           <xsd:restriction base="xsd:string" >
             <xsd:enumeration value="KeepTrainingCases" />
             <xsd:enumeration value="ClearAfterProcessing" />
           </xsd:restriction>
         </xsd:simpleType>
       </xsd:element>
       <xsd:element ref="eng100_100:HoldoutMaxPercent" minOccurs="0" />
       <xsd:element ref="eng100_100:HoldoutMaxCases" minOccurs="0" />
       <xsd:element ref="eng100_100:HoldoutSeed" minOccurs="0" />
       <xsd:element ref="eng100_100:HoldoutActualSize" minOccurs="0" />
       <xsd:element name="Columns" >
         <xsd:complexType>
           <xsd:sequence>
             <xsd:element name="Column"  type="MiningStructureColumn"
                          minOccurs="1" maxOccurs="unbounded"/>
           </xsd:sequence>
         </xsd:complexType>
       </xsd:element>
       <xsd:element name="State" minOccurs="0">
         <xsd:simpleType>
           <xsd:restriction base="xsd:string" >
             <xsd:enumeration value="Processed" />
             <xsd:enumeration value="Unprocessed" />
           </xsd:restriction>
         </xsd:simpleType>
       </xsd:element>
       <xsd:element name="MiningStructurePermissions" minOccurs="0">
         <xsd:complexType>
           <xsd:sequence>
             <xsd:element name="MiningStructurePermission"
                          type="MiningStructurePermission" minOccurs="0"
                          maxOccurs="unbounded"/>
           </xsd:sequence>
         </xsd:complexType>
       </xsd:element>
       <xsd:element name="MiningModels" minOccurs="0">
         <xsd:complexType>
           <xsd:sequence>
             <xsd:element name="MiningModel"  type="MiningModel"
                          minOccurs="0" maxOccurs="unbounded"/>
           </xsd:sequence>
         </xsd:complexType>
       </xsd:element>
     </xsd:all>
   </xsd:complexType>

The MiningStructure XSD depends upon element definitions in namespaces other than the default namespace. The following elements are defined in the namespace eng100_100:

   <xsd:element name="HoldoutMaxPercent" type="xsd:int" />
   <xsd:element name="HoldoutMaxCases" type="xsd:int" />
   <xsd:element name="HoldoutSeed" type="xsd:int" />
   <xsd:element name="HoldoutActualSize" type="xsd:int" />

The following table describes the elements that are included in the XSD schema for MiningStructure. Those elements common to all major objects are described in section 2.2.4.2.2.1.

Element

Read-Only

Default value

Description

Source

Empty

The source for the MiningStructure data. Source is of type "Binding". One of the following derived classes MUST be used: DataSourceViewBinding, DimensionBinding, or CubeDimensionBinding. If DimensionBinding or CubeDimensionBinding is used, then the DataSourceID for DimensionBinding and CubeDimensionBinding MUST indicate an OLAP source.

LastProcessed

Yes

The date and time when the mining structure was last processed.

Translations

Empty

A collection of Translation objects.

Language

Empty

The LCID of the language to use by default. See [MS-LCID] for information about LCIDs. If empty, the server will determine the language to use.<92>

Collation

Empty

The collation of this MiningStructure.

ErrorConfiguration

Empty

Error configuration settings to deal with issues in the source data.

CacheMode

"KeepTrainingCases"

Determines caching mechanism for training data retrieved during mining structure processing.

HoldoutMaxPercent

Zero

An integer value between 0 and 99 that specifies the maximum percentage of the cases that are to be held out as the test set. The remaining cases become the training data set.

Zero indicates no limit.

HoldoutMaxCases

Zero

An integer value equal to or greater than zero that specifies the maximum number of cases that are to be held out as the test set. The remaining cases become the training data set.

Zero indicates no limit. If not zero, then the lowest of (HoldoutMaxCases, HoldoutMaxPercent) is used.

HoldoutSeed

Zero

Used as the seed for repeatable partitioning. If unspecified or set to zero, a hash of the mining structure name is used as the seed.

HoldoutActualSize

Yes

If the mining structure is processed, this indicates the actual size of the test data set, expressed in number of cases.

Zero indicates either no test partition or that the structure is not processed.

Columns

[Required]

A collection of Column objects of type MiningStructureColumn.

State

Yes

The state of processing of the object.

MiningStructurePermissions

Empty

A collection of MiningStructurePermission objects. Each MiningStructurePermission defines the permissions a role has on this MiningStructure.

MiningModels

Empty

A collection of MiningModel objects.