Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve definition for GBIF-field 'species' based in GbifTerm #90

Open
CecSve opened this issue May 27, 2024 · 1 comment
Open

Improve definition for GBIF-field 'species' based in GbifTerm #90

CecSve opened this issue May 27, 2024 · 1 comment
Assignees
Labels
Using Data Issues relating to enhancing the 'Using data' section of the technical documentation

Comments

@CecSve
Copy link
Contributor

CecSve commented May 27, 2024

Feedback on Occurrence download formats (Github source for this page)

In the simple download table, the definition of species is somewhat limited and for all ranks it is just repeated. Ideally, the species column definition should be updated to correspond to the GbifTerm:

The canonical name without authorship of the accepted species.

Instead of the generic:

The species name (excluding authorship) for the species from the GBIF backbone matched to this occurrence.

Or at least it should be clear that it is the accepted species name.

The table is not editable in the tech docs repo and seems to link to a source I cannot find

# Fetch species list format download terms
write_description_table(GBIF_API + '/occurrence/download/describe/speciesList',
                        lambda x : x['fields'],
                        'speciesList',
                        True,
                        output+"/download-species-list-terms-table.adoc",
                        text_types)
@CecSve CecSve added the Using Data Issues relating to enhancing the 'Using data' section of the technical documentation label May 27, 2024
@MattBlissett
Copy link
Member

The source for this is Occurrence.java in the gbif-api project, as it's drawn from the API definitions.

I'll align GbifTerm and Occurrence later, they ought to be consistent for all terms.

@MattBlissett MattBlissett self-assigned this May 30, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Using Data Issues relating to enhancing the 'Using data' section of the technical documentation
Projects
None yet
Development

No branches or pull requests

2 participants