For loading the model into Modelio, please use the zip-file to load the complete project.
If you have a Provenance project already, you could just load the classes and diagrams by importing the xmi-file only.


Import zip-file into Modelio:
* start Modelio
* File -> Import project
(close all open projects beforehand, if this option is greyed out)


Import only xmi-file into Modelio:
* start Modelio
* open or create an existing project
* right click on the model to open the context menu, choose Import/Export, Import, xmi


Modelimport: import other IVOA data models into Provenance model:
* We should follow the rules set out by Laurent Michel (see vodml/doc/).
* The xmi that can be used for Dataset is:
  https://volute.g-vo.org/svn/trunk/projects/dm/vo-dml/models/ds/datasetModel_uml2p4p1.xmi


Export graphics:
* each diagram has in the diagram window an icon for saving the diagram as an image (png, jpg)
* for a vector file, choose the "print" icon instead and print to pdf or svg;
    (For svg Modelio seems to crop at A4-width, even if printing with "Fit to page". 
     For wide figures rather use pdf)
* I did not find a way to ignore the (white) background directly in Modelio; 
  but it can be removed in a post-processing step:
    - print to svg-file
    - open svg-file with inkscape
    - click the figure, right-click on the figure and choose "Ungroup"
    - click somewhere outside the figure to unselect, then click on the background
      to select only the background and delete it (delete-button)
    - Resize the page to fit the content (no whitespace around figure): 
        - Go to File -> Document Properties; 
        - Click on the arrow next to "Resize page to content ..."
	  to expand the resizing section
        - Click the button "Resize page to drawing"
    - now go to File -> Save a copy and save it as pdf/eps or export a (high resolution) bitmap


Export project for exchange with other users:
* in Modelio, switch to Workspace View:
    - in the top row of icons, click the "project" icon (~ container or folder icon, looks like a blue rectangle, 4th icon from the right side)
    - right-click on the project in the workspace list and choose Export->
    - if this option is greyed out, try closing the project first
    - if still greyed out, then open the project again, maybe this helps


Export xmi only:
* in Modelio, right click on model, choose Import/Export, Export, xmi



Drawing new class diagrams:
* Create a new class diagram
* Add elements (classes) to it by using drag-and-drop from the tree-view
* The links are also pre-defined already for each class! So for connecting the elements, 
	select the main class from which the relation originates in the tree-view,
	pick the desired relation and drag-and-drop it to the diagram. The relation should
	automatically connect the correct classes with the already predefined multiplicity.


Technical problems:
* If you encounter an error like 
  'org.eclipse.swt.SWTException: ... [Unknown Mozilla path (MOZILLA_FIVE_HOME not set)])' 
  when trying to edit a class attribute, this can be fixed on Ubuntu (16.04) with
  sudo apt-get install libwebkitgtk-1.0-0