Difference between revisions of "IRStats"

From EPrints Documentation
Jump to: navigation, search
(Advanced Report Generation (get_view2 params))
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
[[Category:IRStats]]
 
[[Category:IRStats]]
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.
+
<div style="border: 2px solid red; background-color: yellow;padding:10px">This is IRStats 1 documentation. IRStats 1 is now out of support. You may have been looking for [[IRStats2]]</div>
 +
 
 +
IRStats is a flexible statistics package which allows easy processing of accesses to fulltext documents of eprints. It can be downloaded from the [http://files.eprints.org/722/ Eprints File repository]. For more detailed information, please see the [[IRStats Technical Documentation]], though it is now somewhat out of date.
  
 
== The front end ==
 
== The front end ==
Line 33: Line 35:
 
| IRS_datechoice || period, range || Controls whether the 6 date range parameters or the single period parameter is used.
 
| IRS_datechoice || period, range || Controls whether the 6 date range parameters or the single period parameter is used.
 
|-
 
|-
| 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>
+
| period || -[X]m, Q[Z][YYYY] || Used when IRS_datechoice=period.<br/>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!  
+
| start_day, start_month, start_year, end_day, end_month, end_year || integers (1-31, 1-12, four digit respectively) || Used when IRS_datechoice=range.<br/> 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.
 
| 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).
+
| eprint || [eprintid] || Used when IRS_epchoice=EPrint.<br/>Any 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.
+
| [set_id]s || [set_id]_[set_member_code] || Used when IRS_epchoice=[set_id].<br/> 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.
 
|-
 
|-
 
| view || [view classname] || The classname of the IRStats::View perl module.
 
| view || [view classname] || The classname of the IRStats::View perl module.

Revision as of 10:14, 13 December 2017

This is IRStats 1 documentation. IRStats 1 is now out of support. You may have been looking for IRStats2

IRStats is a flexible statistics package which allows easy processing of accesses to fulltext documents of eprints. It can be downloaded from the Eprints File repository. 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)

The following will help if you wish to create queries by setting the CGI parameters by hand.

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 is used.
period -[X]m, Q[Z][YYYY] Used when IRS_datechoice=period.
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) Used when IRS_datechoice=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=EPrint.
Any valid eprint ID (integer).
[set_id]s [set_id]_[set_member_code] Used when IRS_epchoice=[set_id].
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.
view [view classname] The classname of the IRStats::View perl module.

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.