Skip to Content
Last modified by Alexander Schulz-Rosengarten on 2023/09/13 12:18
From version 19.1
edited by cds
on 2014/11/24 13:15
Change comment: There is no comment for this version
To version 1.1
edited by cds
on 2014/10/01 12:50
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,3 +1,9 @@
1 +{{warning title="Warning"}}
2 +Pragmatics 2014-10 hasn't been released yet. These release notes are preliminary!
3 +{{/warning}}
4 +
5 +
6 +
1 1  = KIELER Pragmatics 2014/10 =
2 2  
3 3  * [[Official Project Website>>url:http://www.informatik.uni-kiel.de/rtsys/kieler||shape="rect"]]
... ... @@ -7,67 +7,78 @@
7 7  
8 8  As a bonus, we are co-releasing our KLighD-based **KIELER Ptolemy Browser**.
9 9  
16 +{{info title="What's with the new version numbering scheme?"}}
17 +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!
18 +{{/info}}
10 10  
20 +
11 11  
22 +
23 +
12 12  {{toc minLevel="2"/}}
13 13  
14 14  == Installation ==
15 15  
16 -KIELER Pragmatics 2014/10 is provided as a set of features, available to be added to your Eclipse installation via an update site. KIELER Pragmatics 2014/10 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.
28 +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.
17 17  
18 -* See the [[KIELER Downloads>>doc:Downloads]] site for download details.
30 +* See the [[KIELER Downloads>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/||shape="rect"]] site for download details.
19 19  * KIELER Pragmatics requires an installed Java Runtime Environment >= version 1.5.
20 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 21  
22 -Also refer to the [[KIELER Downloads>>doc:Downloads]] page to download the KIELER Ptolemy Browser and the KIELER Web Service.
34 +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.
23 23  
24 24  == Release Notes ==
25 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=10701||shape="rect"]]. Release notes of older releases can be found at our [[doc:Release Notes]] page.
38 +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:Release Notes]] page.
27 27  
28 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 29  
30 -=== API Changes in 2014/10 ===
42 +=== API Changes in 2014/05 ===
31 31  
32 -This is a summary of the API changes introduced with version 2014/10:
44 +This is a summary of the API changes introduced with version 2014/05:
33 33  
34 -* Core Changes
35 -** {{code language="none"}}IPropertyHolder{{/code}}'s {{code language="none"}}setProperty(...) {{/code}}and {{code language="none"}}copyProperties(...){{/code}} now return {{code language="none"}}IPropertyHolder{{/code}} instead of {{code language="none"}}void{{/code}}, implementations are supposed to return {{code language="none"}}this{{/code}} for convenience
36 36  * [[KIELER Lightweight Diagrams>>doc:Lightweight Diagrams (KLighD)]]
37 -** Added {{code language="none"}}DiagramSyntheses{{/code}} class providing lots of convenience methods for configuring the view model in diagram synthesis implementations (preliminary version introduced with last previous release)
38 -** {{code language="none"}}IViewer{{/code}} provides {{code language="none"}}getZoomLevel(){{/code}}
39 -** {{code language="none"}}IViewer{{/code}} provides methods for registering {{code language="none"}}IViewChangeListener{{/code}}s
40 -** {{code language="none"}}IUpdateStrategy{{/code}} now requires the method {{code language="none"}}requiresDiagramSynthesisReRun(...){{/code}} that allows to tell KLighD's runtime whether a new synthesis run is required for performing a (certain) diagram update
41 -** Introduced {{code language="none"}}IKlighdSelection{{/code}} interface abstracting {{code language="none"}}KlighdTreeSelection{{/code}} and {{code language="none"}}KlighdTextSelection{{/code}}
42 -** Updated {{code language="none"}}layoutDiagram(...){{/code}} methods in {{code language="none"}}LightDiagramServices{{/code}}
47 +* (((
48 +[[KIELER Infrastructure for Meta-Layout>>doc:Infrastructure for Meta Layout (KIML)]]* (((
49 +Renamed LayoutDataService to LayoutMetaDataService and renamed ILayoutData to ILayoutMetaData in order to avoid confusion with the KLayoutData meta model and the respective interface.
50 +)))
51 +* Removed generic type argument from LayoutOptionData.
52 +* (((
53 +ILayoutConfig: renamed API method enrich() to getContextValue(..), renamed getValue(..) to getOptionValue(..), renamed setValue(..) to setOptionValue(..), renamed clearValues() to clearOptionValues(..) – see [[doc:Configuring Automatic Layout]] for more details.
54 +)))
55 +* (((
56 +IDiagramLayoutManager does not inherit from IAdapterFactory anymore; adapter values are now accessed with layoutManager.getDiagramConfig().getContextValue(..)
57 +)))
58 +* (((
59 +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).
60 +)))
61 +* Made a design review of the de.cau.cs.kieler.core plugin and improved the API of some core classes and interfaces.
62 +)))
43 43  
44 -=== New Features Included in 2014/10 ===
64 +=== New Features Included in 2014/05 ===
45 45  
46 -Here's a few highlights of what's new in version 2014/10:
66 +Here's a few highlights of what's new in version 2014/05:
47 47  
48 48  * [[KIELER Lightweight Diagrams>>doc:Lightweight Diagrams (KLighD)]]
49 -** (% style="line-height: 1.4285715;" %)Improved integration of the //magnifying lens// (hit {{code language="none"}}alt + ctrl/cmd){{/code}} and //rubber band zoom //(press {{code language="none"}}ctrl/cmd{{/code}} and drag on canvas)
50 -** (% style="line-height: 1.4285715;" %)Enabled the contribution of action invocation buttons (execution of {{code language="none"}}IActions{{/code}}) in the diagram side bar (so far actions could only be executed by clicking on a diagram element of via menu contributions), see related hook in {{code language="none"}}AbstractDiagramSynthesis{{/code}}
51 -** Added {{code language="none"}}editable{{/code}} flag to {{code language="none"}}KText{{/code}} in order to distinguish //cursor selectability// and //editability//
52 -** Enabled the zoom level-based visibility of diagram elements (nodes, ports, edges, labels) and figure elements (fine grained figure details, texts, ...), see {{code language="none"}}setUpperVisibilityScaleBound{{/code}} & {{code language="none"}}setLowerVisibilityScaleBound {{/code}}methods in {{code language="none"}}DiagramSyntheses{{/code}}
53 -** Enabled output-dependent visibility (main diagram, outline, printout, image export) of figure elements (highlightings, fine grained figure details, texts, ...), see corresponding methods in {{code language="none"}}DiagramSyntheses{{/code}}
54 -** Diagram image export now supports tiled exports enabling the export of huge diagrams, which may be prevented by memory limitations in the past
55 -** Contributed appropriate print support and (customizable) print dialog with preview
56 -** Contributed a customized SVG image exporter based on FreeHEP ([[http:~~/~~/freehep.github.io/freehep-vectorgraphics/>>url:http://freehep.github.io/freehep-vectorgraphics/||shape="rect"]]) being able to attach semantic data to the image data
57 -** Contributed generic {{code language="none"}}PortRotationModifier{{/code}} (style modifier) that realizes the rotation of port figures in case ports are moved to a different side by the automatic layout computation
58 -** Added zoom style {{code language="none"}}ZOOM_TO_ACTUAL_SIZE{{/code}}, added corresponding configuration methods in {{code language="none"}}IAction.ActionResult{{/code}}
59 -** Added switch in {{code language="none"}}KlighdSynthesisProperties{{/code}} to deactivate minimal diagram figure size estimation in case size data are already available
69 +* (((
70 +[[KIELER Infrastructure for Meta-Layout>>doc:Infrastructure for Meta Layout (KIML)]]* (((
71 +Made categorization of the Layout View more understandable.
72 +)))
73 +* (((
74 +Added a creation method for VolatileLayoutConfig that makes the far too complicated STATIC_CONFIG of layout managers unnecessary.
75 +)))
76 +)))
77 +* [[KIELER Layout Algorithms>>doc:Layout Algorithms (KLay)]]
78 +** 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.
79 +** 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}}.
80 +** KLay Layered now understands LayoutOptions.NO_LAYOUT, which can be set to exclude particular graph elements from automatic layout.
81 +** KLay Layered now understands a new programmatic option for edge thickness.
82 +** When in hierarchical layout mode, KLay Layered now properly places edge labels of cross-hierarchy edges.
83 +** 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}}):
84 +[[image:attach:merge_hierarchy.png]]
60 60  * [[KGraph Text>>doc:KGraph Text (KGT)]]
61 -** A new option {{code language="none"}}de.cau.cs.kieler.kgraphsynthesis.defaults{{/code}} can enable default values for element sizes and labels to make KGT files more compact.
86 +** 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.
62 62  
63 -=== Important Bugs Fixed in 2014/10 ===
64 -
65 -Among others, the following bugs were fixed in version 2014/10:
66 -
67 -* [[KIELER Layout Algorithms>>doc:Layout Algorithms (KLay)]]
68 -** In KLay Layered, the polyline edge router could produce results where edges overlapped nodes.
69 -** In KLay Layered, the polyline edge router could produce weird results when more than one edge leaves a given port.
70 -
71 71  == Quickstart ==
72 72  
73 73  === Diagram Layout ===
... ... @@ -86,6 +86,22 @@
86 86  * Save a Ptolemy model as a {{code language="none"}}.moml{{/code}} file somewhere.
87 87  * (((
88 88  Download and start our //[[Ptolemy Model Browser>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/tools-and-libraries/||shape="rect"]]//.
106 +
107 +{{tip title="Note for Mac OS Users"}}
108 +Starting with Mac OS X Mountain Lion, trying to start the Ptolemy Model Browser may give you the following error message:
109 +
110 +[[image:attach:damaged_error.png]]
111 +
112 +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//:
113 +
114 +[[image:attach:security_preferences.png]]
115 +
116 +Start the Ptolemy Browser again. This will result in the following warning:
117 +
118 +[[image:attach:untrusted_error.png]]
119 +
120 +Simple click "Open" and you're good to go at last.
121 +{{/tip}}
89 89  )))
90 90  * Open your moml file.
91 91  * 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.
... ... @@ -92,13 +92,6 @@
92 92  
93 93  == Known Problems and Limitations ==
94 94  
95 -* Starting with Mac OS X Mountain Lion, trying to start our software may give you an error message similar to this:
96 -[[image:attach:security1.png]]
97 -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//.
98 -[[image:attach:security2.png]]
99 -Starting our software will now result in the following message:
100 -[[image:attach:security3.png]]
101 -Simply click //Open// and you're good to go.
102 102  * 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.
103 103  * Currently there is no full-blown user documentation integrated. See our [[doc:KIELER.WebHome]] for more information.
104 104  
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -10158157
1 +9471861
URL
... ... @@ -1,1 +1,1 @@
1 -https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/10158157/KIELER Pragmatics Release 2014/10
1 +https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/9471861/KIELER Pragmatics Release 2014/10