DF_WFdiskusage

DF_WFdiskusage — List and graph weekly disk usage

Synopsis

DF_WFdiskusage {study} [-a] [-r] [-g #] [-f week] [-l week]

Description

This report lists and graphs, in chronological order, the total and average disk usage by week for study CRF images.

DF_WFdiskusage lists and graphs disk usage by week. For each week, the week number, the number of Kbytes of disk used, and a histogram representation of the Kbytes used, is displayed. Weeks in which there was no disk usage are never displayed, but they can influence the calculation of the average as described below.

Summary statistics, including the total number of Kbytes, the average number of Kbytes per week, and the minimum and maximum Kbytes, are presented after the histogram. The minimum and maximum usage weeks are also indicated on the histogram by the abbreviations min and max respectively. In the case where more than one week has the minimum or maximum usage, only the first such week is indicated. Weeks in which there was no disk space used are excluded from the minimum calculation. Zero usage weeks are also excluded from the calculation of the average Kbytes used per week, unless -a is given. If -a is given, the total number of weeks considered in the average calculation is the number of weeks between the first and last week inclusive. Otherwise, only those weeks with non-zero usage are counted, which is the default.

Study weeks are specified with a yyww notation where yy is the 2-digit year of the century and ww is the 2-digit week of the year. By default, the range of weeks begins with the first week that a fax image was received and ends with the last week that an image was received. If -a is given, the last week is taken as the current week. These defaults can be overridden by specifying either or both of -f and -l.

By default, weeks are listed in chronological order, least recent first. If -r is specified, weeks are listed in reverse chronological order, most recent first.

Scaling of the graph can be overridden with -g. The value specifies the number of Kbytes represented by each * character. By default, the scaling factor is calculated to achieve full use of an 80-column page.

Options

-a

Include all weeks in the calculation of the mean, including those weeks for which no CRFs were received

-r

Display weeks in reverse chronological order (most recent week first)

-g #

Set graphics scaling to one * per # Kbytes

-f week

Include only weeks on or after the specified week

-l week

Include only weeks before or on the specified week

Examples

Example 2.122.  Display, in reverse chronological order, the disk usage for study weeks from the current week back through the first week of 2017.

-f 0001 -r
DF_WFdiskusage: Disk Space Used Per Week.         DFstudy 65. Nov 27,2017 15:50

Disk usage from week 201701 to 201746 inclusive

Yr   Wk       Kb      Each * represents 300 Kb
                      +---------+---------+---------+---------+-------
2017 46:          2456|********
2017 42:            43|min
2017 41:           493|*
2017 40:          5587|******************
2017 34:          1248|****
2017 33:           586|*
2017 32:          2442|********
2017 28:           508|*
2017 27:         14136|***********************************************max
2017 24:          2456|********
2017 23:          5981|*******************
2017 22:          1417|****
2017 21:          4645|***************
2017 20:          2355|*******
2017 19:          1529|*****
2017 17:          1196|***
2017 16:          1926|******
2017 15:          4251|**************
2017 14:          6350|*********************
2017 11:           461|*
2017 07:           165|
2017 06:           914|***
2017 03:          1488|****
2017 01:          1126|***
                      +---------+---------+---------+---------+-------

Total:  63759 Kbytes in 24 weeks
 Mean:  2657 Kbytes per week
  Min:  43 Kbytes (week 201742)
  Max:  14136 Kbytes (week 201727)

Example 2.123. Display, the disk usage from the 34th week of 1999 to the 34th week of 2017, inclusive

-f 9934 -l 0034
DF_WFdiskusage: Disk Space Used Per Week.         DFstudy 65. Nov 27,2017 15:52

Disk usage from week 201649 to 201734 inclusive

Yr   Wk       Kb      Each * represents 300 Kb
                      +---------+---------+---------+---------+-------
2016 49:          2521|********
2016 50:          2164|*******
2017 01:          1126|***
2017 03:          1488|****
2017 06:           914|***
2017 07:           165|min
2017 11:           461|*
2017 14:          6350|*********************
2017 15:          4251|**************
2017 16:          1926|******
2017 17:          1196|***
2017 19:          1529|*****
2017 20:          2355|*******
2017 21:          4645|***************
2017 22:          1417|****
2017 23:          5981|*******************
2017 24:          2456|********
2017 27:         14136|***********************************************max
2017 28:           508|*
2017 32:          2442|********
2017 33:           586|*
2017 34:          1248|****
                      +---------+---------+---------+---------+-------

Total:  59865 Kbytes in 22 weeks
 Mean:  2721 Kbytes per week
  Min:  165 Kbytes (week 201707)
  Max:  14136 Kbytes (week 201727)

Note how the start of the range was automatically moved forward to the 49th week of 2016 as a result of their being no received documents before that.