See also: OATC Wiki Home
Date: July 13, 2010
Time: 10:45 - 11:30 CEST
Venue: Skype Conference Call
Topic: Finalizing OpenMI Standard 2.0 Beta
Table of contents
Participants
Adrian Harper, Wallingford Software (adrian.harper@wallingfordsoftware.com)
Stef Hummel, Deltares (stef.hummel@deltares.nl)
Jesper Grooss, DHI (jgr@dhigroup.com)
Rob Knapen, Alterra, Wageningen UR (Rob.Knapen@wur.nl)
Standa Vanecek, DHI (s.vanecek@dhi.cz)
Apologies:
Unknown User (don), Deltares (gennadii.donchyts@deltares.nl)
Peter Schade, Bundesanstalt fuer Wasserbau (peter.schade(at)baw.de)
1. Progress towards OpenMI 2 Beta release
1.1. Documentation updates
The three documents, "What's new in OpenMI 2.0", "OpenMI 'in a nutshell'" and "The OpenMI Standard2 interface specification" are ready.
Stef will produced pdfs, and will remove previous versions of the documentation to the depricated part.
Has been done, finished July 12th.
1.2. Source code documentation
Stef will take care that the java and the C# documentation are more or less the same (minor textual differences still exist).
Has been done, finished July 9th.
the Reference Manual yet has to be generated (action Standa)
Standa will indeed regenerates the document, and will remove the "<see ref=..." etc. texts.
2. Remaining issues
- Added by Stef when finishing the beta release documentation.
- More issues added by Rob when finishing the Java version and updating the XSD files.
- Issue added based on Peter Gijsber's email.
Issue |
Description |
status |
decision |
|---|---|---|---|
List/IEnumerable |
At some places IBaseOutput (e.g. Consumers) C#-version returns a list, Java an iterator |
Done by: Rob |
Replace with List<T> |
Initialize(arguments) |
In the C#-version, the arguments argument still has to be removed from Initialize() |
Done by: Stef |
Change in Standard, note as deprecated in SDK |
OpenMI XSD files |
The component and compliancy XSD files still are based on 1.4. Must be extended. |
Done by: Rob |
Ok (TimeSpace compliancy issued postponed) |
TimeSpace compliancy in XSD file |
Decide if TimeSpace compliancy needs to be included in the OpenMICompliancyInfo.xsd file and if so how to do it. |
Postponed |
Mark as deprecated in Beta1 |
Availability loop approach |
The Nut Shell document mentions the loop approach as available but discouraged, whereas the other documents state that it is not available. |
Done by: Adrian |
Modify Nut Shell document |
Regenerate 2 class diagrams |
AdaptedOutputFactory, LinkableComponent |
Done by: Standa |
Ok |
IArgument Array/List |
IBaseLinkableComponent in C# returns an IArgument[], in Java it returns List<IArgument> |
Done by: Stef |
Change C# to return List |
PreferredOrderIsElement |
Method still in ITimeSpaceValueSet, should be removed? |
Java updates done: Rob. |
Remove method |
Move interfaces to TimeSpace extension |
ISpatialDefinition, IElementSet, ITime, ITimeSet could be moved from the base to the TimeSpace extension |
Postponed |
Leave as is for Beta1 |
Update copyright notice |
Add year 2010 to the OpenMI copyright header in all source files |
Java updates done: Rob. |
Update headers |
Distribution package |
Distribute base and timespace extension in a single package or as two? |
Postponed |
Keep as 1 package for Beta1 |
Source code comments |
The javadoc tool reported some source code comment issues, which have been fixed (see SourceForge commit #1511). Needs to be duplicated in C#. |
Done by: Stef |
Ok |
Merge IValueDefinition and IDictionaryItem |
IValueDefinition (with related classes) and IDictionaryItem bought describe data semantics and could be unified. |
<status: open> |
|
<new issue> |
<description> |
<status: open> |
|
Transcript of discussions on the above topics and a few other subjects:
- Loop Approach: Update Nut Shell document to indicate that loop approach is currently not available but will be there as an extension. Pull approach is available now, other options are under investigation by the OpenMI TC. Adrian will update the Nut Shell document. (done)
- Compliancy XSD: Rob will have a look and make some updates. Introduce the concept of extensions and a description field for exchange items. (done) Make as minor changes to the XSD as possible. Fix the lenght typo. (done) Remaining issue: Do we want to include TimeSpace specific exchange item information in the compliancy XSD? If so, what should be included and how?
- Initialize(arguments): Arguments still there in C# because removing them would break to much in the C# SDK. Suggestion to leave it as is in the SDK, but remove from Standard (for now). Add comment in source code of SDK to show the arguments are deprecated. Other option is to add method without arguments and make old method deprecated. Stef will make this change (time allowing). (done)
- List vs IEnumerable: Rob will modify the Java version. Replace iterator with List<T>. (done)
- Packaging Standard as DLL and Jar: Will be done by Rob and Stef. Only include Standard and TimeSpace extension. Leave the rest out. (done)
- Release of the 2.0 Beta: Standa will notify Roger and (other) EC members of availability of the beta (done). Update the OpenMI wiki pages and website accordingly (done). Also notify people who participate in the review process about the new version and changes made according to their input.
3. Next Meeting
To be planned after release and summer holidays, unless urgent issues arise.
