conditor

Présentation

Ce plugin est propose une série d'instructions pour traiter (aligner les affiliations avec le RNSR), requêter les documents de l'API Conditor.

installation

npm install @ezs/core
npm install @ezs/conditor

Scripts

$ ./bin/affAlign.js < data/1000-notices-conditor-hal.json | ./bin/compareRnsr.js
recall: 0.7104885057471264
correct: 989
total: 1392

Warning: to use the scripts, you need to install @ezs/basics too.

Règles certaines

Les règles certaines utilisées par affAlign, appliquées à l'adresse de l'affiliation à aligner sont les suivantes:

• le code_postal ou la ville_postale de la structure doivent être présents,
• et pour au moins une des tutelles (etabAssoc.*.etab, et etabAssoc.*.etab.natTutEtab vaut TUTE):
  • soit etabAssoc.*.etab.sigle ou le etabAssoc.*.etab.libelle sont présents,
  • soit etabAssoc.*.etab.libelle commence par Université et le etabAssoc.*.etab.libelle est présent (mais pas le etabAssoc.*.etab.sigle).
• et on trouve la bonne structure:
  • soit etabAssoc.*.label et etabAssoc.*.numero sont présents proches et en séquence (ex: GDR2945, GDR 2945 ou GDR mot 2945),
  • soit sigle est présent,
  • soit intitule est présent.
• et la structure existait lors de la publication: une des xPublicationDate est entre annee_creation et l'éventuelle an_fermeture.

Sachant qu'on appauvrit (casse, accents, tiret, apostrophe) tous les champs.

usage

Table of Contents

• affAlign
• compareRnsr
• conditorScroll
• getRnsr

affAlign

Find the RNSR identifiers in the authors affiliation addresses.

Input file:

[{
     "xPublicationDate": ["2012-01-01", "2012-01-01"],
     "authors": [{
         "affiliations": [{
             "address": "GDR 2989 Université Versailles Saint-Quentin-en-Yvelines, 63009"
         }]
     }]
}]

Script:

[use]
plugin = basics
plugin = conditor

[JSONParse]
[affAlign]
[JSONString]
indent = true

Output:

[{
     "xPublicationDate": ["2012-01-01", "2012-01-01"],
     "authors": [{
         "affiliations": [{
             "address": "GDR 2989 Université Versailles Saint-Quentin-en-Yvelines, 63009",
             "conditorRnsr": ["200619958X"]
         }]
     }]
}]

Parameters

• year number? Year of the RNSR to use instead of the last one

compareRnsr

Take Conditor JSON documents and compute the recall of authors.affiliations.conditorRnsr in relation to authors.affiliations.rnsr.

Examples

Input

[{
     "authors": [{
         "affiliations": [{
             "address": "GDR 2989 Université Versailles Saint-Quentin-en-Yvelines, 63009",
             "rnsr": ["200619958X"],
             "conditorRnsr": ["200619958X"]
         }]
     }]
}]

Output

{
     "correct": 1,
     "total": 1,
     "recall": 1
}

conditorScroll

Use scroll to return all results from Conditor API.

:warning: you have to put a valid token into a .env file, under CONDITOR_TOKEN variable:

CONDITOR_TOKEN=eyJhbG...

Parameters

• q string query (optional, default "")
• scroll string duration of the scroll (optional, default "5m")
• page_size number size of the pages (optional, default 1000)
• max_page number maximum number of pages (optional, default 1000000)
• includes string fields to get in the response
• excludes string fields to exclude from the response
• sid string User-agent identifier (optional, default "ezs-conditor")
• progress boolean display a progress bar in stderr (optional, default false)

Examples

Input

{
  "q": "Test",
  "page_size": 1,
  "max_page": 1,
  "includes": "sourceUid"
}

Output

[[
    {
        "sourceUid": "hal$hal-01412764",
        "_score": 5.634469,
        "_sort": [
            0
        ]
    }
]]

Returns Array<object>

getRnsr

Find the RNSR identifier(s) matching the address and the publication year of an article.

Get objects with an id field and a value field.

The value field is an object containing address and year.

Returns an object with id and value fields. The value is an array of RNSR identifiers (if any).

Input:

[{
  "id": 1,
  "value": {
    "address": "GDR 2989 Université Versailles Saint-Quentin-en-Yvelines, 63009",
    "year": "2012"
  }
}]

Output:

[{ "id": 1, "value": ["200619958X"] }]

Parameters

• year number? Year of the RNSR to use instead of the last one