Skip to content

Main content

Artifact Use Annotation Count Tool

Calculate artifact use annotation count from explicit caller-supplied inputs.

Loading tool…

Description

Count use annotations for one artifact ID.

Cultural source records can encode exact tokens, voices, time offsets and context budgets. Their literal structure can be summarized without determining authorship, cultural meaning, source authority or adequacy of interpretation.

Count use annotations for one artifact ID.

When to use this tool

Use Artifact Use Annotation Count when checking a supplied source-context or annotation convention.

How to use the tool and how it works

  1. Enter artifactId, artifactIds, useTokens. Keep parallel arrays aligned. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read annotations, distinctUses. Use the output convention below.

Count use annotations for one artifact ID. Require aligned artifactIds/useTokens; count matching records and distinct associated use strings.1

Input fieldMeaning and unitsAccepted input
artifactIdArtifact IdRequired. Text; maximum UTF-16 length 8192.
artifactIdsArtifact IdsRequired. Array of text; maximum UTF-16 length 8192; maximum items 256.
useTokensUse TokensRequired. Array of text; maximum UTF-16 length 8192; maximum items 256.
Output fieldInterpretationReturned shape
annotationsAnnotationsRequired. Safe integer.
distinctUsesDistinct UsesRequired. Safe integer.
json
{
  "input": {
    "artifactId": "A",
    "artifactIds": [
      "A",
      "B",
      "A"
    ],
    "useTokens": [
      "use1",
      "use2",
      "use1"
    ]
  },
  "output": {
    "annotations": 2,
    "distinctUses": 1
  }
}

Limitations and assumptions

  • No artifact identity, cultural use, representativeness or authorization is independently established.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.

Alternative or Complementary methods

Review the actual sources and relevant participant or community context for substantive interpretation and attribution.

References

  1. Calculation and input contract: cultural-anthropology/artifact-use-annotation-count — tool.io

Similar or alternative tools