Name

adjustWeightsRelative — This script will adjust the weight values so that the accounts will compete against each other in an equitable manner.

Syntax

void adjustWeightsRelative ( String benchmark , String [ ] patterns ) 

The command has the following arguments:

benchmark

The name of the account that will set the benchmark. All other accounts will be adjusted relative to this account.

patterns

An array of strings, each of which is a glob-style pattern. All accounts matching all patterns will have their weights adjusted so that they are equitable relative to the weights of the benchmark account.

Description

This script will adjust the weight values so that the accounts will compete against each other in an equitable manner.

Usage: adjustWeightsRelative("product.Yield.managed.PJ", 
             new String[] {"product.Yield.managed.*"});

The first argument identifies the 'benchmark' account. The second argument is a pattern that identifies the accounts that should be adjusted. The accounts identified in the second argument will have their weights altered so that they are correct proportional to the target levels that are set.

This script works very effectively when the accounts being adjusted are options to an exclusive account. The relative weight adjustment will guide the scheduler to split any shortfall proportional to requirements.

For example, consider a harvest volume exclusive account has options to send 200,000 m3 to one account and 5,000 m3 to another, but only 200,000 m3 available. Using equal weights the scheduler will split the shortfall between the targets in equal amounts, so both would get 5,000 less than they needed. Using relative weighting the scheduler will split the shortfall in equal proportions, so each will have their allocation reduced by 5%.

After running this script, you may find that the targets that have been adjusted are 'out of balance' with respect to other active targets. An iterative adjustment process may be necessary to get all weights in balance. This process can be facilitated by using the Performance Table to compare objective values between targets.