GROUPS are user-defined groups of model
objects, for instance groups of water bodies or groups of boundary
inputs. Groups are used a number of places in DSM2, including: tracking
of constituents originated from grouped sources, tracking of particles as they reside or move between
groups of water bodies and/or boundaries, and assignment of rate
coefficients in QUAL to groups of water bodies. In each context, the types of model
objects that are allowed in the groups may be slightly different. That
validation takes place elsewhere in the object using the group.
The GROUP table defines the name of a group. It has one column!!!
The reason we do this is to provide a top level table for overriding
and redefining groups in the layering system.
- Name of the group. This is the identifier for the group used
in references elsewhere in the input system.
- Include Block:
The Group Members Table lists members of the parent group.
The group members are identified using patterns written
using regular expression and a special syntax for ranges of numbers.
If this sounds like nonsense -- don't worry. The examples should cover
most of the important ways you would want to define group members. Note
also that you can use multiple rows to define the group -- the result
will be the union of the members from the individual rows.
- The type (channel, etc)
of model object.
- A pattern that will be
matched against the identifier of the object (channel number, input
name, etc). The pattern can be a regular expression or use the special
range notation. Here are some examples:
- Matches any number in this range, inclusive
- Dot-star is a wildcard
matches any name that starts with dicu_drn)
- Exact name
- A choice of number
- A choice of names.
- The regular expression way of doing ranges, which
works for a single digit
- Parent Table:
- Parent Identifier:
- Include Block:
- A regular expressions description can be found in wikipedia and a tutorial and guide can be found at http://www.regular-expressions.info/.
You can probably do most of the group matching you want by modifying
the above sample patterns, but the possibilities are endless.