Name

package — defines a treatment package composed of a sequence of treatments

Synopsis

Content Model


	    <package> = EMPTY

	    

Attributes

NameTypeDefault
labelAn expression that evaluates to the name of the package treatment. 
sequenceAn expression that evaluates the sequence of treatments (in addition to the enclosing treatment) that makes up the package. 
manualexprAn expression that evaluates to 'Managed', 'Unmanaged' or '' to indicate if the treatment allows manual or automated scheduling.''

Description

The package element defines a sequence of treatments that should be applied as a single package. When the package is applied the initial treatment and the remaining treatments in the sequence are also applied automatically. This package treatment will be available for the stands that match to the enclosing select query statement. The enclosing treatment (the parent element of this package element) is not otherwise modified and is still available as an individual treatment.

The package always starts with the first treatment being the enclosing treatment that the package has been defined within. Subsequent treatments in the sequence are specified by the sequence attribute.

The the name of the treatment is provided by evaluating the expression provided by the label attribute. If the expression evaluates to '' (the empty string) then the package will not be defined. Since this is an expression, literal values must be enclosed in single quotes (e.g. 'TMT1').

The sequence attribute provides an expression that will calculate the names of the remaining treatments within the sequence along with the years of delay between treatments. Each remaining treatment in the sequence is specified in the format

  Treatment@Delay

Since this is an expression, literal values must be enclosed in single quotes. Multiple treatments are separated using a | character. For example

  'FCut@15|LCut@15'

specifies that the FCut treatment would occur after a 15 year delay from the time of the enclosing treatment, then the LCut treatment would occur after another 15 year delay.

The manualexpr attribute may be used to control if the package treatment will be available for scheduling or not. The meaning of this field is the same as the manualexpr field of the treatment element.

Note that the enclosing treatment (the parent element) is available as an unpackaged treatment. A manual flag may be specified on the parent treatment in order to prevent the parent from being available to the scheduler, but still allowing the package treatment to be available. The package will make copies of the treatments that are in the sequence, and they will have the same automatic/manual scheduling characteristics as the package treatment.

Parents

These elements contain package: treatment.

Children

The following elements can occur in produce: assign.

Attributes

label

The name to be given to the treatment. This name must be unique within the treatments that have already been assigned to the stand record. For example, if a treatment has already be defined as SCut, then the package label cannot be SCut.

manualexpr

An expression that evaluates to '', 'managed' or 'unmanaged'. If the empty string ('') then the treatment will be available for automatic scheduling. If 'managed' then the treatment will not be available for automatic scheduling, but may be assigned manually. If unmanaged then the treatment may be manually assigned to unmanaged stands.

See Also

treatment, assign

Examples

The following example demonstrates how shelterwood silviculture could be modeled as a package.

                                                           (1)
  <select statement="FU eq 'OR1_A' and IFM in managed and 
            SILVINT in 'Prsnt,Regrowth'">
    <track>
      <treatment label="SCut" minage="60" adjust="R" retain="5" manualexpr="'Managed'">
        <produce>
          <assign field="treatment" value="'SCut'" />
        </produce>
        <transition>
          <assign field="SILVINT" value="'SCut'" />        (2)
        </transition>
        <package label="tmt1" sequence="'FCut@15|LCut@15'" />
      </treatment>
    </track>
  </select>
  <select statement="FU eq 'OR1_A' and IFM in managed and SILVINT eq 'SCut'">
    <track>                                                (3)
      <treatment label="FCut" minage="65" adjust="R" retain="15">
        <produce>
          <assign field="treatment" value="'FCut'" />
        </produce>
        <transition>
          <assign field="SILVINT" value="'FCut'" />
        </transition>
      </treatment>
    </track>
  </select>
  <select statement="FU eq 'OR1_A' and IFM in managed and SILVINT eq 'Basc1'">
    <track>                                                (4)
      <treatment label="LCut" minage="80" offset="25">
        <produce>
          <assign field="treatment" value="'LCut'" />
        </produce>
        <transition>
          <assign field="SILVINT" value="'Regrowth'" />
        </transition>
      </treatment>
    </track>
  </select>
       

In this example there are three treatments (SCut, FCut and LCut) that occur in sequence.

1

Only stands that have a Prsnt or Regrowth SILVINT code are eligible for the SCut treatment

3

If the SCut is applied, then the SILVINT code is changed to SCut and the stand is then available for an FCut treatment

4

After the FCut is applied the SILVINT code changes to FCut, and the stand becomes eligible for the LCut treatment

After the LCut treatment is applied the SILVINT code changes to Regrowth, and the stand is once again eligible for the SCut treatment (after it grows old enough).

2

The package element defines a new treatment named 'tmt1'. The sequence of treatments in this package consists of the parent treatment (SCut), followed by an FCut treatment after a 15 year delay, followed by and LCut treatment after a further 15 year delay.

The original SCut treatment has been defined with manualexpr="'Managed'". As a result the SCut treatment will not be scheduled by itself. However the tmt1 treatment that includes the sequence of SCut, FCut and LCut can be scheduled as a complete package.