ArctosDB / arctos

Arctos is a museum collections management system
https://arctos.database.museum
Apache License 2.0
59 stars 13 forks source link

Code Table Request - format #7780

Open wellerjes opened 2 months ago

wellerjes commented 2 months ago

Initial Request

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.

create an attribute to record physical media

Context

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

creating new attributes that can be applicable for cultural collections and archives format is different from materials; for example: materials: nitrate film; format: 35mm

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=ctattribute_type

Proposed Value

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

format

Proposed Definition

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

The file format format, physical medium, or dimensions of the resource. http://purl.org/dc/terms/format Via https://www.dublincore.org/specifications/dublin-core/dcmi-terms/

Collection type

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

AV, ARCH, EH, Art

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)

free-text controlled vocabulary

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

Format Authority List

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.

I have an example, but it is encumbered; please let me know if you need me to change permissions to view it: https://arctos.database.museum/guid/CHAS:AV:MF-0033

Available for Public View

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

n/a

Helpful Actions

@ArctosDB/arctos-code-table-administrators @mkoo

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._

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.

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 commented 2 months ago

The DCMI link should be http://purl.org/dc/terms/format

Recommended practice is to use a controlled vocabulary where available. For example, for file formats one could use the list of Internet Media Types [MIME]. Examples of dimensions include size and duration.

Also see - https://www.archives.gov/research/catalog/lcdrg/elements/format.html?_ga=2.72662995.1170924066.1715371360-1651949987.1715371359

What How
Definition: The format of the media comprising the audiovisual materials. For example, the format of videotape can be VHS or Betamax, the format for sound recordings can be Master or Stamper Matrix, or the format for motion pictures can be Duplicate Negative Composite or Master Projection Print Composite.
Purpose: Provides information on the media format useful for reproduction, storage, equipment selection, and playback.
Relationship: This element is dependent on Media Type. Each media occurrence of the archival materials must have a media type specified to create Format.
Guidance: Choose the correct term from the Format Authority List.

With an actual list of authorities...

wellerjes commented 1 month ago

Agreed with definition above. Should I make a new request for each media type? We just need "film reel" to start with.

Jegelewicz commented 1 month ago

film reel is not in the suggested authority list.

https://www.archives.gov/research/catalog/lcdrg/authority_lists/formatlist.html

So maybe it's a bad idea to follow the DCMI?

droberts49 commented 1 month ago

@Jegelewicz @wellerjes The authority list from the National Archives will work for this attribute. We will format our data accordingly.

Nicole-Ridgwell-NMMNHS commented 1 month ago

I support this.

Jegelewicz commented 3 weeks ago

@dustymc thoughts? This will require a new code table and terms from https://www.archives.gov/research/catalog/lcdrg/authority_lists/formatlist.html can be added as special exemptions as requested.

I propose the new table be set up as follows:

term description category search terms Issue URL documentation URL
1/4 inch MAG scope note: 1/4-inch Sync Reel-to-Reel film Film: 1/4" MAG https://github.com/ArctosDB/arctos/issues/7780 https://www.archives.gov/research/catalog/lcdrg/authority_lists/formatlist.html
dustymc commented 3 weeks ago

thoughts

I would like an overview of these recently-requested apparently-related attributes. I feel like there's a real chance the next piece of the puzzle is going to change the last, so without being able to see the whole picture I'm hesitant to engage at all.

I also would like some policy-focused discussion about https://github.com/ArctosDB/arctos/discussions/6179 - I think The Community decided to NOT create dozens of very specific attributes for ranges (eg https://github.com/ArctosDB/arctos/issues/7364), this feels like EXACTLY the same sort of thing in a slightly different context. (And maybe my first request would help explain why that's wrong, if it is.)

Jegelewicz commented 3 weeks ago

If we aren't going to add any more attributes then the film (and all other non-biological) collections need to go somewhere else. Why are we accommodating 5 different "length" attributes but we can't give films 5 of their own specific things?

dustymc commented 3 weeks ago

aren't going to add any more attributes

I hope it's at least clear to everyone else that that's not in any way what I was suggesting or requesting...