help histogram

histogram [...]

Provides a simple histogram distribution of player integer attributes. Output of the graph is controlled by switches, listed below with example values.

Switches with string values:

-attr=skill.combat : Use this attribute's value for the histogram. Must be an integer attribute.

Switches with integer values:

-min=1 : Don't show any values below this threshold in the histogram.
-max=250 : Don't show any values above this threshold in the histogram.
-default=0 : If a player lacks the request attribute, use this default value instead. By default, these players are skipped.
-bucketwidth=10 : The size of each histogram bin or bucket.
-minrank=4 : Don't consider players with a "level" attribute below the given value.
-maxrank=23 : Don't consider players with a "level" attribute above the given value.
-ticks=10 ; Colour every nth entry in a bin differently.

Switches with no values:

-percentages : Show bucket sizes as a percentage of the total number of players in the graph, instead of the actual count of players in that bucket.
-countall : For percentages, show percentage of entire player population, not just the players entered in the graph.
-reverse : Show the histogram from highest bucket value to lowest. Defaults to lowest-to-heighest order.
-cumulative : Each bucket is shown as the total value of the contents of that bucket plus all preceding buckets.

Be aware that the rank restrictions are a little unreliable... "level" attributes are no updated when mission point requirements change, so players who have not been on for a while will have invalid ranks. Checking ranks also involves running an additional slightly time consuming check on each player.

Some example outputs:

>histogram histogram -attr=skill.combat -min=0 -max=250 -default=0
(shows the combat skill of all players, giving players missing a skill with a default value of zero. No-one with a skill level greater than 250 is counted)

>histogram -attr=skill.combat -min=0 -max=250 -default=0 -cumulative -percentages
(shows a density function graph with the %age of all players who have equal to or less than the skill level in each bucket)

>histogram -attr=$cash -min=0 -max=5000 -default=0 -bucketwidth=200 -ticks=10
(shows the cash holdings of each player with under 5000 credits to hand, in buckets of 200 credits to keep the graph size down, with a mark for each 10 players in a bin)

>histogram -attr=timeon -min=86400 -max=31536000 -default=0 -bucketwidth=864000
(shows a histogram of players who have been connected to the mud for at least a day but not more than a year, with 10-day-wide buckets)

See also:
multistat