Name

features — defines a collection of feature attributes

Synopsis

Content Model


	    <features> = attribute +, attributes +. 

	    

Attributes

NameTypeDefault
   

Description

The features element contains a collection of attributes that are used to represent extant values (existing values that can be measured, such as standing volume, equivalent habitat area, hydrologic capacity). In Patchworks a feature can be defined as 'what's on the ground'.

The features element encloses a collection of attributes or attribute sets that describe the behaviour of the stand that satisfies the selection. A features element always occurs within a select element, and indicates that the attributes that follow apply only to the query statement attribute for the select element.

Features can occur for both managed and unmanaged stands. Features can also be assigned to retained portions of managed areas (see retention).

Parents

These elements contain features: select , retention.

Children

The following elements can occur in features: attribute , attributes .

Attributes

no attributes exist

See also

products, attribute , attributes , curve , retention.

Examples

In the following example two attribute sets and two attribute curves are in a collection of feature attributes.

[Note]Note

An important capability of attribute labels is the availability of the substitution symbols '%f' and '%m'. The '%f' symbol is substituted for 'feature' if wrapped by a feature element, or 'product' if wrapped by a product element. The '%m' symbol is replaced with 'managed' if applied to a managed stand, and 'unmanaged' if applied to an unmanaged stand. This capability can be used to reduce the repetition of attribute sets and curves when both features and products have the same values, or when the same attributes apply to managed and unmanaged stand condition. These attributes could be defined in an attributes element, and then referenced elsewhere as required.

  <select statement="FU eq 'PWST' and SILVINT eq 'Prsnt'">
    <features>
      <attributes idref="Habitat.754.PWST" />
      <attributes idref="Seral" />
      <attribute label="%f.Area.%m.PWST">
        <curve>
          <point x="0.0" y="1.0" />
        </curve>
      </attribute>
      <attribute label="%f.Origin.%m.Prsnt">
        <curve>
          <point x="0.0" y="1.0" />
        </curve>
      </attribute>
    </features>
  </select>
	  

In this example the features element is enclosed within a <retention> element. In this example, 6% of the matching area has the IFM field reclassified as 'retained'. Feature attributes added to the retained stand type in addition to all other feature sections that are matched by select blocks. 75% of the retained area (0.06*0.75) is applied to the 'feature.Retention.ByPass' attribute, and 25% (0.06*0.25) of the retained area is applied to the 'feature.Retention.Riparian' attribute. For more information see retention.

 <select statement="MU eq '754' and FU eq 'PWST' and IFM in managed">
    <retention factor="0.06">
      <assign field="IFM" value="retained" />
      <features>
        <attribute label="feature.Retention.ByPass">
          <curve>
            <point x="0.0" y="0.75" />
          </curve>
        </attribute>
        <attribute label="feature.Retention.Riparian">
          <curve>
            <point x="0.0" y="0.25" />
          </curve>
        </attribute>
      </features>
    </retention>
 </select>