As treecript gathers timeseries of metrics, the first, naïve approach,
has been describing each one of the metrics of each one of the sampling events,
using next classes.
flowchart LR
A[ActivateAction]
P[PropertyValue]
E[EventSeries]
I["`InstantaneousEvent
Event`"]
O[OrganizeAction]
S[SoftwareApplication]
C[ControlAction]
H[HowToStep]
click A href "https://schema.org/ActivateAction" "ActivateAction" _blank
click P href "https://schema.org/PropertyValue" "PropertyValue" _blank
click E href "https://schema.org/EventSeries" "EventSeries" _blank
click I href "https://schema.org/InstantaneousEvent" "InstantaneousEvent" _blank
click O href "https://schema.org/OrganizeAction" "OrganizeAction" _blank
click S href "https://schema.org/SoftwareApplication" "SoftwareApplication" _blank
click C href "https://schema.org/ControlAction" "ControlAction" _blank
click H href "https://schema.org/HowToStep" "HowToStep" _blank
A -->|resourceUsage| P
A -->|subjectOf| E
A -->|instrument| S
E --> |about| A
E -->|subEvent+| I
I -->|superEvent| E
I -->|source| A
I -->|data+| P
O -->|result| A
O -->|instrument| S
O -->|object*| C
C -->|object| A
C -->|instrument| H
H -->|workExample| S
- Each process execution is described by an ActivateAction entity (WRROC uses CreateAction).
- An OrganizeAction entity points to both the ActivateAction and the SoftwareApplication describing the execution itself.
- Subprocesses are described through ControlAction entities, which point to the ActivateAction entity from the child process.
- The OrganizeAction entity of the parent process points to each one of the ControlAction entities of the children processes.
- Also, each ControlAction entity points to a HowToStep entity, which points to the very same SoftwareApplication entity used for the related ActivateAction and OrganizeAction entities.
- The ActivateAction points through subjectOf to an EventSeries entity, which points to as many InstantatenousEvent entities as samples were gathered through the execution for that process.
- Each InstantatenousEvent points to each one of the gathered metrics values (along with their semantic definition) , and it identifies when the metrics values were gathered.
The description of the metrics using PropertyValue uses next ontological terms and units:
"PID": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#pid",
"unitCode": None,
"additionalType": "Integer",
},
"Virt": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#virt",
"unitCode": "http://qudt.org/vocab/unit/BYTE",
"additionalType": "Integer",
},
"Res": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#res",
"unitCode": "http://qudt.org/vocab/unit/BYTE",
"additionalType": "Integer",
},
"CPU": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#cpu",
"unitCode": "http://qudt.org/vocab/unit/PERCENT",
"additionalType": "Float",
},
"Memory": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#memory",
"unitCode": "http://qudt.org/vocab/unit/PERCENT",
"additionalType": "Float",
},
"TCP Connections": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#tcp_connections",
"unitCode": "http://qudt.org/vocab/unit/CountingUnit",
"additionalType": "Integer",
},
"Thread Count": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#thread_count",
"unitCode": "http://qudt.org/vocab/unit/CountingUnit",
"additionalType": "Integer",
},
"User": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#user",
"unitCode": "http://qudt.org/vocab/unit/SEC",
"additionalType": "Float",
},
"System": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#system",
"unitCode": "http://qudt.org/vocab/unit/SEC",
"additionalType": "Float",
},
"Children_User": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#children_user",
"unitCode": "http://qudt.org/vocab/unit/SEC",
"additionalType": "Float",
},
"Children_System": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#children_system",
"unitCode": "http://qudt.org/vocab/unit/SEC",
"additionalType": "Float",
},
"IO": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#io",
"unitCode": "http://qudt.org/vocab/unit/SEC",
"additionalType": "Float",
},
"uss": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#uss",
"unitCode": "http://qudt.org/vocab/unit/BYTE",
"additionalType": "Integer",
},
"swap": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#swap",
"unitCode": "http://qudt.org/vocab/unit/BYTE",
"additionalType": "Integer",
},
"processor_num": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#processor_num",
"unitCode": "http://qudt.org/vocab/unit/CountingUnit",
"additionalType": "Integer",
},
"core_num": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#core_num",
"unitCode": "http://qudt.org/vocab/unit/CountingUnit",
"additionalType": "Integer",
},
"cpu_num": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#cpu_num",
"unitCode": "http://qudt.org/vocab/unit/CountingUnit",
"additionalType": "Integer",
},
"processor_ids": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#processor_ids",
"unitCode": None,
"additionalType": "String",
},
"core_ids": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#core_ids",
"unitCode": None,
"additionalType": "String",
},
"cpu_ids": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#cpu_ids",
"unitCode": None,
"additionalType": "String",
},
"process_status": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#process_status",
"unitCode": None,
"additionalType": "String",
},
"read_count": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#read_count",
"unitCode": "http://qudt.org/vocab/unit/CountingUnit",
"additionalType": "Integer",
},
"write_count": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#write_count",
"unitCode": "http://qudt.org/vocab/unit/CountingUnit",
"additionalType": "Integer",
},
"read_bytes": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#read_bytes",
"unitCode": "http://qudt.org/vocab/unit/BYTE",
"additionalType": "Integer",
},
"write_bytes": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#write_bytes",
"unitCode": "http://qudt.org/vocab/unit/BYTE",
"additionalType": "Integer",
},
"read_chars": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#read_chars",
"unitCode": "http://qudt.org/vocab/unit/BYTE",
"additionalType": "Integer",
},
"write_chars": {
"propertyID": "https://w3id.org/ro/terms/treecript-metrics#write_chars",
"unitCode": "http://qudt.org/vocab/unit/BYTE",
"additionalType": "Integer",
},but this approach generates an RO-Crate 100-fold the size of the original CSV files with the metrics.
You can try the translation first installing treecript, capturing metrics from an execution and then translating gathered metrics to RO-Crate.
python3 -mvenv TREECRIPT
TREECRIPT/bin/pip install --upgrade pip wheel
TREECRIPT/bin/pip install 'treecript [analytics,docker] @ git+https://github.com/inab/treecript.git@exec'
source TREECRIPT/bin/activate
# Let's try with an example from the source distribution
# the generated RO-Crate weights more than 670MB!!!
git clone https://github.com/inab/treecript.git
python -m treecript.rocrate --as-directory /tmp/rocrate_as_directory treecript/sample-series/Wetlab2Variations_metrics/2025_05_20-02_19-14001/