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.
(thumbs up) 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).
(thumbs up) Has been done, finished July 9th.
(warning) the Reference Manual yet has to be generated (action Standa)
(thumbs up) 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
Pdf done by: Stef

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.
C# updates done: Stef

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.
C# updates done: Stef
(Standard2 only, SDK to be done)

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>

(question)

<new issue>

<description>

<status: open>

(question)

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.