DF_WFcrfsperwk — List and graph incoming fax traffic
DF_WFcrfsperwk
{study}
{
[-f #]
| [-f all]
| [-l #]
| [-l all]
| [-t yyyyww~yyyyww]
| [-t all]
}
[-g #]
[-data file]
[-delay #]
This report lists and graphs the average number of fax pages received per week.
The report counts all CRF and Query Report pages that arrive by fax during a
specified time period, which is required.
The time period must be specified using only one of
-f,-l or -t option.
Report output that includes all weeks of the study is specified with the
keyword all, as in
-f all, -l all or -t all.
The arrival week for a fax page is determined from the DFdiscover image name
which is in the format yyww where yy
is the 2-digit year of the century and ww is the
2-digit week
[7]
of the year.
For example, 1701 represents the 1st week of 2017,
1801 the 1st week of 2018, and
1501 the 1st week of 2015.
The report includes all primary and secondary pages for all plates (including the returned Query Report plate), plus pages that have not yet been validated.
Only weeks during which documents were received are listed and graphed. If the number of weeks counted with new fax entries is less than the number of weeks requested, the mean number of pages per week is shown based on both the number of weeks requested and the number of weeks actually found.
Remember that weeks are calculated in 7 day increments from the first day of each year. As a result of this, studies which start or end in the first or last week of a year may report proportionately fewer documents received than the average number of documents per week.
To count pages received in the first few weeks of the study, use
-f.
The report considers the year and week of the first ICRed record in the journal
files as the first week of the study.
It is possible for this to be the wrong value, if at the start of the
study, documents collect in the new image queue and the first fax to be validated
is not one of the documents that arrived in the first week of the study.
If this situation is suspected, use -t to explicitly set
the date range to count pages that arrived in earlier weeks.
When -l is used to count pages received in the last
few weeks, the current week from the computer system clock is used as the last
week of the time period.
However, the report only counts complete 7 day weeks
and so the current week will typically not be included in the report listing
as it is unlikely (1 in 7 chance) that the current day is also the last day
of a complete week.
To write the results to a data file, in addition to the usual screen output,
use -data.
In such a case, the first line written to the specified output file identifies
the column headings
Year|Week|Pages
and the data follows on subsequent lines, where | delimits the
columns of each line.
Choosing this option does not suppress the usual screen output.
-f | Select the first # weeks (from the first fax received), or all weeks |
-l | Select the last # weeks (counting the current week as the last week), or all weeks |
-t yyyyww~yyyyww, -t all | Select all weeks in the specified range of weeks, inclusive, or all weeks of the study |
-g # | In the text-only mode, set the graphics scaling to one displayed
In the html mode, set the maximum value of x-axis to be #
(default = the largest number of CRFs transmitted per week).
To avoid decimal numbers in x-axis, it will be rounded up
to the closest number which can be divided by 5 or 10.
If |
-data file | Write data values used for graphing to the specified file. The filename must be supplied as an absolute pathname. The report output still appears as usual. |
-delay # | Specify the maximum delay in validating new records (default=999999) |
Example 2.121. Summarize the fax traffic for the last 10 weeks
-l 10
DF_WFcrfsperwk: CRF Pages Received Per Week. DFstudy 65. Nov 27,2017 15:24
CRF PAGES RECEIVED PER WEEK FOR STUDY #65 Demo Study
INCLUDING ALL CRF PAGES RECEIVED TO DATE
2017:40 253 *************************
2017:41 20 **
2017:42 2
2017:46 106 ***********
Total 381 pages in 10 weeks requested but 4 weeks found
Mean 38 pages per week requested
Mean 95 pages per week found
Each * represents 10 pages (after rounding to the nearest 10 pages).
The documents that arrive in one week may only appear in the journal of a
subsequent month.
This can occur if pages sit in the unidentified router for a while before
being processed.
The report thus processes all of the journals starting at the beginning
of the date range,
looking for records that were processed by the ICR software in the
time period specified.
This will potentially degrade the performance of the report as it searches
journal files beyond the end of the time period.
The -delay option can be used to limit how far past the end
of the date range is searched, gaining back some of the speed of the report.
[7] Within DFdiscover, weeks are 7 day periods beginning on the the first day of the year. The 52nd week of the year thus ends on day 364(7x52). Faxes arriving on day 365 (or 366 on leap years) have image names ending in 53. In this report pages arriving in week 53 are added to week 52, resulting in week 52 reporting 8 or 9 days of fax arrivals.