Skip to content

Latest commit

 

History

History
69 lines (52 loc) · 6.55 KB

README.md

File metadata and controls

69 lines (52 loc) · 6.55 KB

VRL-VRN-Generator

A VRL-Studio project for neuron mesh generation with a visual programming workflow and configuration of parameter values and packaging respectively containerizing generated meshes into a .vrn archive for the virtual reality project.

The project enables the end-user to create meshes and mesh bundles in our custom container format (.vrn) derived from the zip file format and is supported to be read and modified in our virtual reality project developed for the Unity gaming platform.

There is only one prerequisite which is a valid installation of the VRL-Studio IDE (and the existence of a precompiled UG4 binary, see ughub for how to build). In particular for this project see the section on howto build and generate meshes below if you have fulfilled the prerequisites.

Please note: For now the path to a precompiled UG4 (ugshell) binary has to be provided manually until further notice. If the developers of the UG4 project will allow our project to include the binary into a derived project, in particular to allow to include the binary as a resource for this project then the only requirement which remains is a valid installation of the VRL-Studio IDE which is supported on Linux, OSX and Windows.

Build status

Linux Windows (WSL) OSX
Linux Windows OSX

Currently JDK >=8 (up to JDK 13) and Gradle >=6 is supported on the operating systems listed above.

Releases, documentation, license and code metrics

GitHub release (latest by date) Docs License: GPL v3 Known Vulnerabilities Codacy Badge GitHub issues open Gitter

CodeQL Release Javadoc README Build

Workflow for mesh generation in VRL-Studio and a user neuron

Demo with user geometry

Workflow for mesh generation in VRL-Studio and a shipped neuron

Demo with shipped geometry

Howto build the project and generate meshes

From source

  1. Clone this repository
  2. (Optional) Edit build.properties and set path to your VRL installation
  3. Either ./gradlew installVRLplugin or ./gradlew jar and manual installation of the compiled project

From release (precompiled)

  1. Download a release from the tab on the right (Chose the file vrl_plugin.zip from any release)
  2. Decompress the vrl-plugin.zip which will create the file VRL-VRN-Generator.jar.
  3. Open VRL-Studio and install the plugin via Plugins->Install Plugin and select VRL-VRN-Generator.jar.

In both cases (re-)start VRL-Studio and then open any of the provided template projects from the menu File->New Project from template from within VRL-Studio.

Familarize with the example workflow, then provide a neuron geometry file in the .swc format from a database like NeuroMorpho.org.

The project ships with an example 1D neuron geometry for which we will create the corresponding 3D geometry, choose the template Mesh Generation - Example workflow with geometry. The user can also provide their own geometry in this project or load explictly the template project anticipated for custom input geometries by choosing Mesh Generation - Example workflow.

Latest ten nightly builds