XSvit: Getting started
GSvit and XSvit download
GSvit computational core and its GUI (XSvit) are distributed together for all the platforms. For running it you need Gwyddion to see the output images. If you would like to run your calculations on the computer graphics card you need to have a CUDA capable card and a NVIDIA driver installed.
GSvit depends on Gwyddion, so if you plan to modify the source code you have to install Gwyddion's devel package and also devel packages of Gtk+ and GtkGLExt. In case of Gwyddion, please follow the official pages on how to install it properly. In order to build GSvit with GPU support you need to install the CUDA Toolkit. It is available here. In case of Linux, all you need is included in the tarballs but you are free to checkout the svn repository as well. In case of Windows, we provide MS Visual C++ 2012 solution and project files upon request. We plan to put these together with all depencies on the svn repository. Regarding svn we have good experience with TortoiseSVN.
Stable version - Linux
The latest GSvit version is 1.9-rc1 (see NEWS for details). It can be downloaded from Sourceforge.net via following links:
Under Linux environment the software should be installed using standard Linux procedure (./configure; make; make install). You can specify path where to install GSvit by configure option --prefix=path. You need to have CUDA toolkit installed on your computer to run calculations on graphics cards. The PATH variable is used to search for Nvidia's compiler NVCC. In order to find it you need to set this variable accordingly, e.g. export PATH=/usr/local/cuda-5.0/bin:$PATH. Alternatively, you can provide path by option --with-cuda=path) to ./configure. Please don't forget to adjust also your LD_LIBRARY_PATH variable, e.g. export LD_LIBRARY_PATH=/usr/local/cuda-5.0/lib64:/usr/local/cuda-5.0/lib:$LD_LIBRARY_PATH. Or you can update the /etc/ld.so.conf file to contain the CUDA lib directory, however this needs root's permissions.
You also need to have Gwyddion open source software installed to provide output to .gwy files. If you installed Gwyddion in a nonstandard location, you have to set up the PKG_CONFIG_PATH variable, e.g. export PKG_CONFIG_PATH=/home/valtr/run/gwyddion-2.30/lib/pkgconfig:$PKG_CONFIG_PATH. Software is now tested on openSUSE Linux, but hopefully should run on any system with CUDA and Gwyddion.
Linux binary RPMs can also be build from the source code tarball directly by issuing the following command:rpmbuild -tb gsvit-1.9-rc1.tar.xz
We already precompiled the source code for several distributions via openSUSE Build Service. However, these binaries are compiled without GPU support. The build is performed on the following distros (i586 and x86_64 architectures):
The precompiled RPMs are available from the home:miraval project. Please note that the build might succeed also on some other distribution. We just didn't try it.
The GSvit package is also dependent on Gwyddion's libraries. So, you need first to install this package. You can download and install it using procedures described on the official Gwyddion pages or you can use the precompiled binaries hosted on the home:miraval project.
Stable version - Windows
The latest GSvit version is 1.9-rc1 (see NEWS for details). We recommend to first uninstall any pre 1.7 version of GSvit as different set of libraries is distributed since version 1.8. The latest version can be downloaded from Sourceforge.net:
Although we provide a 32 bit binary, it can be run also on 64 bit systems. Since version 1.6 both the computational core (GSvit) and the GUI (XSvit) are distributed in a single package. The installer creates a desktop icon for XSvit, so you can create the necessary files and run the calculation from this environment. Of course, you can run the computational core directly provided all the necessary files were created in beforehand. In that case you have to first start a command prompt (cmd.exe) and run GSvit from there. The default installation path on 64 bit systems is C:\Program Files (x86)\GSvit\bin\gsvit3d.exe. Please note that Gtk, Gwyddion and CUDA libraries are shipped with GSvit. You don't have to install them separately. Since we switched to MS Visual Studio 2015 with version 1.8.2, you need to have runtime libraries for this version. If you have sufficiently new Windows OS (not sure what "sufficiently" is), you should already have them. If not, you can download them from Microsoft websites upon registration to Microsoft.
Development (unstable) version
The development version can be checked out using svn by issuing the following command:svn checkout svn://svn.code.sf.net/p/gsvit/code/trunk gsvit
Under Linux environment the software should be installed using standard Linux procedure except ./configure is replaced by ./autogen.sh. Note that you can pass arguments such as --prefix=path. Under Windows environment we use MS Visual Studio 2012 and can provide gsvit solution a project files together with all the necessary dependencies upon request. This MSVC version is able to compile also 64 bit binaries and indeed we succeded to complete the build. However, the 64 bit XSvit binary behaves oddly so we decided not to publish GSvit-x64 for now.
Older versions can be downloaded from sourceforge.net websites. Note that since version 0.97 MS Windows binary supports GPU.
Frontends and backends
After some trials we decided to build a single GUI (XSvit) instead of separate frontends and backends, however the old frontend is still available here:
GSvit-SNOM is a Gwyddion module for creation of computation initial parameters and files for a extremely simple Scanning near-field optical microscope experiment. Using topography, measured e.g. by atomic force microscope, you can simulate your optical measurement.
Actual (and last) version is 0.9, featuring only simplest model of point source scanning in close proximity to absorptive surface.
(c) Petr Klapetek, 2013