Giter Club home page Giter Club logo

kvs's Introduction

Kyoto Visualization System

Join the chat at https://gitter.im/naohisas/KVS

Kyoto Visualization System (KVS) is a multi-platform, open-source C++ library for developing scientific visualization applications. KVS provides various classes and interfaces, such as isosurace extraction, streamlines and volume rendering, to visualize medical data obtained by computerized tomography or magnetic resonance imaging, numerical data from computational fluid dynamics and so on.

Installation

Getting KVS

The source code of KVS can be downloaded via GitHub as follows:

$ git clone https://github.com/naohisas/KVS.git

Configuration

The environment variable KVS_DIR should be set to an install directory of KVS, and the binary directory KVS_DIR/bin which includes several KVS commands should be add to the PATH variable.

Linux/Mac

export KVS_DIR=~/local/kvs
export PATH=$KVS_DIR/bin:$PATH

Windows

Variable Value
KVS_DIR C:\Program Files\kvs
PATH %PATH%;%KVS_DIR%\bin

Support software package

KVS supports the following software packages. By checking (changing 0:disable to 1:enable) the enable/support flags corresponding to each package in kvs.conf, the functionalities provided from them can be available in KVS.

Package Flag Description
OpenGL KVS_ENABLE_OPENGL Flag for enabling OpenGL functionalities. If '0' (disable) is specified for this flag, the renderer classes implemented with OpenGL functions in the visualization modules will be unavailable.
GLU KVS_ENABLE_GLU Flag for enabling GLU (OpenGL Utility Library) functionalities. KVS can be complied even if this flag is zero.
GLEW KVS_ENABLE_GLEW Flag for enabling GLEW (OpenGL Extension Wrangler Library) functionalities. Note: GLEW needs to be installed to compile KVS on Windows environments.
OpenMP KVS_ENABLE_OPENMP Flag for enabling OpenMP functionalities. OpenMP supported compiler is required.
(Deprecated functions) KVS_ENABLE_DEPRECATED Flag for enabling the deprecated functions and classes in KVS. Note: Although the deprecated functions and classes can be available by checking this flag, but not recommended.
GLUT KVS_SUPPORT_GLUT Flag for supporting GLUT functions. The screen class based on the GLUT is provided. See SupportGLUT for setting information.
GLFW KVS_SUPPORT_GLFW Flag for supporting GLFW functions. The screen class based on the GLFW is provided. Note: GLUT or GLFW is required for developing viewer application with KVS. See SupportGLFW for setting information.
FFmpeg KVS_SUPPORT_FFMPEG Flag for supporting FFmpeg functions. See SupportFFmpeg for setting information.
OpenCV KVS_SUPPORT_OPENCV Flag for supporting OpenCV functions. See SupportOpenCV for setting information.
Qt KVS_SUPPORT_QT Flag for supporting Qt classes. The screen class based on the Qt. See SupportQt for setting information.
Python KVS_SUPPORT_PYTHON Flag for supporting Python in KVS. By using these classes, python codes can be called in c++ codes. See SupportPython for setting information.
MPI KVS_SUPPORT_MPI Flag for supporting MPI functions. Note: MPI compiler is required. See SupportMPI for setting information.
EGL KVS_SUPPORT_EGL Flag for supporting EGL (The Khronos Native Platform Graphics Interface) functions. By checking this flag, GPU-based off-screen class is provided. See SupportEGL for setting information.
OSMesa KVS_SUPPORT_OSMESA Flag for supporting OSMesa (Off-screen Mesa) functions. By checking this flag, CPU-based off-screen class is provided. See SupportOSMesa for setting information.

Build and install

By using the make command, KVS can be easily build and install to KVS_DIR.

  • Windows
$ cd KVS
$ nmake
$ nmake install
  • Linux and Mac OS X
$ cd KVS
$ make
$ make install

Copyright

KVS is released under BSD 3-Clause License. See LICENSE for details.

  • KVS/Source/Core/NanoVG uses nanovg (zlib license) and stb (Public Domain, MIT license).
  • KVS/Source/Core/FileFormat/XML uses tinyxml (zlib license).
  • KVS/Source/SupportMPI/Renderer/ImageCompositor uses 234Compositor (2-clause BSD license).
  • KVS/Source/SupportFFmpeg/AvCpp uses AvCpp (3-clause BSD license).

Citation

Naohisa Sakamoto and Koji Koyamada, KVS: A simple and effective framework for scientific visualization, Journal of Advanced Simulation in Science and Engineering (JASSE), Vol. 2, Issue 1, pp. 76-95, 2015.

kvs's People

Contributors

anderssonm avatar gitter-badger avatar gotamura avatar kioku-systemk avatar monokuro4 avatar naohisas avatar to0603 avatar tom-uchida avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

kvs's Issues

Cmake occur error

Could NOT find GLUT (missing: GLUT_glut_LIBRARY GLUT_INCLUDE_DIR)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.