Skip to content

ASTRA

Agentic Schema for Transparent Research Analysis. A framework for defining hierarchical scientific analyses with decision points, evidence-backed insights, and universe specifications.

URI: https://w3id.org/astra/analysis

Name: analysis

Classes

Class Description
Analysis A self-similar analysis specification
Decision A decision point in the analysis
DecisionSelection A mapping from a decision ID to the selected option ID
Evidence Evidence from a source with W3C-compliant selectors
FragmentSelector W3C FragmentSelector for PDF locations
Input An input to the analysis
Insight A unit of scientific knowledge backed by evidence
InsightCollection Collection of insights, usable standalone or embedded in an analysis
KeyValuePair A key-value string pair
Option An option for a decision point
Output An expected output from the analysis
Recipe A build rule that produces an output
Resources Compute resource requirements for a recipe
TextQuoteSelector W3C TextQuoteSelector for locating text in a document
Universe A universe specification - a complete set of decisions across the entire anal...
UniverseNode A universe node mirroring the analysis tree structure

Slots

Slot Description
analyses Nested sub-analyses (keyed by analysis ID)
artifact Output ID referencing a declared output in this analysis
claim What we learned (1-2 sentences)
command POSIX shell command to execute (e
container Container image name or path to a Containerfile
cpus CPU cores requested
created_at Creation timestamp (ISO 8601)
decision_id ID of the decision
decisions Decision IDs (in the surrounding scope) that parameterize this output
default Default option ID for baseline universes
derived True if synthesized/inferred from multiple sources
description Description of the input
disk Disk requirement as a string with units (e
doi DOI of the source paper (e
evidence Supporting evidence (papers or analysis artifacts)
exact Exact quoted text (1-3 sentences)
excluded Whether this option was considered and rejected
excluded_reason Why this option was excluded
findings Findings and conclusions from outputs (keyed by insight ID)
from Reference to a related element via a path expression
gpus Number of GPUs
id Unique identifier for the input
incompatible_with Decision
inputs IDs of upstream artifacts this output depends on
insights Insight IDs supporting this option
key The key
label Short human-readable name for compact rendering (margin glyphs, breadcrumbs, ...
location Location hint (page number for PDFs/reports)
memory Memory requirement as a string with units (e
name Human-readable name for the analysis
notes Reasoning notes
option_id ID of the selected option
options Map of option IDs to option specifications
outputs Expected outputs from this analysis
page 1-indexed page number
path Path to a directory containing its own astra
prefix ~20-100 chars before for disambiguation
prior_insights Prior insights that inform decisions (keyed by insight ID)
quote Text quote anchor
rationale Why this decision exists
recipe How to produce this output (pure how; dependencies live on the Output via `...
ref Reference to another ASTRA analysis
ref_version Version of the referenced analysis
requires Decision
resources Compute resource requirements (cpus, memory, time_limit, …)
scope Applicability conditions
snapshot Path to immutable copy of the artifact
source URI or path to the data source
source_commit Git commit that produced the original artifact
suffix ~20-100 chars after for disambiguation
tags Tags for grouping and categorizing
time_limit Maximum wall time as a duration string (e
type Type of input
universe Name of a universe in the sub-analysis's universes/ directory
use_outputs Specific outputs to use from referenced analysis
value The value
version ASTRA specification version
when Conditions for when this element is active

Enumerations

Enumeration Description
InputType Type of analysis input
OutputType Type of analysis output

Types

Type Description
Boolean A binary (true or false) value
Curie a compact URI
Date a date (year, month and day) in an idealized calendar
DateOrDatetime Either a date or a datetime
Datetime The combination of a date and time
Decimal A real number with arbitrary precision that conforms to the xsd:decimal speci...
Double A real number that conforms to the xsd:double specification
Float A real number that conforms to the xsd:float specification
Integer An integer
Jsonpath A string encoding a JSON Path
Jsonpointer A string encoding a JSON Pointer
Ncname Prefix part of CURIE
Nodeidentifier A URI, CURIE or BNODE that represents a node in a model
Objectidentifier A URI or CURIE that represents an object in the model
Sparqlpath A string encoding a SPARQL Property Path
String A character string
Time A time object represents a (local) time of day, independent of any particular...
Uri a complete URI
Uriorcurie a URI or a CURIE

Subsets

Subset Description