Tutorial: Ontology Development - Revision history

Tuukka Lehtonen at 06:19, 19 March 2014

2014-03-19T06:19:30Z

← Older revision		Revision as of 06:19, 19 March 2014
Line 1:		Line 1:
			NEEDS TO BE REVISED TO MATCH CURRENT CONVENTIONS

	__NOTOC__		__NOTOC__
	''"What's up folks."'' This tutorial series is composed of four parts. As it is a trail, you should study them in order. Today we are going to create a movie database ontology for a client of your Acme company. Even though Simantics is intended for simulator integration platform, we decided to use movies as the theme. This basic level tutorial doesn't go into simulation specifics, and the subject is more familiar for any developer to relate to than a simulation specific one. Before starting make sure you have installed [[Development_Environment_Setup_Guide#Install_Simantics_target_platform\|Target Platform]] and [[Graph_Compiler\|Graph Compiler]] to your Eclipse as instructed in [[Development Environment Setup Guide]].		''"What's up folks."'' This tutorial series is composed of four parts. As it is a trail, you should study them in order. Today we are going to create a movie database ontology for a client of your Acme company. Even though Simantics is intended for simulator integration platform, we decided to use movies as the theme. This basic level tutorial doesn't go into simulation specifics, and the subject is more familiar for any developer to relate to than a simulation specific one. Before starting make sure you have installed [[Development_Environment_Setup_Guide#Install_Simantics_target_platform\|Target Platform]] and [[Graph_Compiler\|Graph Compiler]] to your Eclipse as instructed in [[Development Environment Setup Guide]].

Tuukka Lehtonen: /* Step 3: Export package */

2013-02-28T08:56:51Z

Step 3: Export package

← Older revision		Revision as of 08:56, 28 February 2013
Line 56:		Line 56:

	In this case the ontology's namespace root URI is '''<nowiki>http://www.acme.com/Movie-1.0</nowiki>'''.		In this case the ontology's namespace root URI is '''<nowiki>http://www.acme.com/Movie-1.0</nowiki>'''.
	Due to ontology versioning ~~and migration~~ support in the platform		Due to ontology versioning support in the platform
	# '''Bundle-Name''' must match URI without the version number, i.e. '''<nowiki>http://www.acme.com/Movie</nowiki>'''		# '''Bundle-Name''' must match URI without the version number, i.e. '''<nowiki>http://www.acme.com/Movie</nowiki>'''
	# '''Bundle-Version''' first two digits (major.minor) must match the URI's version part, i.e. '''1.0'''		# '''Bundle-Version''' first two digits (major.minor) must match the URI's version part, i.e. '''1.0'''.

	Notice, in particular, that the ontology depends on Layer0. If other ontologies are needed, they have to be added to MANIFEST.MF.		Notice, in particular, that the ontology depends on Layer0. If other ontologies are needed, they have to be added to MANIFEST.MF.

Tuukka Lehtonen: /* Step 3: Export package */

2013-02-28T08:05:24Z

Step 3: Export package

← Older revision		Revision as of 08:05, 28 February 2013
Line 55:		Line 55:
	</pre>		</pre>

	In this case the ontology's namespace root URI is '''http://www.acme.com/Movie-1.0'''.		In this case the ontology's namespace root URI is '''<nowiki>http://www.acme.com/Movie-1.0</nowiki>'''.
	Due to ontology versioning and migration support in the platform		Due to ontology versioning and migration support in the platform
	# '''Bundle-Name''' must match URI without the version number, i.e. '''http://www.acme.com/Movie'''		# '''Bundle-Name''' must match URI without the version number, i.e. '''<nowiki>http://www.acme.com/Movie</nowiki>'''
	# ''Bundle-Version''' first two digits (major.minor) must match the URI's version part, i.e. '''1.0'''		# '''Bundle-Version''' first two digits (major.minor) must match the URI's version part, i.e. '''1.0'''

	Notice, in particular, that the ontology depends on Layer0. If other ontologies are needed, they have to be added to MANIFEST.MF.		Notice, in particular, that the ontology depends on Layer0. If other ontologies are needed, they have to be added to MANIFEST.MF.

Tuukka Lehtonen: /* Step 3: Export package */

2013-02-28T08:04:28Z

Step 3: Export package

← Older revision		Revision as of 08:04, 28 February 2013
Line 55:		Line 55:
	</pre>		</pre>

	~~Notice, in particular, that~~ the ontology ~~depends on Layer0~~. ~~If other ontologies are needed, they have to be added to MANIFEST~~.MF. ~~Also notice that~~ the '''Bundle-Name''' must match ~~the ontology's namespace root~~ URI without the version number. '''Bundle-Version''' major.minor ~~parts~~ must in ~~turn match~~		In this case the ontology's namespace root URI is '''http://www.acme.com/Movie-1.0'''.
			Due to ontology versioning and migration support in the platform
			# '''Bundle-Name''' must match URI without the version number, i.e. '''http://www.acme.com/Movie'''
			# ''Bundle-Version''' first two digits (major.minor) must match the URI's version part, i.e. '''1.0'''

			Notice, in particular, that the ontology depends on Layer0. If other ontologies are needed, they have to be added to MANIFEST.MF.

	== Step 4: Write your Movie Ontology ==		== Step 4: Write your Movie Ontology ==

Tuukka Lehtonen: /* Step 3: Export package */

2013-02-28T08:00:42Z

Step 3: Export package

← Older revision		Revision as of 08:00, 28 February 2013
Line 55:		Line 55:
	</pre>		</pre>

	Notice, in particular, that the ontology depends on Layer0. If other ontologies are needed, they have to be added to MANIFEST.MF.		Notice, in particular, that the ontology depends on Layer0. If other ontologies are needed, they have to be added to MANIFEST.MF. Also notice that the '''Bundle-Name''' must match the ontology's namespace root URI without the version number. '''Bundle-Version''' major.minor parts must in turn match

	== Step 4: Write your Movie Ontology ==		== Step 4: Write your Movie Ontology ==

Tuukka Lehtonen: /* Step 3: Export package */

2013-02-28T07:58:53Z

Step 3: Export package

← Older revision		Revision as of 07:58, 28 February 2013
Line 48:		Line 48:
	Bundle-Name: http://www.acme.com/Movie		Bundle-Name: http://www.acme.com/Movie
	Bundle-SymbolicName: com.acme.movie.ontology		Bundle-SymbolicName: com.acme.movie.ontology
	Bundle-Version: 0.1.0.qualifier		Bundle-Version: 1.0.0.qualifier
	Bundle-Vendor: Acme Software ltd		Bundle-Vendor: Acme Software ltd
	Bundle-RequiredExecutionEnvironment: JavaSE-1.6		Bundle-RequiredExecutionEnvironment: JavaSE-1.6

Tuukka Lehtonen: /* Step 3: Export package */

2013-02-28T07:58:38Z

Step 3: Export package

← Older revision		Revision as of 07:58, 28 February 2013
Line 46:		Line 46:
	Manifest-Version: 1.0		Manifest-Version: 1.0
	Bundle-ManifestVersion: 2		Bundle-ManifestVersion: 2
	Bundle-Name: ~~Ontology~~		Bundle-Name: http://www.acme.com/Movie
	Bundle-SymbolicName: com.acme.movie.ontology		Bundle-SymbolicName: com.acme.movie.ontology
	Bundle-Version: 0.1.0.qualifier		Bundle-Version: 0.1.0.qualifier

Tuukka Lehtonen: /* Step 1: Setup Ontology Plug-in */

2012-05-08T08:31:45Z

Step 1: Setup Ontology Plug-in

← Older revision		Revision as of 08:31, 8 May 2012
Line 8:		Line 8:

	== Step 1: Setup Ontology Plug-in ==		== Step 1: Setup Ontology Plug-in ==
	Ontologies are encapsulated in OSGi bundles. In Eclipse, we develop them as ~~equinox~~ plug-ins. An ontology bundle is a specialized package. It has the following content: graph source files (graph/*.pgraph), a compiled graph file (graph.tg), and Java files (src/ and bin/).		Ontologies are encapsulated in OSGi bundles. In Eclipse, we develop them as Eclipse plug-ins. An ontology bundle is a specialized package. It has the following content: graph source files (graph/*.pgraph), a compiled graph file (graph.tg), and Java files (src/ and bin/).

	Open a New Plug-in Project wizard:		Open a New Plug-in Project wizard:

Juha Kortelainen: /* Step 1: Setup Ontology Plug-in */

2011-02-14T13:06:31Z

Step 1: Setup Ontology Plug-in

← Older revision		Revision as of 13:06, 14 February 2011
Line 19:		Line 19:
	* Set Version to ''0.1.0.qualifier''. In this page you should know that this plugin does not contribute to UI, does not need an activator and is not a rich client application. '''Next >'''		* Set Version to ''0.1.0.qualifier''. In this page you should know that this plugin does not contribute to UI, does not need an activator and is not a rich client application. '''Next >'''
	* Use template ''Plug-in with a Simantics Ontology''. '''Next >'''		* Use template ''Plug-in with a Simantics Ontology''. '''Next >'''
	* The domain of your company is ''www.acme.com'' and the name of the ontology ''Movie''. The initial version is 1.0.'''Finish'''		* The domain of your company is ''www.acme.com'' and the name of the ontology ''Movie''. The initial version is 1.0. '''Finish'''

	You have now a new project in Package Explorer. You will find META-INF/MANIFEST.MF, graph/Movie.pgraph, and graph.tg in it.		You have now a new project in Package Explorer. You will find META-INF/MANIFEST.MF, graph/Movie.pgraph, and graph.tg in it.

Juha Kortelainen at 12:59, 14 February 2011

2011-02-14T12:59:59Z

← Older revision		Revision as of 12:59, 14 February 2011
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	''"What's up folks."'' This tutorial series is composed of four parts. As it is a trail, you should study them in order. Today we are going to create a movie database ontology for a client of your Acme company. Even though Simantics is intended for simulator integration platform, we decided to use movies as the theme. This basic level tutorial doesn't go into simulation specifics, and the subject is more familiar for any developer to relate to than a simulation specific one. Before starting make sure you have installed [[Development_Environment_Setup_Guide#Install_Simantics_target_platform\|Target Platform]] and [[Graph_Compiler\|Graph Compiler]] to your Eclipse as instructed.		''"What's up folks."'' This tutorial series is composed of four parts. As it is a trail, you should study them in order. Today we are going to create a movie database ontology for a client of your Acme company. Even though Simantics is intended for simulator integration platform, we decided to use movies as the theme. This basic level tutorial doesn't go into simulation specifics, and the subject is more familiar for any developer to relate to than a simulation specific one. Before starting make sure you have installed [[Development_Environment_Setup_Guide#Install_Simantics_target_platform\|Target Platform]] and [[Graph_Compiler\|Graph Compiler]] to your Eclipse as instructed in [[Development Environment Setup Guide]].