Skip to content

Commit

Permalink
[README] update readme file
Browse files Browse the repository at this point in the history
  • Loading branch information
mpsonntag committed Oct 20, 2017
1 parent 5443662 commit c96f287
Showing 1 changed file with 28 additions and 16 deletions.
44 changes: 28 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,50 +1,62 @@
About NIX-MX
-------------

The *NIX-MX* project is an extension to [NIX](https://github.com/G-Node/nix) and provides Matlab bindings for *NIX*.
The *NIX-MX* project is an extension to [NIX](https://github.com/G-Node/nix) and provides
Matlab bindings for *NIX*.


Development Status
------------------

The *NIX-MX* project has been developed and tested under Windows 32 and Windows 64 and can easily be built under MacOS. Specifically all of the features of NIX v1.4.0 have been implemented and tests for all of the methods exist and pass.
The *NIX-MX* project has been developed and tested under Windows 32 and Windows 64 and can
easily be built under MacOS. Specifically all of the features of NIX v1.4.1 have been
implemented and tests for all of the methods exist and pass.


Getting Started (Windows 32/64)
-------------------------------

**Quick start packages, Release 1.4.0**
**Quick start packages, Release 1.4.1**

The [quick start packages](https://github.com/G-Node/nix-mx/releases) are compiled under Windows 32/64 and contain all dlls, binary and Matlab files required to use NIX-MX with the respective Windows OS.
The included *NIX* dll is a [stable release 1.4.0 build](https://github.com/G-Node/nix/releases/tag/1.4.0). To use the packages, unzip them into a folder of your choice and run the `startup.m` script from the root folder. Do not change the file/folder structure.
The [quick start packages](https://github.com/G-Node/nix-mx/releases) are compiled under
Windows 32/64 and contain all binary and Matlab files required to use NIX-MX with
the respective Windows OS.
The included *NIX* library is a [stable release 1.4.1 build](https://github.com/G-Node/nix/releases/tag/1.4.1).
To use the packages, unzip them into a folder of your choice and run the `startup.m`
script from the root folder. Do not change the file/folder structure.

The Windows 64 package contains:
- HDF5 dlls (Release 1.8.14)
- NIX dll (stable release 1.4.0 build, compiled using BOOST 1.57.0 and CPPUNIT 1.13.2)
- NIX-MX (Release 1.4.0, 19.09.2017)
- NIX library (stable release 1.4.1 build, compiled using BOOST 1.57.0, CPPUNIT 1.13.2 and HDF 1.10.1)
- NIX-MX (Release 1.4.1)

The Windows 32 package contains:
- HDF5 dlls (Release 1.8.14)
- NIX dll (stable release 1.4.0 build, compiled using BOOST 1.57.0 and CPPUNIT 1.13.2)
- NIX-MX (Release 1.4.0, 19.09.2017)
- NIX library (stable release 1.4.1 build, compiled using BOOST 1.57.0, CPPUNIT 1.13.2 and HDF 1.10.1)
- NIX-MX (Release 1.4.1)

**Build NIX-MX under Windows**

To build NIX-MX under Windows please follow the guide provided at [WinBuild.md](https://github.com/G-Node/nix-mx/blob/master/WinBuild.md). For an automated build, you can also use the `win_build.bat` script after you have read the build guide and set up all required paths and repositories accordingly.
To build NIX-MX under Windows please follow the guide provided at [WinBuild.md](https://github.com/G-Node/nix-mx/blob/master/WinBuild.md).
For an automated build, you can also use the `win_build.bat` script after you have read
the build guide and set up all required paths and repositories accordingly.


Getting Started (macOS)
-------------------------------

**Quick start packages, Release 1.4.0**
**Quick start packages, Release 1.4.1**

The quick start packages (https://github.com/G-Node/nix-mx/releases)
are compiled under macOS Sierra using Matlab 2016b and contain the compiled mex files, nix m-files, tests, and a startup.m script. To use nix-mx unzip the file and run the startup.m script in MATLAB. This simply adds the current folder containing the mex files to the MATLAB path. Do not change the file/folder structure.
are compiled under macOS Sierra using Matlab 2016b and contain the compiled mex files,
nix m-files, tests, and a `startup.m` script. To use nix-mx unzip the file and run the
`startup.m` script in MATLAB. This simply adds the current folder containing the mex
files to the MATLAB path. Do not change the file/folder structure.


In order to have it working the respective NIX C++ library must be installed on the system. The easiest way is using homebrew `brew install nixio`
In order to have it working the respective NIX C++ library must be installed on the
system. The easiest way is using homebrew `brew install nixio`

Once this is done, you may want to test it. Go to the MATLAB command line, change into the nix-mx folder and execute:
Once this is done, you may want to test it. Go to the MATLAB command line, change into
the nix-mx folder and execute:

`>>RunTests`

Expand Down

0 comments on commit c96f287

Please sign in to comment.