Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -76,12 +76,13 @@
76	76	(% style="text-align: justify;" %)
77	77	You learned now how a valid JSON-LD for an openMINDS metadata instance looks like and how linkages between openMINDS instances are defined. In the following sections you will learn about the different tools that support you to create your own openMINDS JSON-LD metadata collection.
78	78
79		-=== The openMINDS Python API ===
	79	+=== The openMINDS Python ===
80	80
81		-One possible way to write openMINDS conform JSON-LDs is to use the openMINDS Python API which will help you to interact with the EBRAINS openMINDS metadata models and schemas. It consists of two sub-modules:
	81	+(% style="text-align: justify;" %)
	82	+openMINDS Python is a small library that allows you the dynamic usage of openMINDS metadata models and schemas in your Python application for generating your own collection of openMINDS conform metadata representations (instances) as JSON-LDs.
82	82
83		-The **openMINDS.generator** (coming soon) facilitates the translation of the openMINDS schema template syntax to other established formats, such as HTML and JSON-Schema (cf. also [[Technical details>>doc:Collabs.openminds.Documentation.Implementation details.WebHome]]).
84		-\\The **openMINDS.compiler** allows you the dynamic usage of openMINDS metadata models and schemas in your Python application for generating your own collection of openMINDS conform metadata representations (instances) as JSON-LDs (as described above). Please note that the openMINDS.compiler only helps you to generate correctly formatted JSON-LD metadata instances - the preparation on how you want to describe your research product with openMINDS is still up to you. If you need support in designing your own openMINDS metadata collection, check out the [[Tutorials>>openminds@ebrains.eu||target="_blank"]] which might give you hints on how to tackle your individual case or, of course, get in touch with us via [[openminds@ebrains.eu>>mailto:openminds@ebrains.eu]].
	84	+(% style="text-align: justify;" %)
	85	+Please note that openMINDS Python only helps you to generate correctly formatted JSON-LD metadata instances - the preparation on how you want to describe your research product with openMINDS is still up to you. If you need support in designing your own openMINDS metadata collection, check out the [[Tutorials>>doc:Collabs.openminds.Tutorials.WebHome||target="_blank"]] which might give you hints on how to tackle your individual case or, of course, get in touch with us directly via our support-email ([[openminds@ebrains.eu>>mailto:openminds@ebrains.eu]]).
85	85
86	86	===== Installation =====
87	87
...	...	@@ -88,33 +88,40 @@
88	88	The official versions are available at the [[Python Package Index>>https://pypi.org/project/openMINDS/]] and can be installed using `pip install` in your console:
89	89
90	90	{{code language="console"}}
91		-pip install openminds
	92	+pip install openMINDS
92	92	{{/code}}
93	93
94	94	The latest development version is available on the [[openMINDS generator GitHub>>https://github.com/HumanBrainProject/openMINDS_generator]].
95	95
96		-===== openMINDS.compiler documentation =====
	97	+===== Usage =====
97	97
98		-As stated above, the openMINDS.compiler allows you the dynamic usage of openMINDS metadata models and schemas in your Python application for generating your own collection of openMINDS conform metadata representations (instances) as JSON-LDs. Here a small example:
	99	+As stated above, the openMINDS Python allows you the dynamic usage of openMINDS metadata models and schemas in your Python application for generating your own collection of openMINDS conform metadata representations (instances) as JSON-LDs. Here a small example:
99	99
100	100	{{code language="python"}}
101		-import openMINDS.compiler
	102	+import openMINDS
	103	+import openMINDS.version_manager
102	102
	105	+# Initialise the local copy of openMINDS
	106	+openMINDS.version_manager.init()
	107	+
	108	+# Select which version of openMINDS to use
	109	+openMINDS.version_manager.version_selection('v2.0.0')
	110	+
103	103	# initiate the helper class for the dynamic usage of a specific openMINDS version
104		-helper = openMINDS.compiler.Helper(version="v1.0")
	112	+helper = openMINDS.Helper()
105	105
106	106	# initiate the collection into which you will store all metadata instances
107		-mycollection = helper.get_collection()
	115	+mycollection = helper.create_collection()
108	108
109	109	# create a metadata instance for (e.g.) the openMINDS Person schema
110		-lyuba = mycollection.add_core_person(givenName="Lyuba")
	118	+person_open = mycollection.add_core_person(givenName="open")
111	111
112	112	# add more metadata to a created instance
113		-mycollection.get(lyuba).familyName = "Zehl"
	121	+mycollection.get(person_open).familyName = "MINDS"
114	114
115	115	# add connections to other metadata instances
116		-email_lyuba = mycollection.add_core_contactInformation(email="openminds@ebrains.eu")
117		-mycollection.get(lyuba).contactInformation = email_lyuba
	124	+email_openminds = mycollection.add_core_contactInformation(email="openminds@ebrains.eu")
	125	+mycollection.get(person_open).contactInformation = email_openminds
118	118
119	119	# save your collection
120	120	mycollection.save("./myFirstOpenMINDSMetadataCollection/")
...	...	@@ -126,7 +126,8 @@
126	126	Interactively you can also get an overview of the requirement of a schema and all its properties by using the **##help_##** function of the openMINDS.compiler. Here an example:
127	127
128	128	{{code language="python"}}
129		-mycollection.help_core_person()
	137	+# Getting help for properties
	138	+mycollection.help_core_actors_person()
130	130	{{/code}}
131	131
132	132	=== The openMINDS spreadsheet templates ===