Skip to content
Scalable Image Analysis and Shape Modelling: Module to work with 2d images, with a focus on face images
Branch: master
Clone or download
Latest commit 3b48df9 Mar 13, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github improvded issue template Jan 24, 2018
project updated dependency and tooling versions Feb 25, 2019
src No vertex color mesh 3d (#115) Feb 18, 2019
.gitignore empty start of scalismo-faces Nov 15, 2016
.travis.yml Scala 2.12 (#39) Apr 11, 2017
LICENSE.txt Update and rename LICENSE to LICENSE.txt Nov 21, 2016
README.md
build.sbt

README.md

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

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.
You can’t perform that action at this time.