[MNT] Add example scripts for creating data dictionary + graph data J…

…SON schema (#427)

* add example scripts for creating data dict + graph data jsonschema

* move helper scripts into directory

* update instruction on regenerating vocab file

README.md

@@ -91,6 +91,6 @@ This vocabulary is used by Neurobagel APIs to fetch available attributes and att
 When the Neurobagel graph data model is updated (e.g., if new classes or subclasses are created), 
 this file should be regenerated by running:
 ```bash
-python generate_nb_vocab_file.py
+python helper_scripts/generate_nb_vocab_file.py
 ```
 This will create a file called `nb_vocab.ttl` in the current working directory.

helper_scripts/generate_dictionary_jsonschema.py

@@ -0,0 +1,11 @@
+# This is an example script for generating a JSON schema for the Neurobagel data dictionary model.
+# Example usage: python generate_dictionary_jsonschema.py
+
+import json
+
+from bagel.dictionary_models import DataDictionary
+
+FPATH = "neurobagel_datadictionary.schema.json"
+
+with open(FPATH, "w") as f:
+    f.write(json.dumps(DataDictionary.model_json_schema(), indent=2))

helper_scripts/generate_graphdata_jsonschema.py

@@ -0,0 +1,16 @@
+# This is an example script for generating a JSON schema for the Neurobagel graph data model (i.e., the model for a Neurobagel "Dataset").
+# Example usage: python generate_graphdata_jsonschema.py
+
+import json
+
+from bagel.models import Dataset
+
+FPATH = "neurobagel_graphdata.schema.json"
+
+with open(FPATH, "w") as f:
+    f.write(
+        json.dumps(
+            Dataset.model_json_schema(),
+            indent=2,
+        )
+    )