Accumulation of suppressed elements by net level
Quick reference
To control how small suppression elements are counted with smsup+ in tables of nets, use netsm and nonetsm on the a, sectbeg, flt, tab or l statement.
To have net levels honored so that an smsup+ element contains only suppressed elements for that element’s level, use netsm. To ignore net levels and include suppressed elements in the next element with smsup+, use nonetsm.
When all cells in an element are less than a given value, Quantum can suppress that element and, optionally, add the suppressed values into the corresponding cells of another element. The options which define the value below which figures will be suppressed are smsupa, smsupp and smsupt. smcol and smrow determine whether small suppression is required for rows, columns, or both.
The option which marks the row into which suppressed elements are added is smsup+. If this option is not present, suppressed elements do not appear in the table at all.
▪For information about all the
sm options (except
smsup+), see
Output options.
When an element definition includes smsup+, Quantum adds into it not only the records which satisfy the element’s condition, but also any previous elements which have been suppressed since the start of the table, the most recent base, or the most recent element with smsup+.
The same principle applies to tables of nets. For example:
l netaxis;c=numb(c232,233).gt.0
n10Base
net1Color (Net)
n01Green;c=c232'1'
n01Yellow;c=c232'2'
net2Red (Net)
n01Scarlet;c=c232'3'
n01Vermillion;c=c232'4'
n01Crimson;c=c232'5'
n01Other reds;c=c232'6';smsup+
net2Blue (Net)
n01Navy;c=c232'7'
n01Royal;c=c232'8'
n01Sky;c=c232'9'
n01Other blues;c=c232'0';endnet2;smsup+
n01Other colors;c=c233'-&';endnet1;smsup+
n01Other comments;c=c233n' '
Each net and subnet ends with an element for shades not mentioned specifically in the net. These elements include smsup+ so that any elements suppressed in that net will be added into the cell counts for these elements. However, if you create a table with this axis as it is here, you’ll find that Quantum takes no account of the net levels and adds suppressed elements into the next element with smsup+. Thus, if the Green or Yellow elements are suppressed, they will be added into the element for Other Reds which is not what is required. They will not be included in the Other Colors element which is where you’d expect them to go.
When you use nets and smsup+ together, you should also use one of the options netsm or nonetsm to indicate how you want Quantum to deal with suppressed elements. These options can be used on a/sectbeg/tab/flt/l statements, but the option on the l statement overrides options on any of the other statements.
With netsm, Quantum honors the different net levels and only includes suppressed elements in an smsup+ element at the appropriate level. In the example above, Other reds include records which have c232’6’ and any suppressed red elements; Other blues include records which have c232’0’ and any suppressed blue elements; Other colors include records with c233’-&’ and also Green or Yellow if they are suppressed. With nonetsm, Quantum ignores the net levels when placing suppressed elements in smsup+ rows.
See also