Merge pull request #136 from casework/start_relationship_visualization

Add proof of concept script and framework for Relationship illustration

.pre-commit-config.yaml

@@ -1,5 +1,5 @@
 repos:
--   repo: https://github.com/pre-commit/pre-commit-hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v4.4.0
     hooks:
     -   id: check-json
@@ -9,3 +9,18 @@ repos:
             - --indent=4
             - --no-ensure-ascii
             - --no-sort-keys
+  - repo: https://github.com/psf/black
+    rev: 23.9.1
+    hooks:
+      - id: black
+  - repo: https://github.com/pycqa/flake8
+    rev: 6.1.0
+    hooks:
+      - id: flake8
+        args:
+          - --extend-ignore=E203,E501
+  - repo: https://github.com/pycqa/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+        name: isort (python)

README.md

@@ -9,27 +9,28 @@ Further illustration can be found at the [CASE narratives gallery](https://caseo
 
 Mapping notes & respective JSON-LD output:
 
-- [Accounts](examples/illustrations/accounts/accounts.json)
+- [Accounts](examples/illustrations/accounts/accounts.json) ([*info*](examples/illustrations/accounts/))
 - [Analysis](examples/illustrations/analysis/analysis.json) ([*info*](examples/illustrations/analysis/))
 - [Bulk Extractor Forensic Path](examples/illustrations/bulk_extractor_forensic_path/bulk_extractor_forensic_path.json) (*[info](examples/illustrations/bulk_extractor_forensic_path/)*)
 - [Call Log](examples/illustrations/call_log/call_log.json)
 - [Cell Site](examples/illustrations/cell_site/cell_site.json) ([*info*](examples/illustrations/cell_site/))
 - [Configured Tool](examples/illustrations/configured_tool/configured_tool.json)
+- [Database records](examples/illustrations/database_records/database_records.json) ([*info*](examples/illustrations/database_records/))
 - [Device](examples/illustrations/device/device.json)
 - [EXIF Data](examples/illustrations/exif_data/exif_data.json)
 - [Event](examples/illustrations/event/event.json)
 - [Files](examples/illustrations/file/file.json) (*[info](examples/illustrations/file/)*)
-- [Forensic Lifecycle](examples/illustrations/forensic_lifecycle/forensic_lifecycle.json)
+- [Forensic Lifecycle](examples/illustrations/forensic_lifecycle/forensic_lifecycle.json) ([*info*](examples/illustrations/forensic_lifecycle/))
 - [Location](examples/illustrations/location/location.json)
-- [Message](examples/illustrations/message/message.json)
-- [Mobile device and SIM card](examples/illustrations/mobile_device_and_sim_card/mobile_device_and_sim_card.json)
+- [Message](examples/illustrations/message/message.json) ([*info*](examples/illustrations/message/))
+- [Mobile device and SIM card](examples/illustrations/mobile_device_and_sim_card/mobile_device_and_sim_card.json) ([*info*](examples/illustrations/mobile_device_and_sim_card/))
 - [Multipart File](examples/illustrations/multipart_file/multipart_file.json) (*[info](examples/illustrations/multipart_file/)*)
-- [Network connection](examples/illustrations/network_connection/network_connection.json)
+- [Network connection](examples/illustrations/network_connection/network_connection.json) (*[info](examples/illustrations/network_connection/)*)
 - [Oresteia](examples/illustrations/Oresteia/Oresteia.json) (*[info](examples/illustrations/Oresteia/)*)
-- [Raw Data](examples/illustrations/raw_data/raw_data.json)
+- [Raw Data](examples/illustrations/raw_data/raw_data.json) (*[info](examples/illustrations/raw_data/)*)
 - [Reconstructed File](examples/illustrations/reconstructed_file/reconstructed_file.json) (*[info](examples/illustrations/reconstructed_file/)*)
 - [Recoverability](examples/illustrations/recoverability/recoverability.json) (*[info](examples/illustrations/recoverability/)*)
-- [SMS and Contacts](examples/illustrations/sms_and_contacts/sms_and_contacts.json)
+- [SMS and Contacts](examples/illustrations/sms_and_contacts/sms_and_contacts.json) (*[info](examples/illustrations/sms_and_contacts/)*)
 - [Spear Phishing](examples/illustrations/spear_phishing/spear_phishing.json), scenario drafted by [Open Cybersecurity Alliance](https://github.com/opencybersecurityalliance/oca-ontology) (*[info](examples/illustrations/spear_phishing/)*)
 
 

examples/illustrations/Oresteia/Makefile

@@ -13,4 +13,6 @@
 
 RENDER_PROV := yes
 
+RENDER_RELATIONSHIPS := yes
+
 include ../src/illustration-nosrc.mk

examples/illustrations/Oresteia/README.md

@@ -7,9 +7,16 @@ collectively called The Oresteia. For illustrative purposes, the characters
 of these ancient stories are given access to modern technology.
 
 
+## Relationship illustrations
+
+Using a proof-of-concept illustration system, a render of this scenario's `uco-core:Relationship` objects is available:
+
+![figures/Oresteia-relationships.svg](figures/Oresteia-relationships.svg)
+
+
 ## Provenance illustrations
 
-Following visual-design practices of [PROV-O](https://www.w3.org/TR/prov-o/), the following renders of this scenario are available:
+Following visual-design practices of [PROV-O](https://www.w3.org/TR/prov-o/), the following renders of this scenario's provenance are available:
 
 | Figure's contents | Time hidden | Time displayed |
 | --- | --- | --- |