VISH Development is managed via SVN (under Windows, Tortoise SVN is a recommended tool) . Windows users are recommended to install the MSYS2 base system first and check out Vish into their MSYS2 home folder. Developers need to be familiar with the command line, ideally with bash.

For SVN access, use the following command line (compilation under Linux) for checkout or paste the given SVN url into Tortoise SVN.

svn co https://subversion.assembla.com/svn/vish/trunk vish

Note: do not use git-svn, as this one does not seem to support svn externals which are used in the Vish SVN. The Vish SVN is accessible to registered users only. Register an user account at Assembla.com and provide the respective user ID to the vish management team by sending email to vish@fiberbundle.net or werner (at) fiberbundle.net .

Windows users

Note that with the Vish SVN checkout there comes a file

     INSTALL-MSYS2.txt

that contains instructions, i.e. pacman commands, to install the required packages via MSYS2’s package manager. This txt file can be ran like a shell script. Recommended 4-step installation order:

  1. Install MSYS2 base system
  2. Checkout VISH
  3. Run INSTALL-MSYS2.txt
  4. Execute “mingw32-make” in the vish folder

Additional SVN urls (Advanced Scenarios)

The F5 file format, based in HDF5, is the main I/O file format for Vish. The library with its associated tools, converters and example code is available independently via anonymous checkout. It can be used independently of Vish to be integrated into other applications, in particular simulation software producing data sets for visualization, or as plugin to other post-processing/visualization software:

svn co http://subversion.assembla.com/svn/FiberHDF5/trunk FiberHDF5

Also, HDF5 itself is available via this SVN using static configuration, i.e., no configuration needed, just checkout and do “make”:

svn co https://subversion.assembla.com/svn/FiberHDF5/hdf5/

The Vish/F5 built system is very modular and allows for seamless integration of libraries with automatic detection. Using SVN externals is a very convenient tool to integrate libraries from different SVN repositories to keep them synchronized. The following SVN urls are suitable for such integration as SVN external – they do not provide independent compilation as they do to come with the built system; such is included in Vish or FiberHDF5:

  • We keep a copy of the HDF5 library which uses a simplified build system that is pre-configured for various platforms, it is kept at this URL (but won’t compile just by itself, as it requires to be integrated in the make build system that comes with FiberHDF5 or Vish): 
    https://subversion.assembla.com/svn/FiberHDF5/trunk/src/hdf5-src
  • The HDF5 Streaming VFD is available via: 
    https://subversion.assembla.com/svn/FiberHDF5/trunk/src/hdf5stream
  • The F5 raw library is available via: 
    https://subversion.assembla.com/svn/FiberHDF5/trunk/src/F5
  • F5 Converters: 
    https://subversion.assembla.com/svn/FiberHDF5/trunk/apps/converters
  • F5 Tools: 
    https://subversion.assembla.com/svn/FiberHDF5/trunk/apps/tools
  • F5 Examples: 
    https://subversion.assembla.com/svn/FiberHDF5/trunk/apps/examples

See Compiling Vish for further instructions. For internal usage, sharing code between the Vish and F5 repository is used in several places via SVN externals. This is required for clear dependencies of libraries.