human2b / scalismo-faces

Scalable Image Analysis and Shape Modelling: Module to work with 2d images, with a focus on face images

scalismo-faces

This is a framework for shape modeling and model-based image analysis in scala. It is based on the scalismo library for shape modelling. It originates from the Graphics and Vision research group at the University of Basel, Switzerland.

The library contains tools for image processing, rendering and handling of the Morphable Model. A tutorial on how to use this software and about the concepts of Analysis-by-Synthesis face image analysis is available from the University of Basel under http://gravis.dmi.unibas.ch/PMM/.

Usage

sbt

Add the dependency to your build.sbt:

libraryDependencies += "ch.unibas.cs.gravis" %% "scalismo-faces" % "0.9.0"
resolvers += Resolver.bintrayRepo("unibas-gravis", "maven")

Getting Started

• The following code creates a checkerboard image and save it to disk:

import scalismo.color.RGB
import scalismo.faces.image.PixelImage
import scalismo.faces.io.PixelImageIO
import java.io.File

object ChessExample extends App {
  val checkerboard = PixelImage(128, 128, {(x, y) => if ((x+y)%2 == 0) RGB.White else RGB.Black})
  PixelImageIO.write(checkerboard, new File("checkerboard.png")).get
}

To execute it place the code in a file src/main/scala/ChessExample.scala and run sbt run from your project directory where you have the build.sbt file with at least the lines described under the former point sbt.

Documentation

• Probabilistic Fitting Tutorial from the University of Basel

There is also a scalismo-faces google group for general questions and discussion.

Maintainers

The project is developed and maintained by the Graphics and Vision Research group, University of Basel in collaboration with Shapemeans GmbH. The current maintainers of the project (people who can merge pull requests) are:

• Ghazi Bouabene
• Bernhard Egger
• Andreas Morel-Forster
• Thomas Gerig
• Andreas Schneider
• Sandro Schönborn

Contribution

Contribution is welcome:

• You can report bugs and issues using the issue tracker on Github
• You can submit small pull requests to contribute:
  • Open an issue and discuss what you would like to add
  • Submit work as a small pull request, suitable for quick review
• If you would like to get involved in development, contact us.

License

Apache License, Version 2.0, details see LICENSE

Copyright 2016, University of Basel, Graphics and Vision Research

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.