Skip to content

Class: LogEntry

A PROV-aligned provenance record stored on GeoJSON features. Contains activity identity, timestamp, generator information, input/output references, execution duration, and tuning annotations.

URI: debrief:class/LogEntry

 classDiagram
    class LogEntry
    click LogEntry href "../../classes/LogEntry/"
      LogEntry : activity_id

      LogEntry : disabled

      LogEntry : execution_duration

      LogEntry : generated

      LogEntry : generated_result_id

      LogEntry : input_state





        LogEntry --> "*" InputFeatureState : input_state
        click InputFeatureState href "../../classes/InputFeatureState/"



      LogEntry : rationale

      LogEntry : timestamp

      LogEntry : tune





        LogEntry --> "0..1" TuneAnnotation : tune
        click TuneAnnotation href "../../classes/TuneAnnotation/"



      LogEntry : used

      LogEntry : was_generated_by





        LogEntry --> "1" WasGeneratedBy : was_generated_by
        click WasGeneratedBy href "../../classes/WasGeneratedBy/"




Slots

Name Cardinality and Range Description Inheritance
activity_id 1
String
Unique operation identifier (UUID v4) direct
timestamp 1
datetime
When the operation occurred (ISO 8601 with timezone) direct
was_generated_by 1
WasGeneratedBy
Tool identity and parameters for this invocation direct
used 1..*
String
Feature IDs of inputs direct
generated 1..*
String
Feature IDs or versioned asset paths of outputs direct
execution_duration 1
String
Wall-clock execution time in ISO 8601 duration format (e direct
generated_result_id 0..1
String
Stable logical identity for artifact-producing tools direct
tune 0..1
TuneAnnotation
Parameter tuning record direct
input_state *
InputFeatureState
Pre-operation feature states for coordinate-mutating tools direct
disabled 0..1
Boolean
Whether this entry is skipped during replay direct
rationale 0..1
String
Free-text analyst annotation explaining the reasoning for this operation direct

Usages

used by used in type used
BaseFeatureProperties provenance range LogEntry
TrackProperties provenance range LogEntry
ReferenceLocationProperties provenance range LogEntry
SystemStateProperties provenance range LogEntry
MultiPointFeatureProperties provenance range LogEntry
MultiPolygonFeatureProperties provenance range LogEntry
NarrativeEntryProperties provenance range LogEntry
CircleAnnotationProperties provenance range LogEntry
RectangleAnnotationProperties provenance range LogEntry
LineAnnotationProperties provenance range LogEntry
TextAnnotationProperties provenance range LogEntry
VectorAnnotationProperties provenance range LogEntry
PolyAnnotationProperties provenance range LogEntry

Identifier and Mapping Information

Schema Source

  • from schema: https://debrief.info/schemas/debrief

Mappings

Mapping Type Mapped Value
self debrief:LogEntry
native debrief:LogEntry

LinkML Source

Direct

name: LogEntry
description: A PROV-aligned provenance record stored on GeoJSON features. Contains
  activity identity, timestamp, generator information, input/output references, execution
  duration, and tuning annotations.
from_schema: https://debrief.info/schemas/debrief
attributes:
  activity_id:
    name: activity_id
    description: Unique operation identifier (UUID v4). Shared across features in
      multi-feature operations.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    - FileProvEntry
    range: string
    required: true
  timestamp:
    name: timestamp
    description: When the operation occurred (ISO 8601 with timezone).
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    - TuneAnnotation
    - FileProvEntry
    - FeatureSelection
    range: datetime
    required: true
  was_generated_by:
    name: was_generated_by
    description: Tool identity and parameters for this invocation.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    range: WasGeneratedBy
    required: true
  used:
    name: used
    description: Feature IDs of inputs. May be empty for operations with no explicit
      inputs.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    range: string
    required: true
    multivalued: true
  generated:
    name: generated
    description: Feature IDs or versioned asset paths of outputs. May be empty for
      in-place modifications.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    range: string
    required: true
    multivalued: true
  execution_duration:
    name: execution_duration
    description: Wall-clock execution time in ISO 8601 duration format (e.g., PT0.3S).
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    range: string
    required: true
    pattern: ^PT[0-9]+(\.[0-9]+)?S$
  generated_result_id:
    name: generated_result_id
    description: Stable logical identity for artifact-producing tools. Null for non-artifact
      tools.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    range: string
    required: false
  tune:
    name: tune
    description: Parameter tuning record. Null until a tuning operation modifies this
      entry.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    range: TuneAnnotation
    required: false
  input_state:
    name: input_state
    description: Pre-operation feature states for coordinate-mutating tools. Captures
      geometry and spatial properties as they were immediately before the operation,
      enabling correct replay with modified parameters. Null for non-mutation tools.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    range: InputFeatureState
    required: false
    multivalued: true
    inlined: true
    inlined_as_list: true
  disabled:
    name: disabled
    description: Whether this entry is skipped during replay. Toggled via the flip-card
      edit face.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    ifabsent: 'false'
    domain_of:
    - LogEntry
    range: boolean
    required: false
  rationale:
    name: rationale
    description: Free-text analyst annotation explaining the reasoning for this operation.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    domain_of:
    - LogEntry
    range: string
    required: false

Induced

name: LogEntry
description: A PROV-aligned provenance record stored on GeoJSON features. Contains
  activity identity, timestamp, generator information, input/output references, execution
  duration, and tuning annotations.
from_schema: https://debrief.info/schemas/debrief
attributes:
  activity_id:
    name: activity_id
    description: Unique operation identifier (UUID v4). Shared across features in
      multi-feature operations.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: activity_id
    owner: LogEntry
    domain_of:
    - LogEntry
    - FileProvEntry
    range: string
    required: true
  timestamp:
    name: timestamp
    description: When the operation occurred (ISO 8601 with timezone).
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: timestamp
    owner: LogEntry
    domain_of:
    - LogEntry
    - TuneAnnotation
    - FileProvEntry
    - FeatureSelection
    range: datetime
    required: true
  was_generated_by:
    name: was_generated_by
    description: Tool identity and parameters for this invocation.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: was_generated_by
    owner: LogEntry
    domain_of:
    - LogEntry
    range: WasGeneratedBy
    required: true
  used:
    name: used
    description: Feature IDs of inputs. May be empty for operations with no explicit
      inputs.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: used
    owner: LogEntry
    domain_of:
    - LogEntry
    range: string
    required: true
    multivalued: true
  generated:
    name: generated
    description: Feature IDs or versioned asset paths of outputs. May be empty for
      in-place modifications.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: generated
    owner: LogEntry
    domain_of:
    - LogEntry
    range: string
    required: true
    multivalued: true
  execution_duration:
    name: execution_duration
    description: Wall-clock execution time in ISO 8601 duration format (e.g., PT0.3S).
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: execution_duration
    owner: LogEntry
    domain_of:
    - LogEntry
    range: string
    required: true
    pattern: ^PT[0-9]+(\.[0-9]+)?S$
  generated_result_id:
    name: generated_result_id
    description: Stable logical identity for artifact-producing tools. Null for non-artifact
      tools.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: generated_result_id
    owner: LogEntry
    domain_of:
    - LogEntry
    range: string
    required: false
  tune:
    name: tune
    description: Parameter tuning record. Null until a tuning operation modifies this
      entry.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: tune
    owner: LogEntry
    domain_of:
    - LogEntry
    range: TuneAnnotation
    required: false
  input_state:
    name: input_state
    description: Pre-operation feature states for coordinate-mutating tools. Captures
      geometry and spatial properties as they were immediately before the operation,
      enabling correct replay with modified parameters. Null for non-mutation tools.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: input_state
    owner: LogEntry
    domain_of:
    - LogEntry
    range: InputFeatureState
    required: false
    multivalued: true
    inlined: true
    inlined_as_list: true
  disabled:
    name: disabled
    description: Whether this entry is skipped during replay. Toggled via the flip-card
      edit face.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    ifabsent: 'false'
    alias: disabled
    owner: LogEntry
    domain_of:
    - LogEntry
    range: boolean
    required: false
  rationale:
    name: rationale
    description: Free-text analyst annotation explaining the reasoning for this operation.
    from_schema: https://debrief.info/schemas/log-entry
    rank: 1000
    alias: rationale
    owner: LogEntry
    domain_of:
    - LogEntry
    range: string
    required: false