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