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

Summary

Details

Page properties
Parent
... ... @@ -1,0 +1,1 @@
1 +Release Notes
Content
... ... @@ -1,9 +7,3 @@
1 -{{warning title="Warning"}}
2 -Pragmatics 2014-10 hasn't been released yet. These release notes are preliminary!
3 -{{/warning}}
4 -
5 -
6 -
7 7  = KIELER Pragmatics 2014/10 =
8 8  
9 9  * [[Official Project Website>>url:http://www.informatik.uni-kiel.de/rtsys/kieler||shape="rect"]]
... ... @@ -13,78 +13,67 @@
13 13  
14 14  As a bonus, we are co-releasing our KLighD-based **KIELER Ptolemy Browser**.
15 15  
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}}
19 19  
20 -
21 21  
22 -
23 -
24 24  {{toc minLevel="2"/}}
25 25  
26 26  == Installation ==
27 27  
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.
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.
29 29  
30 -* See the [[KIELER Downloads>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/||shape="rect"]] site for download details.
18 +* See the [[KIELER Downloads>>doc:Downloads]] site for download details.
31 31  * KIELER Pragmatics requires an installed Java Runtime Environment >= version 1.5.
32 32  * 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.
33 33  
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.
22 +Also refer to the [[KIELER Downloads>>doc:Downloads]] page to download the KIELER Ptolemy Browser and the KIELER Web Service.
35 35  
36 36  == Release Notes ==
37 37  
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.
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.
39 39  
40 40  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.
41 41  
42 -=== API Changes in 2014/05 ===
30 +=== API Changes in 2014/10 ===
43 43  
44 -This is a summary of the API changes introduced with version 2014/05:
32 +This is a summary of the API changes introduced with version 2014/10:
45 45  
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
46 46  * [[KIELER Lightweight Diagrams>>doc:Lightweight Diagrams (KLighD)]]
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 -)))
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}}
63 63  
64 -=== New Features Included in 2014/05 ===
44 +=== New Features Included in 2014/10 ===
65 65  
66 -Here's a few highlights of what's new in version 2014/05:
46 +Here's a few highlights of what's new in version 2014/10:
67 67  
68 68  * [[KIELER Lightweight Diagrams>>doc:Lightweight Diagrams (KLighD)]]
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]]
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
85 85  * [[KGraph Text>>doc:KGraph Text (KGT)]]
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.
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.
87 87  
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 +
88 88  == Quickstart ==
89 89  
90 90  === Diagram Layout ===
... ... @@ -103,22 +103,6 @@
103 103  * Save a Ptolemy model as a {{code language="none"}}.moml{{/code}} file somewhere.
104 104  * (((
105 105  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}}
122 122  )))
123 123  * Open your moml file.
124 124  * 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.
... ... @@ -125,7 +125,17 @@
125 125  
126 126  == Known Problems and Limitations ==
127 127  
128 -* 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.
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 +* Upon starting the Ptolemy Model Browser, you may get something like this:
103 +[[image:attach:ptBrowserProblem.png]]
104 +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}}.
105 +* 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.
129 129  * Currently there is no full-blown user documentation integrated. See our [[doc:KIELER.WebHome]] for more information.
130 130  
131 131  == Bug Reports, Comments ==
ptBrowserProblem.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +577.6 KB
Content
security1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +52.0 KB
Content
security2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +115.5 KB
Content
security3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +46.2 KB
Content
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -9471861
1 +9471859
URL
... ... @@ -1,1 +1,1 @@
1 -https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/9471861/KIELER Pragmatics Release 2014/10
1 +https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/9471859/KIELER Pragmatics Release 2014/10