Difference between revisions of "IRStats"

From EPrints Documentation
Jump to: navigation, search
(The front end)
(Advanced Report Generation (get_view2 params))
Line 16: Line 16:
 
===Advanced Report Generation (get_view2 params)===
 
===Advanced Report Generation (get_view2 params)===
  
The following are the cgi parameters that can be passed to irstats.cgi?page=get_view2 in order to generate a report.
+
There are three fundamental parameters that IRStats uses. There are:
 +
* A Date Range (actually 6 parameters for day, month and year for both start and end dates)
 +
* A Set of EPrints
 +
* A View
  
 +
However, in order to add functionality, the get_view2 page will convert a larger number of parameters into these three.  The following table shows all parameters and values, with square brackets denoting variables.
  
  
 +
{| border="1"
 +
! Parameter
 +
! Possible Values
 +
! Notes
 +
|-
 +
| IRS_datechoice || period, range || Controls whether the 6 date range parameters or the single period parameter
 +
|-
 +
| period || -[X]m, Q[Z][YYYY] || Where m and Q are literal characters, X is a positive integer, Z is an integer in the range 1 to 4 and YYYY is a four digit year.<br/>Examples: <dl><dt>-4m<dd>Go back exactly four months from today's date<dt>Q32004<dd>Quarter 3, 2004</dl>
 +
|-
 +
| start_day, start_month, start_year, end_day, end_month, end_year || integers (1-31, 1-12, four digit respectively) || Values defining a date range when IRS_datechoice is set to 'range'.  Note that if a day value is higher than the highest day in the chosen month, it will be treated as the highest day -- e.g. start_day=31&start_month=02 is seen as valid and equivalent to February 28th.  Note that start_day=99 is also valid!
 +
|-
 +
| IRS_epchoice || All, EPrint, [set_id] || Controls whether stats will be generated on all eprints, a single eprints, or a set of eprints.  The 'All' option is the only one that does not require extra parameters.  Note that 'set_id' is the id of a valid set as defined in the IRStats configuration.
 +
|-
 +
| eprint || [eprintid] | Used when IRS_epchoice is set to EPrint.  An valid eprint ID (integer).
 +
|-
 +
| [set_id]s || [set_id]_[set_member_code] || Used when IRS_epchoice denotes a set to be used.  Best described through example: <dl><dt>IRS_epchoice=divisions&divisionss=divisions_art<dd>Will generate a report on the art department, given a standard EPrints repository and IRStats config, where the subject id 'art' exists in the divisions tree in EPrints.
 +
 +
 +
|}
 +
 +
{|
 +
|-
 +
Parameter || Possible Values || Notes
 +
 +
\}
  
 
===The Dashboard Form===
 
===The Dashboard Form===

Revision as of 13:29, 7 July 2011

IRStats is a flexible statistics package which allows easy processing of accesses to fulltext documents of eprints. For more detailed information, please see the IRStats Technical Documentation, though it is now somewhat out of date.

The front end

The Query Form

The main interface to IRStats is found at the following URL (given a repository base URL of myrepository.ac.uk):

myrepository.ac.uk/cgi/irstats.cgi

You will be presented with a form allowing you to select the parameters with which to generate a report.

Advanced Report Generation (get_view2 params)

There are three fundamental parameters that IRStats uses. There are:

  • A Date Range (actually 6 parameters for day, month and year for both start and end dates)
  • A Set of EPrints
  • A View

However, in order to add functionality, the get_view2 page will convert a larger number of parameters into these three. The following table shows all parameters and values, with square brackets denoting variables.


Parameter Possible Values Notes
IRS_datechoice period, range Controls whether the 6 date range parameters or the single period parameter
period -[X]m, Q[Z][YYYY] Where m and Q are literal characters, X is a positive integer, Z is an integer in the range 1 to 4 and YYYY is a four digit year.
Examples:
-4m
Go back exactly four months from today's date
Q32004
Quarter 3, 2004
start_day, start_month, start_year, end_day, end_month, end_year integers (1-31, 1-12, four digit respectively) Values defining a date range when IRS_datechoice is set to 'range'. Note that if a day value is higher than the highest day in the chosen month, it will be treated as the highest day -- e.g. start_day=31&start_month=02 is seen as valid and equivalent to February 28th. Note that start_day=99 is also valid!
IRS_epchoice All, EPrint, [set_id] Controls whether stats will be generated on all eprints, a single eprints, or a set of eprints. The 'All' option is the only one that does not require extra parameters. Note that 'set_id' is the id of a valid set as defined in the IRStats configuration.
eprint Used when IRS_epchoice is set to EPrint. An valid eprint ID (integer).
[set_id]s [set_id]_[set_member_code] Used when IRS_epchoice denotes a set to be used. Best described through example:
IRS_epchoice=divisions&divisionss=divisions_art
Will generate a report on the art department, given a standard EPrints repository and IRStats config, where the subject id 'art' exists in the divisions tree in EPrints.


Parameter || Possible Values || Notes \}

The Dashboard Form

A dashboard is a collection of reports on a single item or set of items (e.g. all items by John Smith). To access the form to generate a report, go to the url:

myrepository.ac.uk/cgi/irstats.cgi?page=db

The configuration file

Documentation to follow.