# Wiki source code of KIELER Pragmatics Release 2014/05

Last modified by Richard Kreissig on 2023/09/14 10:39
Export
Office Formats
Export as PDF Export as ODT Export as RTF
Other Formats

Select the pages to export:

select all/ none

Legend:
  Created Page
  Modified Extension Page
  Clean Extension Page

Export as HTML

Show last authors

author | version | line-number | content
--- | --- | --- | ---
|  | 1 | = KIELER Pragmatics 2014/05 =
|  | 2 |
|  | 3 | * [[Official Project Website>>url:http://www.informatik.uni-kiel.de/rtsys/kieler||shape="rect"]]
|  | 4 | * Built on Eclipse 4.3 "Kepler"
|  | 5 |
|  | 6 | [[We are happy>>url:http://trololololololololololo.com/||rel="nofollow" shape="rect" class="external-link"]] to provide release 2014/05 of the **KIELER Pragmatics Project**! It is a framework for enhanced user interaction in graphical modeling that builds on the Eclipse platform. This document describes how to install the release and highlights the most exciting new features.
|  | 7 |
|  | 8 | As a bonus, we are co-releasing our KLighD-based **KIELER Ptolemy Browser**. As a further bonus, the next few days will see the first release of our **KIELER KLayJS** libraries that bring our very own KLay Layered layout algorithm to the world of JavaScript.
|  | 9 |
|  | 10 | {{info title="What's with the new version numbering scheme?"}}
|  | 11 | Instead of naming this release //KIELER Pragmatics 0.12.0//, we decided to name it //KIELER Pragmatics 2014/05//. This way, people immediately see when this version was released. Also, since the plug-ins and features carry a timestamp, people can immediately see which release a particular plug-in or feature belongs to. All hail to clarity!
|  | 12 | {{/info}}
|  | 13 |
|  | 14 |
|  | 15 |
|  | 16 |
|  | 17 | {{toc minLevel="2"/}}
|  | 18 |
|  | 19 | == Installation ==
|  | 20 |
|  | 21 | KIELER Pragmatics 2014/05 is provided as a set of features, available to be added to your Eclipse installation via an update site. KIELER Pragmatics 2014/05 was tested on [[Eclipse 4.3 "Kepler">>url:http://www.eclipse.org/downloads/||shape="rect"]], but may also be compatible with other versions of Eclipse.
|  | 22 |
|  | 23 | * See the [[KIELER Downloads>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/||shape="rect"]] site for download details.
|  | 24 | * KIELER Pragmatics requires an installed Java Runtime Environment >= version 1.5.
|  | 25 | * The layout components of KIELER can make use of the layout algorithms provided by the [[Graphviz>>url:http://www.graphviz.org/||rel="nofollow" shape="rect" class="external-link"]] library. You may want to install that.
|  | 26 |
|  | 27 | See the [[KIELER Tools and Libraries>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/tools-and-libraries/||shape="rect"]] page to download the KIELER Ptolemy Browser and the KIELER Web Service.
|  | 28 |
|  | 29 | == Release Notes ==
|  | 30 |
|  | 31 | The 2014/05 release of KIELER Pragmatics continues our efforts to redesign our core APIs, KIML and KLighD. **It includes a number of API-breaking changes, so beware of upgrading to this release if you currently do not have time to adapt your code accordingly.** You can find a list of solved tickets for this release at [[our issue tracking system>>url:http://rtsys.informatik.uni-kiel.de/jira/secure/ReleaseNote.jspa?projectId=10400&version=10700||shape="rect"]]. Release notes of older releases can be found at our [[doc:KIELER.Old Release Notes.WebHome]] page.
|  | 32 |
|  | 33 | If you're wondering where components have gone that were traditionally a part of KIELER, you might not know yet that the KIELER was split into two separate projects, KIELER Pragmatics and KIELER Semantics, which release pretty much independently.
|  | 34 |
|  | 35 | === API Changes in 2014/05 ===
|  | 36 |
|  | 37 | This is a summary of the API changes introduced with version 2014/05:
|  | 38 |
|  | 39 | * [[KIELER Lightweight Diagrams>>doc:KIELER.Lightweight Diagrams (KLighD).WebHome]]
|  | 40 | * (((
|  | 41 | [[KIELER Infrastructure for Meta-Layout>>doc:KIELER.Discontinued Projects.Infrastructure for Meta Layout (KIML).WebHome]]*
|  | 42 |
|  | 43 | (((
|  | 44 | Renamed LayoutDataService to LayoutMetaDataService and renamed ILayoutData to ILayoutMetaData in order to avoid confusion with the KLayoutData meta model and the respective interface.
|  | 45 | )))
|  | 46 |
|  | 47 | * Removed generic type argument from LayoutOptionData.
|  | 48 | * (((
|  | 49 | ILayoutConfig: renamed API method enrich() to getContextValue(..), renamed getValue(..) to getOptionValue(..), renamed setValue(..) to setOptionValue(..), renamed clearValues() to clearOptionValues(..) – see [[doc:KIELER.Discontinued Projects.Infrastructure for Meta Layout (KIML).Configuring Automatic Layout.WebHome]] for more details.
|  | 50 | )))
|  | 51 | * (((
|  | 52 | IDiagramLayoutManager does not inherit from IAdapterFactory anymore; adapter values are now accessed with layoutManager.getDiagramConfig().getContextValue(..)
|  | 53 | )))
|  | 54 | * (((
|  | 55 | Graphiti bridge: moved some methods from KimlGraphitiUtil to GraphitiDiagramLayoutManager in order to allow easier adaptation in subclasses. Furthermore, we now differentiate margins (spacing to visible part of a node) and insets (spacing to nested subgraph).
|  | 56 | )))
|  | 57 | * Made a design review of the de.cau.cs.kieler.core plugin and improved the API of some core classes and interfaces.
|  | 58 | )))
|  | 59 |
|  | 60 | === New Features Included in 2014/05 ===
|  | 61 |
|  | 62 | Here's a few highlights of what's new in version 2014/05:
|  | 63 |
|  | 64 | * [[KIELER Lightweight Diagrams>>doc:KIELER.Lightweight Diagrams (KLighD).WebHome]]
|  | 65 | * (((
|  | 66 | [[KIELER Infrastructure for Meta-Layout>>doc:KIELER.Discontinued Projects.Infrastructure for Meta Layout (KIML).WebHome]]*
|  | 67 |
|  | 68 | (((
|  | 69 | Made categorization of the Layout View more understandable.
|  | 70 | )))
|  | 71 |
|  | 72 | * (((
|  | 73 | Added a creation method for VolatileLayoutConfig that makes the far too complicated STATIC_CONFIG of layout managers unnecessary.
|  | 74 | )))
|  | 75 | )))
|  | 76 | * [[KIELER Layout Algorithms>>doc:KIELER.Discontinued Projects.Layout Algorithms (KLay).WebHome]]
|  | 77 | ** KLay Layered now makes sure that labels of compound node ports placed on the inside of the compound node are not overlapped by nodes inside the compound node.
|  | 78 | ** KLay Layered now supports controlling the spacing between and around ports through the new layout options {{code language="none"}}LayoutOptions.PORT_SPACING{{/code}} and {{code language="none"}}LayoutOptions.ADDITIONAL_PORT_SPACING{{/code}}.
|  | 79 | ** KLay Layered now understands LayoutOptions.NO_LAYOUT, which can be set to exclude particular graph elements from automatic layout.
|  | 80 | ** KLay Layered now understands a new programmatic option for edge thickness.
|  | 81 | ** When in hierarchical layout mode, KLay Layered now properly places edge labels of cross-hierarchy edges.
|  | 82 | ** When in hierarchical layout mode, KLay Layered can now compact cross-hierarchy edges as it can compact regular edges ({{code language="none"}}Properties.MERGE_HIERARCHICAL_PORTS{{/code}}):
|  | 83 | [[image:attach:merge_hierarchy.png]]
|  | 84 | * [[KGraph Text>>doc:KIELER.KIELER Pragmatics.KGraph Text (KGT).WebHome]]
|  | 85 | ** The textual language for defining KGraphs now has a lot more defaults. Node and port labels are automatically extracted from the node's and port's ID. Nodes and ports also have a default size. This makes for shorter diagram descriptions.
|  | 86 |
|  | 87 | == Quickstart ==
|  | 88 |
|  | 89 | === Diagram Layout ===
|  | 90 |
|  | 91 | One of the core features of KIELER Pragmatics is the KIELER Infrastructure for Meta-Layout (KIML). It provides the glue between diagram editors and layout algorithms. If you have installed layout support for GMF editors, you may want to try the following:
|  | 92 |
|  | 93 | * Open a diagram using a GMF editor.
|  | 94 | * Press the Layout button in the toolbar:[[image:attach:kieler-arrange.gif]]
|  | 95 | * Open the //Layout View// by clicking //Window// -> //Show View// -> //Other...// and choosing //Layout// from the //KIELER Layout// category.
|  | 96 | * Change some of the values and press the Layout button again.
|  | 97 |
|  | 98 | === Viewing Ptolemy Models ===
|  | 99 |
|  | 100 | If you have a Ptolemy installation, try the following:
|  | 101 |
|  | 102 | * Save a Ptolemy model as a {{code language="none"}}.moml{{/code}} file somewhere.
|  | 103 | * (((
|  | 104 | Download and start our //[[Ptolemy Model Browser>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/tools-and-libraries/||shape="rect"]]//.
|  | 105 |
|  | 106 | {{info title="Note for Mac OS Users"}}
|  | 107 | Starting with Mac OS X Mountain Lion, trying to start the Ptolemy Model Browser may give you the following error message:
|  | 108 |
|  | 109 | [[image:attach:damaged_error.png]]
|  | 110 |
|  | 111 | The problem is not that our application file is damaged in any way. Much rather, we have not invested the money to obtain a proper developer certificate with which this error would not be generated. The solution is to open your system preferences and navigate to the //Security & Privacy// settings. Therein, make sure to set //Allow apps downloaded from// to //Anywhere//:
|  | 112 |
|  | 113 | [[image:attach:security_preferences.png]]
|  | 114 |
|  | 115 | Start the Ptolemy Browser again. This will result in the following warning:
|  | 116 |
|  | 117 | [[image:attach:untrusted_error.png]]
|  | 118 |
|  | 119 | Simple click "Open" and you're good to go at last.
|  | 120 | {{/info}}
|  | 121 | )))
|  | 122 | * Open your moml file.
|  | 123 | * Double-click actors that have further models inside them. Also double-click modal model states that have refinements. Use the sidebar on the right to influence how your model is displayed.
|  | 124 |
|  | 125 | == Known Problems and Limitations ==
|  | 126 |
|  | 127 | * The Ptolemy Model Viewer can properly display only a limited set of actors. Other actors may look a lot different than they do in Ptolemy.
|  | 128 | * Currently there is no full-blown user documentation integrated. See our [[doc:KIELER.Kieler]] for more information.
|  | 129 |
|  | 130 | == Bug Reports, Comments ==
|  | 131 |
|  | 132 | We're working hard to make the graphical modeling user experience as convenient as possible. However, bugs can still remain in the code and some things might not be as you would expect them. Please don't hesitate to send in bug reports or give other comments like feature requests.
|  | 133 |
|  | 134 | Send bug reports to kieler@…, please. For news or general questions subscribe to the [[rt-kieler mailing list>>url:https://lists.informatik.uni-kiel.de/mailman/listinfo/rt-kieler||rel="nofollow" shape="rect" class="external-link"]].

# Quick Links

KIELER on GitHub
RTSYS Homepage

XWiki 14.4.7