Releases: grahamrow/Muview2
2.2a2
This is an alpha release of Muview 2.2 with major performance improvements. The downloads here should all be bundled with the necessary Qt libs to get up and running.
Changes since 2.2a1
Fixed major issue #35, thanks for @kongotech for bringing this up.
New Requirements
- OpenGL 3.3 is now required for more advanced shaders.
New Features
- Moved to instanced drawing scheme for drastically increased performance.
- Offload glyph orientation/coloring computation on GLSL shaders for huge performance gains.
- Updated to build with Qt 5.12.3.
- macOS builds now compatible with Mojave and can use dark-mode
Notes
If you are experiencing performance issues check your energy saver preferences to make sure your system (i.e. laptop) is not forcing you to use an integrated GPU rather than your discrete GPU.
2.2a1
This is an alpha release of Muview 2.2 with major performance improvements. The downloads here should all be bundled with the necessary Qt libs to get up and running.
New Requirements
- OpenGL 3.3 is now required for more advanced shaders.
New Features
- Moved to instanced drawing scheme for drastically increased performance.
- Offload glyph orientation/coloring computation on GLSL shaders for huge performance gains.
- Updated to build with Qt 5.12.3.
- macOS builds now compatible with Mojave and can use dark-mode
Notes
If you are experiencing performance issues check your energy saver preferences to make sure your system (i.e. laptop) is not forcing you to use an integrated GPU rather than your discrete GPU.
2.1.3.3
Muview 2.1.2
Changes Since 2.1.1
- Cache is now cleaned promptly to avoid excessive memory usage when scrubbing back and forth repeatedly.
- Fixed issue #12 wherein an empty watch directory caused a crash.
- Added a new binary for Ubuntu 14.04 to address some compatibility issues
Requirements
- OpenGL 3.1 or higher is required
- The Mac build has only been tested on 10.9 Mavericks
- The Windows build has only been tested on Windows 7
Installation
- For Mac and Linux the compilation and installation instructions remain the same as in the previous version.
- For Windows one must installed the MSVC++ 2013 DLLs from https://www.microsoft.com/en-us/download/details.aspx?id=40784
Compilation
- Mac and Linux: compilation remains the same as for Muview 2.0 — use an official Qt version >=5.2 from http://qt-project.org/downloads
- Windows: Use an OpenGL enabled build of Qt >= 5.2, e.g., "Qt 5.3.0 for Windows 64-bit (VS 2013, OpenGL, 636 MB)" version from http://qt-project.org/downloads. This requires MSVC++ 2013 Express, which can be downloaded for free from Microsoft. MinGW 32-bit OpenGL builds should also work. Many DLLs must be copied into the muview.exe directory in order for it to run outside of the Qt Creator environment — details can be found in the deploy/deployWindows.sh script.
Muview 2.1.1
Changes Since 2.1
- Now runs on Windows!
- Fixed an issue #10 that caused a crash when loading a directory not containing any OMF files.
- Fixed an issue where files were loaded multiple times at startup (large performance gains).
- Converted OMF import code to use Qt libraries.
- Less stringent parsing after the OMF data blocks in binary files to maximize chance of success.
Requirements
- OpenGL 3.1 or higher is required
- Qt 5.2 is required for building from source (libraries are included in binary distributions)
- The Mac build and binaries have only been tested on 10.9 Mavericks
- The Windows build has only been tested on Windows 7
Installation
- For Mac and Linux the compilation and installation instructions remain the same as in the previous version.
- For Windows one must installed the MSVC++ 2012 DLLs from http://www.microsoft.com/en-us/download/details.aspx?id=30679
Compilation
- Mac and Linux compilation remains the same — use a Qt version from http://qt-project.org/downloads for the best chance of success.
- On windows, I used the "Qt 5.2.1 for Windows 64-bit (VS 2012, OpenGL, 553 MB)" version available at http://qt-project.org/downloads. This requires MSVC++ 2012 Express, which can be downloaded for free from Microsoft. MinGW OpenGL 32-bit builds should also work. Be mindful that many DLLs must be copied into the muview.exe directory in order for it to run outside of the Qt Creator environment — details can be found in the deploy/deployWindows.sh script.
Muview 2.1
Changes Since 2.0
- Added subdivision functionality via menus and keyboard shortcuts. This addresses issue #7.
- Added a number of controls regarding the display of vectors. These include vector radius, height, tip to base ratio, and inner to outer radius ratio. This addresses issue #6.
- Added the ability to slide the slicing intervals by pressing the shift key while dragging the bars. This allows the user to examine a fixed-width slice across the entirety of a simulation region. This addresses issue #8.
- Fixed an issue with caching when scrubbing the animation bar backwards.
- Fixed an issue where the sprites were being initialized before the creation of a valid OpenGL context.
Requirements
- OpenGL 3.1 or higher is required
- Qt 5.2 is required for building from source (libraries are included in binary distributions)
- The Mac build and binaries have only been tested on 10.9 Mavericks
Installation
- Compilation and installation instructions remain the same as in the previous version.
Muview 2.0
Changes Since 2.0b3
- Now handles OVF file errors gracefully
- Fixed bug with loading OVF binary4 files
- Fixed bug that, while watching a directory, prevented the last file from being loaded
Requirements
- OpenGL 3.1 or higher is required
- Qt 5.2 is required for building from source (libraries are included in binary distributions)
- The Mac build and binaries have only been tested on 10.9 Mavericks
Binary Distributions
Linux
The Linux binary is statically linked to Qt libraries, and does not require their presence. There is a Makefile included with the Linux binary that, upon execution of make install, puts the muview binary in /usr/local/bin as well as installing icons and a .desktop file on Ubuntu-like systems. This facilitates such conveniences as opening .omf and .ovf files by double clicking them (the same benefits can be had when building from source.)
Since Qt5 depends on xcb for X11 bindings, so you may need to install some libraries from your package manager. On Ubuntu, for example:
sudo apt-get install libfontconfig1 libfreetype6 libxcb1
Mac
Qt is included as a framework in the application bundle. Just mount the .dmg and off you go!
Windows
Still looking for help deploying windows binaries.
Building from Source
Either download the release source below or fork the code from github with
git clone https://www.github.com/grahamrow/Muview2.git
Linux
Install a Qt distribution from http://qt-project.org/downloads, and make sure the qmake supplied with that distribution is at the front of your $PATH. Then run (on a clean tree)
qmake && make -j10
sudo make install
The install puts the muview binary in /usr/local/bin, as well as installing icons and a .desktop file on Ubuntu-like systems.
Mac OSX
The build procedure is the same as on Linux. I recommend using the official Qt distribution rather than one from brew or macports.
Windows
Building locally on windows using MSVC 2012 Express works fine. Install the Windows Qt 5.2.1 VS 2012 64 bit OpenGL version from http://qt-project.org/downloads and build the source code from within Qt Creator for the most predictable results.
Muview 2.0b3
A reasonably stable candidate for the first release of Muview 2.0.
This is Muview2 displaying a transient state in Standard Problem 4. The interface allows for 3D navigation, slicing of the geometry for quick cross-sectional views, and animation via a slider that scrubs through loaded files. Images and image sequences may be saved quickly via menu options.
Changes Since 2.0b2
- Now building against Qt 5.2.1
- MacOSX build now works, binary distribution comes bundled with necessary Qt Frameworks
- Linux binary distribution is now statically linked to Qt Libraries
- Boost no longer needed, a custom multidimensional array has been implemented
- Source tree rearranged such that only one compilation step is necessary
- Qxt span slider code substantially cleaned up, no longer throws errors on Windows.
Requirements
- OpenGL 3.1 or higher is required
- Qt 5.2.1 is recommended for building from source (5.1 may be sufficient, but is untested)
- The Mac build and binaries have only been tested on 10.9 Mavericks
- Some extra dependencies are required on linux, see the notes below...
Binary Distributions
These should obviate the need for manually installing Qt libraries.
Linux
There is a Makefile included with the Linux binary that, upon execution of make install, puts the muview binary in /usr/local/bin as well as installing icons and a .desktop file on Ubuntu-like systems. This facilitates such conveniences as opening .omf and .ovf files by double clicking them (the same benefits can be had when building from source.)
Since Qt5 depends on xcb for X11 bindings, so you may need to install some libraries from your package manager. On Ubuntu, for example:
sudo apt-get install libfontconfig1 libfreetype6 libxcb1
Mac
Qt is included as a framework in the application bundle. Just mount the .dmg and off you go!
Building from Source
Either download a tarball or fork the code from github with
git clone https://www.github.com/grahamrow/Muview2.git
Linux
Install a Qt distribution from http://qt-project.org/downloads, and make sure the qmake supplied with that distribution is at the front of your $PATH. Then run (on a clean tree)
qmake && make -j10
sudo make install
The install puts the muview binary in /usr/local/bin, as well as installing icons and a .desktop file on Ubuntu-like systems.
Mac OSX
The build procedure is the same as on Linux. I recommend using the official Qt distribution rather than one from brew or macports
Windows
Building currently works and program launches, but as I do not have access to a non-virtual installation I have not been able to properly test the build.
Known Issues
- #3 Some graphics cards apparently glitch with the included diffuse shader (please let me know if you also experience these issues!)
- Error handling for poorly formatted OMF and OVF files is NOT graceful. The application will probably just crash.
Mumax 2.0b2
A reasonably stable candidate for the first release of Muview 2.0. Much has changed since previous versions but here are some of the highlights.
Changes Since 2.0b1
- Fixed a few problems with color scales and sprites when displaying scalar fields
- #1: libomf now compiled under qmake
- #2: Migrated to OpenGL 3.1 profile for improved compatibility
- Compiles on MacOSX under Qt 5.2 (still has problems with OpenGL context)
- Added desktop file and icons for linux distribution
Requirements
- Qt5 libs at run time
- Boost and qt5 dev packages are required for building
Building
Linux
After installing the dependencies from repositories, run the following
cd libomf
qmake && make
cd ..
qmake && make
sudo make install
The install puts the muview binary in /usr/local/bin, as well as installing icons and a .desktop file on Ubuntu-like systems. This facilitates conveniences such as opening .omf and .ovf files by double clicking them!
Mac OSX
On 10.9 Mavericks, I was able to get a succesful build using libraries installed through brew. I did NOT have any luck with the official Qt5 environment.
brew install boost
brew install --developer qt5
The latter takes a while to compile (20 mins on an old system.) Now run the same command chain as above, where qmake is replaced by:
/usr/local/Cellar/qt5/5.2.1/bin/qmake -spec macx-g++
to ensure that you are using the boost version. This generates muview.app — which on my system runs but doesn't load a proper GL context and thus cannot actually display anything. Suggestions are welcome.
Windows
Please help me out if any of you are interested...
Muview 2.0b1
A reasonably stable candidate for the first release of Muview 2.0. Much has changed since previous versions but here are some of the highlights.
New Features
- Save images and image sequences, copy images to clipboard
- Set the quantity that uses the color scale (x,y,z,phi,all...)
- Set the color scale (HSL, grayscale, blue/red)
- Improved lighting
- Unfollow directories that were once followed (untested)
Requirements
- Qt5 libs are required
- Boost and qt5 dev packages are required for building
Building
cd libomf
qmake && make
cd ..
qmake && make
Installing
The binary should be installed to /usr/local/bin, and a muview.desktop file to /usr/share/applications on Ubuntu-like systems by running
make install