Wiki source code of Minimal Example HowTo
Version 27.1 by bdu on 2013/11/26 17:05
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{info}} | ||
| 2 | These examples were created and tested under KIELER Pragmatics 0.10.0. | ||
| 3 | {{/info}} | ||
| 4 | |||
| 5 | |||
| 6 | |||
| 7 | These instructions should guide you if you'd like to try out using KLighD for visualizing your own models or data structures. | ||
| 8 | |||
| 9 | == Two Examples == | ||
| 10 | |||
| 11 | We provide two minimal step-by-step examples: | ||
| 12 | |||
| 13 | |=((( | ||
| 14 | ====== [[image:attach:klighd-minimal-example.png]] ====== | ||
| 15 | |||
| 16 | (% style="text-align: center;" %) | ||
| 17 | [[(1) Minimal Example (Java Model)>>doc:Minimal Example (Java Model)]] | ||
| 18 | |||
| 19 | (% style="text-align: center;" %) | ||
| 20 | demonstrates a KLighD visualization of a trivial | ||
| 21 | (% style="color: rgb(0,128,0);" %)Java data(%%) (% style="color: rgb(0,128,0);" %)structure | ||
| 22 | )))|=((( | ||
| 23 | [[image:attach:myxtextdata.png]] | ||
| 24 | |||
| 25 | (% style="text-align: center;" %) | ||
| 26 | |||
| 27 | [[(2) Minimal Example (Xtext Model)>>doc:Minimal Example (Xtext Model)]] | ||
| 28 | |||
| 29 | (% style="text-align: center;" %) | ||
| 30 | demonstrates a KLighD visualization of a trivial | ||
| 31 | (% style="color: rgb(0,128,0);" %)Xtext model | ||
| 32 | ))) | ||
| 33 | |||
| 34 | Both examples require an Eclipse Kepler Modeling setup with the KLighD framework installed. Please follow the instruction below in order to setup an Eclipse suitable to run the examples. It is suggested to start with a fresh copy of Eclipse. | ||
| 35 | |||
| 36 | == Eclipse Installation (pre-requirement) == | ||
| 37 | |||
| 38 | In order to get this example working, you need an Eclipse installation according to the following instructions: | ||
| 39 | |||
| 40 | 1. Download Eclipse Kepler (Modeling Edition): | ||
| 41 | Windows x64: [[http:~~/~~/www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/kepler/SR1/eclipse-modeling-kepler-SR1-win32-x86_64.zip&mirror_id=546>>url:http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/kepler/SR1/eclipse-modeling-kepler-SR1-win32-x86_64.zip&mirror_id=546||shape="rect"]] | ||
| 42 | Mac x64: [[http:~~/~~/www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/kepler/SR1/eclipse-modeling-kepler-SR1-macosx-cocoa-x86_64.tar.gz>>url:http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/kepler/SR1/eclipse-modeling-kepler-SR1-macosx-cocoa-x86_64.tar.gz||shape="rect"]] | ||
| 43 | Other: [[http:~~/~~/www.eclipse.org/downloads/packages/eclipse-modeling-tools/keplersr1>>url:http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/keplersr1||shape="rect"]] | ||
| 44 | 1. Start Eclipse. | ||
| 45 | 1. Add the KIELER Pragmatics release 0.10.0 update site to your Eclipse (Help -> Install New Software ... -> Add)[[: | ||
| 46 | >>url:http://rtsys.informatik.uni-kiel.de/~~kieler/updatesite/||shape="rect"]][[http:~~/~~/rtsys.informatik.uni-kiel.de/~~~~kieler/updatesite/release_pragmatics_0.10.0/>>url:http://rtsys.informatik.uni-kiel.de/~~kieler/updatesite/release_pragmatics_0.10.0/||shape="rect"]] | ||
| 47 | 1. Select | ||
| 48 | [x] Layout, | ||
| 49 | [x] Lightweight Diagrams, and | ||
| 50 | [x] Sources | ||
| 51 | to be installed into your Eclipse. You may need to re-start Eclipse after finishing the installation process. Note that you may be asked to review installation process where kieler.ptolemy features are opt out. You can safely accept these proposed changes as this feature is not mandatory in order to properly run the examples. | ||
| 52 | |||
| 53 | |||
| 54 | |||
| 55 | == Run-Configuration == | ||
| 56 | |||
| 57 | When you have setup the examples as explained in the sub-pages, you finally want to run the examples and need to setup a run-configuration to do so: | ||
| 58 | |||
| 59 | 1. Click on Run -> Run Configurations ... | ||
| 60 | 1. Right click on Eclipse Applications and then click on New | ||
| 61 | 1. Give the run-configuration a proper name, e.g. KLighD Example | ||
| 62 | 1. ((( | ||
| 63 | In the Arguments tab, set the VM arguments to: | ||
| 64 | |||
| 65 | {{code}} | ||
| 66 | -Dosgi.requiredJavaVersion=1.5 -Dhelp.lucene.tokenizer=standard -Xms80m -Xmx1048m -Xss2048k -XX:MaxPermSize=196m | ||
| 67 | {{/code}} | ||
| 68 | ))) | ||
| 69 | 1. Finally, click on Apply, then click Run to start the example. |