Please document the output columns of gna_verifier()

[telenskyt]

Could you please document the columns of the output of gna_verifier()? Especially those starting from currentCardinality would deserve some documentation.

Here is an example output

> x <- gna_verifier(genera) %>% as.data.frame()
> head(x)
   submittedName dataSourceId dataSourceTitleShort curation recordId  entryDate sortScore                        matchedNameID                    matchedName
1      Choloepus            1    Catalogue of Life  Curated     3NWM 2025-08-27  9.412152 90b55769-397b-55e3-8ec0-ddb3a48d5fcc        Choloepus Illiger, 1811
2       Tamandua            1    Catalogue of Life  Curated     7S99 2025-08-27  9.412152 f82e4f8d-a2d3-5399-933e-5935b1b6c9b0            Tamandua Gray, 1825
3   Myrmecophaga            1    Catalogue of Life  Curated     5WML 2025-08-27  9.412152 57c44ebe-ebdf-57c0-b656-0b0d401c2cae    Myrmecophaga Linnaeus, 1758
4     Euphractus            1    Catalogue of Life  Curated    62TG8 2025-08-27  9.412152 ee83e383-bd06-5d9b-bf2d-6a025c578a7f        Euphractus Wagler, 1830
5 Chaetophractus            1    Catalogue of Life  Curated     3LPT 2025-08-27  9.412152 f7a41f62-e49c-5f5b-ab96-9b3ed44aa186 Chaetophractus Fitzinger, 1871
6      Erinaceus            1    Catalogue of Life  Curated    62RKX 2025-08-27  9.412152 ea029984-361a-56bf-af1c-17a0e77d9ee9       Erinaceus Linnaeus, 1758
  matchedCardinality matchedCanonicalSimple matchedCanonicalFull currentRecordId                        currentNameId                    currentName currentCardinality
1                  1              Choloepus            Choloepus            3NWM 90b55769-397b-55e3-8ec0-ddb3a48d5fcc        Choloepus Illiger, 1811                  1
2                  1               Tamandua             Tamandua            7S99 f82e4f8d-a2d3-5399-933e-5935b1b6c9b0            Tamandua Gray, 1825                  1
3                  1           Myrmecophaga         Myrmecophaga            5WML 57c44ebe-ebdf-57c0-b656-0b0d401c2cae    Myrmecophaga Linnaeus, 1758                  1
4                  1             Euphractus           Euphractus           62TG8 ee83e383-bd06-5d9b-bf2d-6a025c578a7f        Euphractus Wagler, 1830                  1
5                  1         Chaetophractus       Chaetophractus            3LPT f7a41f62-e49c-5f5b-ab96-9b3ed44aa186 Chaetophractus Fitzinger, 1871                  1
6                  1              Erinaceus            Erinaceus           62RKX ea029984-361a-56bf-af1c-17a0e77d9ee9       Erinaceus Linnaeus, 1758                  1
  currentCanonicalSimple currentCanonicalFull taxonomicStatus isSynonym editDistance stemEditDistance matchType cardinalityScore infraSpecificRankScore fuzzyLessScore
1              Choloepus            Choloepus        Accepted     FALSE            0                0     Exact                1                      0              1
2               Tamandua             Tamandua        Accepted     FALSE            0                0     Exact                1                      0              1
3           Myrmecophaga         Myrmecophaga        Accepted     FALSE            0                0     Exact                1                      0              1
4             Euphractus           Euphractus        Accepted     FALSE            0                0     Exact                1                      0              1
5         Chaetophractus       Chaetophractus        Accepted     FALSE            0                0     Exact                1                      0              1
6              Erinaceus            Erinaceus        Accepted     FALSE            0                0     Exact                1                      0              1
  curatedDataScore authorMatchScore acceptedNameScore parsingQualityScore
1                1        0.1428571                 1                   1
2                1        0.1428571                 1                   1
3                1        0.1428571                 1                   1
4                1        0.1428571                 1                   1
5                1        0.1428571                 1                   1
6                1        0.1428571                 1                   1

[telenskyt]

and also would be useful to know how these columns cooperate with the other library functions.

(For example, cannot find how to use the different id columns with the sci2comm function, if it can be done, there are different ids in get_uid() or get_tsn() .... )

[zachary-foster]

These columns are from the gnverifer API output. I have not been able to find the documentation of these columns. I have asked the maintainers about it and if they get back to me with this information I will try to include it.