Scalismo-ui is a library for visualizing statistical shape models and related 3D objects, such as 3D meshes or 3D medical images. It is designed to complement the Scalismo framework and to make it easy to build graphical shape modelling applications and to allow for "visual debugging" of complex image analysis algorithms. Further, it can be used as a standalone application for visualizing shape models, 3D meshes and 3D medical images.
Scalismo-ui was developed and is currently maintained by the Graphics and Vision Research Group of the University of Basel.
We believe that visualization is a key factor in the development of complex image analysis algorithm and that visual inspection is the most powerful debugging tool. But it is only used if visualization is simple to use. In Scalismo-ui, every object can be visualized by adding only one line of code:
val objectView = ui.show(group, object, "name of object")It is equally simple to change the representation of the object, such as in this example its color
objectView.color = Color.REDAdd the following dependency to your build.sbt:
resolvers += Resolver.bintrayRepo("unibas-gravis", "maven")
libraryDependencies += "ch.unibas.cs.gravis" %% "scalismo-ui" % "0.13.0"The graphical user interface can be called from an application using the command
val ui = ScalismoUI()
Scalismo-ui can also be used as a standalone application. Simply call
sbt run
to start the application. For more frequent use of scalismo-ui, it is convenient to have the application available as a jar file. This can be built by calling
sbt assembly
The resulting jar file is target/scala-2.12/scalismo-ui.jar
Checkout the Scalismo-tutorials for examples how to use Scalismo-ui in your programs.
Scalismo-ui features a simple plugin api. We hope to be able to add documentation soon. For the moment, check out the source file SimplePluginAPI.scala
For questions regarding scalismo-ui or suggestions for improvements, please post to the mailing list scalismo google group.
- University of Basel, Graphics and Vision research: @unibas-gravis, homepage
- Marcel Luethi, @marcelluethi
- Ghazi Bouabene, @ghazi-bouabene
Contributions to scalismo-ui are very welceom. Please send us a pull request from your fork of this repository! We do have to ask you to sign the contributors agreement before we can merge any of your work into our code base.
All code is released under the GNU public license, available here.
Copyright, University of Basel, 2017.