{% extends "popularity/base.html"%} {% block css %} {{ block.super }} {% endblock css %} {% block js_include %} {{ block.super }} {% endblock js_include %} {% block sub_title %} {{ block.super }}

Popularity API Documentation

{% endblock sub_title %} {% block caption %} {% endblock caption %} {% block body_content %} {{block.super}}
getDSdata
Method GET
Description Return a JSON for the n most popular datasets in a specified time window.
For every dataset, the popularity (measured by a specified metric) is provided for the full length of its lifetime.

Takes the following arguments:
- sitename (e.g. T2_IT_Pisa. Default: 'summary' for the overall view)
- tstart (Default: one week ago)
- tstop (Default: today)
- aggr (Default: day. Accepted values: day, week, month, quarter, year )
- n (define how many elements to return, e.g. '5' for 5 first most popular)
- orderby (define the popularity metric. Default: totcpu. Accepted values: totcpu, naccess, nusers)
Examples 1. Retrieve the list of 5 most popular datasets by total cpu time:
/popdb/popularity/getDSdata?&tstart=2012-6-27&tstop=2012-7-5&n=5&aggr=day&orderby=totcpu

2. Retrieve the list for a given site (e.g. T2_IT_Pisa):
/popdb/popularity/getDSdata?&tstart=2012-6-27&tstop=2012-7-5&sitename=T2_IT_Pisa&n=5&aggr=day&orderby=totcpu
getDTdata
Method GET
Description Return a JSON for the n most popular datatiers in a specified time window.
For every datatier, the popularity (measured by a specified metric) is provided for the full length of its lifetime.

Takes the following arguments:
- sitename (e.g. T2_IT_Pisa. Default: 'summary' for the overall view)
- tstart (Default: one week ago)
- tstop (Default: today)
- aggr (Default: day. Accepted values: day, week, month, quarter, year )
- n (define how many elements to return, e.g. '5' for 5 first most popular)
- orderby (define the popularity metric. Default: totcpu. Accepted values: totcpu, naccess, nusers)
Examples 1. Retrieve the list of 5 most popular datatiers by total cpu time:
/popdb/popularity/getDTdata?&tstart=2012-6-27&tstop=2012-7-5&n=5&aggr=day&orderby=totcpu

2. Retrieve the list for a given site (e.g. T0_CH_CERN):
/popdb/popularity/getDTdata?&tstart=2012-6-27&tstop=2012-7-5&sitename=T0_CH_CERN&n=5&aggr=day&orderby=totcpu
getDSNdata
Method GET
Description Return a JSON with the list of the most popular processed datasets in a specified time window.
For every dataset, the popularity (measured by a specified metric) is provided for the full length of its lifetime.

Takes the following arguments:
- sitename (e.g. T2_IT_Pisa. Default: 'summary' for the overall view)
- tstart (Default: one week ago)
- tstop (Default: today)
- aggr (Default: day. Accepted values: day, week, month, quarter, year )
- n (define how many elements to return, e.g. '5' for 5 first most popular)
- orderby (define the popularity metric. Default: totcpu. Accepted values: totcpu, naccess, nusers)
Examples 1. Retrieve the list of 5 most popular processed datasets by total cpu time:
/popdb/popularity/getDSNdata?&tstart=2012-6-27&tstop=2012-7-5&n=5&aggr=day&orderby=totcpu

2. Retrieve the list for a given site (e.g. T0_CH_CERN):
/popdb/popularity/getDSNdata?&tstart=2012-6-27&tstop=2012-7-5&sitename=T0_CH_CERN&n=5&aggr=day&orderby=totcpu
getSingleDSstat
Method GET
Description Return a JSON with the popularity of a dataset. The popularity (measured by a specified metric) is provided for the full length of the dataset lifetime.

Takes the following arguments:
- sitename (e.g. T2_IT_Pisa. Default: 'summary' for the overall view)
- aggr (Default: day. Accepted values: day, week, month, quarter, year )
- orderby (define the popularity metric. Default: totcpu. Accepted values: totcpu, naccess, nusers)
Examples 1. Total cpu time values for dataset /DYJetsToLL_M-50_TuneZ2Star_8TeV-madgraph-tarball/Summer12-PU_S7_START52_V9-v2/AODSIM:
/popdb/popularity/getSingleDSstat?orderby=totcpu&name=/DYJetsToLL_M-50_TuneZ2Star_8TeV-madgraph-tarball/Summer12-PU_S7_START52_V9-v2/AODSIM
getSingleDTstat
Method GET
Description Return a JSON with the popularity of a datatier. The popularity (measured by a specified metric) is provided for the full length of the datatier lifetime.

Takes the following arguments:
- sitename (e.g. T2_IT_Pisa. Default: 'summary' for the overall view)
- aggr (Default: day. Accepted values: day, week, month, quarter, year )
- orderby (define the popularity metric. Default: totcpu. Accepted values: totcpu, naccess, nusers)
Examples 1. Total cpu time values for datatier ALCARECO:
popdb/popularity/getSingleDTstat?orderby=totcpu&name=ALCARECO
getSingleDNstat
Method GET
Description Return a JSON with the popularity of a processed dataset. The popularity (measured by a specified metric) is provided for the full length of the processed dataset lifetime.

Takes the following arguments:
- sitename (e.g. T2_IT_Pisa. Default: 'summary' for the overall view)
- aggr (Default: day. Accepted values: day, week, month, quarter, year )
- orderby (define the popularity metric. Default: totcpu. Accepted values: totcpu, naccess, nusers)
Examples 1. Total cpu time values for processed dataset:
/popdb/popularity/getSingleDNstat?orderby=totcpu&name=Summer12-PU_S7_START52_V9-v1
DSStatInTimeWindow
Method GET
Description Return a JSON with the popularity of all datasets in terms of number of Accesses, CPU time and Users per day, in a specific time window.

Takes the following arguments:
- sitename (e.g. T2_IT_Pisa. Default: 'summary' for the overall view)
- tstart (Default: one week ago)
- tstop (Default: today)
Examples 1. Datasets popularity values for the week from 2012-6-26 to 2012-7-3 in site T2_IT_Pisa:
/popdb/popularity/DSStatInTimeWindow/?&tstart=2012-6-26&tstop=2012-7-3&sitename=T2_IT_Pisa
DataTierStatInTimeWindow
Method GET
Description Return a JSON with the popularity of all datatiers in terms of number of Accesses, CPU time and Users per day, in a specific time window.

Takes the following arguments:
- sitename (e.g. T2_IT_Pisa. Default: 'summary' for the overall view)
- tstart (Default: one week ago)
- tstop (Default: today)
Examples 1. Datatiers popularity values for the week from 2012-6-26 to 2012-7-3 in site T2_IT_Pisa:
/popdb/popularity/DataTierStatInTimeWindow/?&tstart=2012-6-26&tstop=2012-7-3&sitename=T2_IT_Pisa
DSNameStatInTimeWindow
Method GET
Description Return a JSON with the popularity of all processed datasets in terms of number of Accesses, CPU time and Users per day, in a specific time window.

Takes the following arguments:
- sitename (e.g. T2_IT_Pisa. Default: 'summary' for the overall view)
- tstart (Default: one week ago)
- tstop (Default: today)
Examples 1. Processed datasets popularity values for the week from 2012-6-26 to 2012-7-3 in site T2_IT_Pisa:
/popdb/popularity/DSNameStatInTimeWindow/?&tstart=2012-6-26&tstop=2012-7-3&sitename=T2_IT_Pisa
getUserStat
Method GET
Description Return a JSON with user activity statistics on a given datatier in a specified time window. The statistics are provided in terms of number of Accesses, CPU time and Sites accessed.

Takes the following arguments:
- collname (specify the datatier for witch collect the user statistics e.g. 'GEN-SIM'. Default: 'AOD')
- tstart (Default: one week ago)
- tstop (Default: today)
- orderby (Default: totcpu)
Examples 1. Users statistics releted to AOD datatier for the week from 2012-6-26 to 2012-7-3:
/popdb/popularity/getUserStat/?collname=AOD&tstart=2012-6-26&tstop=2012-7-3
getCorruptedFiles
Method GET
Description Return a JSON with the list of files (per site) that ALWAYS failed in job accesses in the last 10 days

Takes the following arguments:
- sitename (Default: summary for the overall view)
- orderby (Default: totcpu)
Examples 1. Overall view of corrupted files:
/popdb/popularity/getCorruptedFiles/

2. Corrupted files on site T2_IT_Pisa:
/popdb/popularity/getCorruptedFiles/?sitename=T2_IT_Pisa
{% endblock body_content%}