...
The PITR (Patent Intelligence & Technology Report) service offers users the ability to create pivot tables of data using the Solr SOLR JSON facet API. This service is a thin layer exposing multi-dimensional reporting on appropriate fields within an IFI CLAIMS Direct specialized Solr SOLR index tst
/pitr/topn
This endpoint returns, at the least, a list of top assignees and corresponding publication counts per year and optionally, monthly within a year. Ranking is based on number of records within the most recent complete year.
Method(s) | GET | ||
---|---|---|---|
Path | /pitr/topn | ||
Parameter | Values | Description | |
@n | n=10 | Number of assignees to report, with precedence based on ranking (default: 10) | |
@min | min=1 | Minimum number of documents worthy of counting (default: 10) | |
@start | start=YYYY | Beginning year to filter (default: now() - 5 years) | |
@end | end=YYYY | Ending year to filter (default: current year) | |
@months | months=1|0 | Add monthly pivot values (default: 0) | |
@apps | apps=1|0 | Report on pre-grant publications instead of grants (default: 0) | |
@current | current=1|0 | Use current assignee instead of original (default: 0) | |
@probable | probable=1|0 | Consider probable assignees as well (default: 0) | |
@filter | filter=cpc:a61k | Any random Solr SOLR search to limit results | |
@countries | countries=US,EP,DE | Comma-delimited list of countries to report on. NoteNOTE: These these are publication countries, not countries of assignee (default: US) | |
@pivot | pivot=cpcl3 | Pivot field (any field from the PITR Solr SOLR index to generate pivot data for, computed per-assignee) | |
@pivot.mincount | pivot.mincount=1 | Minimum number of values from pivot considered worthy of counting (default: 1) | |
@pivot.limit | pivot.limit=5 | Maximum number of values to return, where precedence is given to most frequent values (default: 10) | |
@pivot.embed | pivot.embed=1|0 | Embed pivot field with years, i.e., break pivot down by both assignee and year rather than just by assignee (default: 0) |
...
Code Block | ||
---|---|---|
| ||
wget -O- -q \ --header 'x-user:x' \ --header 'x-password:y' \ 'httpshttp://cdws21.ificlaims.com/pitr/topn?n=1' |
...
Code Block | ||
---|---|---|
| ||
wget -O- -q \ --header 'x-user:x' \ --header 'x-password:y' \ 'httpshttp://cdws21.ificlaims.com/pitr/topn?n=1&months=1' |
...
Code Block | ||
---|---|---|
| ||
wget -O- -q \ --header 'x-user:x' \ --header 'x-password:y' \ 'httpshttp://cdws21.ificlaims.com/pitr/topn?n=1&pivot=cpcl3&pivot.embed=1&pivot.limit=3' |
...
Example: Filtering report on distinct criteria
This example requests will request the top 2 assignees who publish in the F16L CPC area (PIPES; JOINTS OR FITTINGS FOR PIPES; SUPPORTS FOR PIPES, CABLES OR PROTECTIVE TUBING; MEANS FOR THERMAL INSULATION IN GENERAL) concentrating on E03B (Water supply installations). Note, the @min parameter is reduced to 1 (default being 10) to satisfy this narrow search field.
Code Block | ||
---|---|---|
| ||
wget -O- -q \ --header 'x-user:x' \ --header 'x-password:y' \ 'httpshttp://cdws21.ificlaims.com/pitr/topn?n=2&filter=cpcl3:(F16L AND E03B)&min=1' |
...