Last modified by Alexander Schulz-Rosengarten on 2023/09/13 12:18
Show last authors
1 = KIELER Pragmatics 2014/12 =
2
3 * [[Official Project Website>>url:http://www.informatik.uni-kiel.de/rtsys/kieler||shape="rect"]]
4 * Built on Eclipse 4.4 "Luna"
5
6 [[We are happy>>url:http://trololololololololololo.com/||rel="nofollow" shape="rect" class="external-link"]] to provide release 2014/12 of the **KIELER Pragmatics Project**! KIELER Pragmatics 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**.
9
10
11
12 {{toc minLevel="2"/}}
13
14 == Installation ==
15
16 KIELER Pragmatics 2014/12 is provided as a set of features, available to be added to your Eclipse installation via an update site. KIELER Pragmatics 2014/12 was tested on [[Eclipse 4.4 "Luna">>url:http://www.eclipse.org/downloads/||shape="rect"]], but may also be compatible with other versions of Eclipse.
17
18 * See the [[KIELER Downloads>>doc:KIELER.Overview.Downloads.WebHome]] site for download details.
19 * KIELER Pragmatics requires an installed Java Runtime Environment >= version 1.5.
20 * 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.
21
22 Also refer to the [[KIELER Downloads>>doc:KIELER.Overview.Downloads.WebHome]] page to download the KIELER Ptolemy Browser and the KIELER Web Service.
23
24 == Release Notes ==
25
26 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=10800||shape="rect"]]. Release notes of older releases can be found at our [[doc:KIELER.Old Release Notes.WebHome]] page.
27
28 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.
29
30 === API Changes in 2014/12 ===
31
32 This is a summary of the API changes introduced with version 2014/12:
33
34 * [[KIELER Layout Algorithms>>doc:KIELER.Discontinued Projects.Layout Algorithms (KLay).WebHome]]
35 ** KLay Layered's layout option {{code language="none"}}Properties.MERGE_PORTS{{/code}} was renamed to {{code language="none"}}Properties.MERGE_EDGES{{/code}}. Its ID was changed from {{code language="none"}}de.cau.cs.kieler.klay.layered.mergePorts{{/code}} to {{code language="none"}}de.cau.cs.kieler.klay.layered.mergeEdges{{/code}}.
36 ** Similarly, KLay Layered's layout option {{code language="none"}}Properties.MERGE_HIERARCHICAL_PORTS{{/code}} was renamed to {{code language="none"}}Properties.MERGE_HIERARCHICAL_EDGES{{/code}}. Its ID was changed from {{code language="none"}}de.cau.cs.kieler.klay.layered.mergeHierarchicalPorts{{/code}} to {{code language="none"}}de.cau.cs.kieler.klay.layered.mergeHierarchicalEdges{{/code}}.
37 ** (((
38 The {{code language="none"}}de.cau.cs.kieler.klay.layered.{{/code}}{{code language="none"}}distributeNodes{{/code}} property was renamed to {{code language="none"}}de.cau.cs.kieler.klay.layered.{{/code}}{{code language="none"}}wideNodesOnMultipleLayers{{/code}} and allows for two modes now.
39
40 *
41
42 {{code language="none"}}CAREFUL{{/code}} avoiding node/edge overlaps
43
44 *
45
46 {{code language="none"}}AGGRESSIVE{{/code}} often more compact but does not guarantee to avoid node/edge overlaps
47 )))
48 * [[KIELER Lightweight Diagrams>>doc:KIELER.Lightweight Diagrams (KLighD).WebHome]]
49 ** Feature composition changed s.t. {{code language="none"}}de.cau.cs.kieler.klighd.feature{{/code}} only contains essential runtime plugins
50 *** does not require Xtext & KIELER KIVi anymore
51 *** those components are still part of our SDK feature {{code language="none"}}de.cau.cs.kieler.klighd.sdk.feature{{/code}}
52 ** Plugin {{code language="none"}}de.cau.cs.kieler.klighd.ui{{/code}} does not register the generic {{code language="none"}}DiagramEditorPart{{/code}} and menu contributions like '{{code language="none"}}Save As Image...{{/code}}' anymore
53 *** registrations have been moved to plugin {{code language="none"}}de.cau.cs.kieler.klighd.ui.contrib3x{{/code}} that is part of our SDK feature {{code language="none"}}de.cau.cs.kieler.klighd.sdk.feature{{/code}}
54 *** nonetheless implementations remain at their previous place and can be specialized (subclassed)
55 ** Consolidation of the printing facilities
56 *** consolidation of the export branding infrastructure (see {{code language="none"}}IExportBranding{{/code}} for details on that feature)
57
58 === New Features Included in 2014/12 ===
59
60 Here's a few highlights of what's new in version 2014/12:
61
62 * [[KIELER Layout Algorithms>>doc:KIELER.Discontinued Projects.Layout Algorithms (KLay).WebHome]]
63 ** A new interactive node placement algorithm in KLay Layered keeps the y coordinates of nodes intact if they don't overlap. This node placement algorithm is supposed to be used together with the interactive implementations of the other layout phases.
64 * (((
65 [[KIELER Lightweight Diagrams>>doc:KIELER.Lightweight Diagrams (KLighD).WebHome]]* upcoming{{code language="none"}} ViewChange{{/code}} notifications received by {{code language="none"}}IViewChangeListeners{{/code}} can now be suppressed, see {{code language="none"}}ViewChange.suppressSubsequent...Notifications(...){{/code}}
66
67 * introduced dedicated zoom style {{code language="none"}}ZOOM_TO_FOCUS_AND_INCREASE_TO_FIT{{/code}}
68 ** 'increase to fit' behavior is now skipped while by applying the existing zoom style {{code language="none"}}ZOOM_TO_FOCUS{{/code}}
69 * (((
70 KLighD now ships a generic graph visualization that allows to inspect the structure of graphs specified in any format that is supported by KIML.
71 )))
72 * The wizard for new KLighD projects received some love. We polished it's UI and generated code and added some tooltips.
73 * (((
74 We replaced the Batik SVG exporter with a customized exporter that is based on FreeHEP.
75
76 *
77
78 It supports semantic data to be added to the generated SVG.
79
80 *
81
82 Color gradients obey to the specified rotation angle.
83 )))
84 )))
85 * (((
86 [[KGraph Editor Product>>doc:KIELER.Standalone KGraph Editor]]
87
88 * (((
89 Layout options can now be configured using a textual DSL.
90 )))
91 * (((
92 GrAna analyses can be specified using a textual DSL and executed either via the UI or headlessly.
93 )))
94 )))
95
96 === Important Bugs Fixed in 2014/12 ===
97
98 Among others, the following bugs were fixed in version 2014/12:
99
100 * [[KIELER Layout Algorithms>>doc:KIELER.Discontinued Projects.Layout Algorithms (KLay).WebHome]]
101 ** Computing layouts with the layout direction set to {{code language="none"}}UP{{/code}} failed for compound nodes in KLay Layered.
102 ** KLay Force allowed the object spacing to be zero, which does not make sense and, more importantly, crashed the algorithm.
103 * [[KGraph Text>>doc:KIELER.KIELER Pragmatics.KGraph Text (KGT).WebHome]]
104 ** Converting KGX files into the KGT format failed when certain properties were set.
105 * [[KIELER Lightweight Diagrams>>doc:KIELER.Lightweight Diagrams (KLighD).WebHome]]
106 ** We fixed an issue where the allocated memory of views was not released properly.
107
108 == Quickstart ==
109
110 === Diagram Layout ===
111
112 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:
113
114 * Open a diagram using a GMF editor.
115 * Press the Layout button in the toolbar:
116 * Open the //Layout View// by clicking //Window// -> //Show View// -> //Other...// and choosing //Layout// from the //KIELER Layout// category.
117 * Change some of the values and press the Layout button again.
118
119 === Viewing Ptolemy Models ===
120
121 If you have a Ptolemy installation, try the following:
122
123 * Save a Ptolemy model as a {{code language="none"}}.moml{{/code}} file somewhere.
124 * (((
125 Download and start our //[[Ptolemy Model Browser>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/tools-and-libraries/||shape="rect"]]//.
126 )))
127 * Open your moml file.
128 * 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.
129
130 == Known Problems and Limitations ==
131
132 * Starting with Mac OS X Mountain Lion, trying to start our software may give you an error message similar to this:
133 [[image:attach:security1.png]]
134 The solution is to open your system preferences and navigate to the //Security & Privacy// settings. Therein, either click on //Open Anyway// if available or change //Allow apps downloaded from// to //Anywhere//.
135 [[image:attach:security2.png]]
136 Starting our software will now result in the following message:
137 [[image:attach:security3.png]]
138 Simply click //Open// and you're good to go.
139 * Upon starting the Ptolemy Model Browser, you may get something like this:
140 [[image:attach:ptBrowserProblem.png]]
141 The solution is to exit the application, remove your existing workspace, and restart the Ptolemy Model Browser. Your workspace can be found in your home folder and is called {{code language="none"}}kielerPtolemyWs{{/code}}.
142 * The Ptolemy Model Browser can properly display only a limited set of actors. Other actors may look a lot different than they do in Ptolemy.
143 * Currently there is no full-blown user documentation integrated. See our [[doc:KIELER.Kieler]] for more information.
144
145 == Bug Reports, Comments ==
146
147 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.
148
149 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"]].

Navigation

Quick Links

KIELER on GitHub
RTSYS Homepage