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

Code Table Request - New Taxonomy Source: IDNR List #6768

Closed
8 tasks done
Jegelewicz opened this issue Sep 26, 2023 · 23 comments
Closed
8 tasks done

Code Table Request - New Taxonomy Source: IDNR List #6768

Jegelewicz opened this issue Sep 26, 2023 · 23 comments
Assignees
Labels
Function-CodeTables Priority-High (Needed for work) High because this is causing a delay in important collection work..
Milestone

Comments

@Jegelewicz
Copy link
Member

Jegelewicz commented Sep 26, 2023

Goal

Describe what you're trying to accomplish. This is the only necessary step to start this process. The Committee is available to assist with all other steps. Please clearly indicate any uncertainty or desired guidance if you proceed beyond this step.

Track threatened/endangered species in the state of Illinois

Context

Describe why this new value is necessary and existing values are not.

This source will be updated manually any time a new IDNR threatened/endangered list is released. The single source will make that easy. It has been tested and found to be a good solution - see #5444

Table

Code Tables are http://arctos.database.museum/info/ctDocumentation.cfm. Link to the specific table or value. This may involve multiple tables and will control datatype for Attributes. OtherID requests require BaseURL (and example) or explanation. Please ask for assistance if unsure.

https://arctos.database.museum/info/ctDocumentation.cfm?table=cttaxonomy_source

Proposed Value

Proposed new value. This should be clear and compatible with similar values in the relevant table and across Arctos.

IDNR List

Proposed Definition

Clear, complete, non-collection-type-specific functional definition of the value. Avoid discipline-specific terminology if possible, include parenthetically if unavoidable.

A source that records the endangered/threatened status of species in the state of Illinois. This source is expected to only include non-classification terms and must be manually updated each time Illinois Department of Natural Resources releases a new list. This source is managed by Chicago Academy of Sciences (CHAS).

Collection type

Some code tables contain collection-type-specific values. collection_cde may be found from https://arctos.database.museum/home.cfm

N/A

Attribute Extras

Attribute data type

If the request is for an attribute, what values will be allowed?
free-text, categorical, or number+units depending upon the attribute (TBA)

N/A

Attribute controlled values

If the values are categorical (to be controlled by a code table), add a link to the appropriate code table. If a new table or set of values is needed, please elaborate.

N/A

Attribute units

if numerical values should be accompanied by units, provide a link to the appropriate units table.

N/A

Part preservation attribute affect on "tissueness"

if a new part preservation is requested, please add the affect it would have on "tissueness": No Influence, Allows, or Denies

N/A

Priority

Please describe the urgency and/or choose a priority-label to the right. You should expect a response within two working days, and may utilize Arctos Contacts if you feel response is lacking.

Example Data

Requests with clarifying sample data are generally much easier to understand and prioritize. Please attach or link to any representative data, in any form or format, which might help clarify the request.

See #5444

Available for Public View

Most data are by default publicly available. Describe any necessary access restrictions.

Yes

Helpful Actions

  • Add the issue to the Code Table Management Project.

  • Please reach out to anyone who might be affected by this change. Leave a comment or add this to the Committee agenda if you believe more focused conversation is necessary.

@ArctosDB/arctos-code-table-administrators

Approval

All of the following must be checked before this may proceed.

The How-To Document should be followed. Pay particular attention to terminology (with emphasis on consistency) and documentation (with emphasis on functionality). No person should act in multiple roles; the submitter cannot also serve as a Code Table Administrator, for example.

  • Code Table Administrator[1] - check and initial, comment, or thumbs-up to indicate that the request complies with the how-to documentation and has your approval
  • Code Table Administrator[2] - check and initial, comment, or thumbs-up to indicate that the request complies with the how-to documentation and has your approval
  • DBA - The request is functionally acceptable. The term is not a functional duplicate, and is compatible with existing data and code.
  • DBA - Appropriate code or handlers are in place as necessary. (ID_References, Media Relationships, Encumbrances, etc. require particular attention)

Rejection

If you believe this request should not proceed, explain why here. Suggest any changes that would make the change acceptable, alternate (usually existing) paths to the same goals, etc.

  1. Can a suitable solution be found here? If not, proceed to (2)
  2. Can a suitable solution be found by Code Table Committee discussion? If not, proceed to (3)
  3. Take the discussion to a monthly Arctos Working Group meeting for final resolution.

Implementation

Once all of the Approval Checklist is appropriately checked and there are no Rejection comments, or in special circumstances by decree of the Arctos Working Group, the change may be made.

  • Review everything one last time. Ensure the How-To has been followed. Ensure all checks have been made by appropriate personnel.

  • Add or revise the code table term/definition as described above. Ensure the URL of this Issue is included in the definition. URLs should be included as text, separated by spaced pipes. Do not include HTML in definitions.

Close this Issue.

DO NOT modify Arctos Authorities in any way before all points in this Issue have been fully addressed; data loss may result.

Special Exemptions

In very specific cases and by prior approval of The Committee, the approval process may be skipped, and implementation requirements may be slightly altered. Please note here if you are proceeding under one of these use cases.

  1. Adding an existing term to additional collection types may proceed immediately and without discussion, but doing so may also subject users to future cleanup efforts. If time allows, please review the term and definition as part of this step.
  2. The Committee may grant special access on particular tables to particular users. This should be exercised with great caution only after several smooth test cases, and generally limited to "taxonomy-like" data such as International Commission on Stratigraphy terminology.
@Jegelewicz Jegelewicz added Priority-High (Needed for work) High because this is causing a delay in important collection work.. Function-CodeTables labels Sep 26, 2023
@Jegelewicz Jegelewicz added this to the Needs Discussion milestone Sep 26, 2023
@Jegelewicz
Copy link
Member Author

File used to create upload once approved.

IDNR.Endangered-Threatened.List.2020(2).xlsx

@Jegelewicz Jegelewicz self-assigned this Sep 26, 2023
@Nicole-Ridgwell-NMMNHS
Copy link

Looking through the other issue, this seems like a good solution. Checking a box.

@Jegelewicz
Copy link
Member Author

@ArctosDB/arctos-code-table-administrators anyone besides Nicole willing to check a box?

@Jegelewicz
Copy link
Member Author

@ArctosDB/arctos-code-table-administrators can we PLEASE get a box checked so I can move forward with this? If there is some reason NOT to add this, please speak up.

@campmlc
Copy link

campmlc commented Nov 2, 2023

I support this - I'll check it off if no objections.

@campmlc
Copy link

campmlc commented Nov 2, 2023

Box checked.

@Jegelewicz
Copy link
Member Author

Jegelewicz commented Nov 3, 2023

The term has been added to the code table.

The following taxa were added to Arctos to accommodate the list

SCIENTIFIC_NAME

Carex cryptolepsis
Gratiola quartermaniae
Lycaeides melissa samuelis
Prostoia ozarkensis
Pygmarrhopalites madonnensis
Symphoricarpos albus var. albus

The following taxa are misspelled in the IDNR list and the classification will be associated with the Arctos taxon:

IDNR SCIENTIFIC_NAME STATUS ARCTOS_NAME
Fundulus diaphanus subsp. menona spelling Fundulus diaphanus menona
Hyloteliphium telephioides spelling Hylotelephium telephioides
Lathryus ochroleucus spelling Lathyrus ochroleucus

@Jegelewicz
Copy link
Member Author

Jegelewicz commented Nov 3, 2023

Waiting for new source to show in the code table, then will upload classifications which are in the classification bulkload tool.

@Jegelewicz
Copy link
Member Author

@dustymc I was trying to use the new metadata in https://arctos.database.museum/info/ctDocumentation.cfm?table=cttaxonomy_source

And I added "Arctos Classification Bulkloader" to the new IDNR List source - which gets me this in the bulkload classification tool:

image

Please 'splain me what I did wrong!

@Jegelewicz
Copy link
Member Author

OOOH - maybe because I wasn't an authorized editor? I changed it - let's see if that works....

@dustymc
Copy link
Contributor

dustymc commented Nov 3, 2023

I changed it

Thx, was a headscratcher....

The check is cached, give it an hour.

@Jegelewicz
Copy link
Member Author

OK they loaded, but trying to search by the source gives me a weird error (and maybe I am not doing it correctly)

Search parameters

collection: CHAS:Mamm,CHAS:Bird
taxon term: %
type or rank: idnr_status
source: IDNR List

Error:

image

Trying to get all of the records for those collections that are identified as something with a term in the IDNR List source.

@Jegelewicz
Copy link
Member Author

Above is sorta equivalent to what we did in test - #5444 (comment)

@Jegelewicz
Copy link
Member Author

Question - does the collection need to using the source for this to work? I just tried again, not logged in using Chrome and I get

image

@dustymc
Copy link
Contributor

dustymc commented Nov 3, 2023

And #6311 but this still seems to confuse people, maybe we need a video or some sort of something??

@dustymc
Copy link
Contributor

dustymc commented Nov 3, 2023

does the collection need to using the source

Nope, and wouldn't be much reason to pull globalnames if that was necessary.

Screenshot 2023-11-03 at 12 25 21

@Jegelewicz
Copy link
Member Author

But with your shareable link it works...

image

However in your shared link the term looks like this ( a crazy little underscore) - why not a %

image

@Jegelewicz
Copy link
Member Author

This is really nice if we can un-confuse the % vs _ thing. CHAS can find all of their state endangered stuff:

https://arctos.database.museum/search.cfm?guid_prefix=CHAS%3ABird%2CCHAS%3AMamm&tax_trm_1=_&tax_rnk_1=idnr_status&tax_src_1=IDNR%20List

image

@Jegelewicz
Copy link
Member Author

I was just following instructions...

image

@dustymc
Copy link
Contributor

dustymc commented Nov 3, 2023

why not a %

File an issue - I think it should probably be that source OR term OR value OR any/all do stuff, but IDK if that's affordable or desirable or ??

instructions

Include that too, I can change the placeholder, you can change the help text, that's accurate except when it's prefixing nothing....

@Jegelewicz
Copy link
Member Author

New issue - #6923

Added for demo at next AWG meeting.

@wellerjes @droberts49 this is now functional for you in production!

https://arctos.database.museum/search.cfm?guid_prefix=CHAS%3ABird%2CCHAS%3AMamm&tax_trm_1=_&tax_rnk_1=idnr_status&tax_src_1=IDNR%20List

Closing.

@wellerjes
Copy link

Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Function-CodeTables Priority-High (Needed for work) High because this is causing a delay in important collection work..
Projects
None yet
Development

No branches or pull requests

5 participants