Skip to content

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

License

Notifications You must be signed in to change notification settings

unibas-gravis/scalismo-faces

Repository files navigation

scalismo-faces

Build Status

Download

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.90.0"

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

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:

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.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages