August 2026
I've taken out some dependecies on rarley used libraries to make it easier to install and run:
https://users.aber.ac.uk/bpt/jpsychomorph/version7/PsychoMorphLite.jarIn theory double clicking it would work, but the MacOS security settings don't let me, but I can run it from the Terminal using:
java -jar PsychoMorphLite.jar
(when in the same folder as the jar file).
You will probably find that you want more memory allocated to it than the default, you can use the additional command line switch -Xmx4g to allocate 4Gb of ram i.e.
java -jar PsychoMorphLite.jar -Xmx4g
A basic guide to using the software was written by Clare Sutherland:
A basic guide to PsychomorphYou can download version 7.1 from here:
PsychoMorph7.1.zipwhich you should be able to run from the command line (windows Command Prompt, or Terminal in MacOS) after navigating to the extracted folder, using something like:
java -cp dist/*;deploylib/* -Xmx4000m -Djava.security.policy=applet.policy Facemorph.psychomorph.PsychoMorphForm
for windows, or for macos use this version:
java -cp dist/*:lib/* -Xmx4000m -Dapple.laf.useScreenMenuBar=true -Djava.security.policy=applet.policy Facemorph.psychomorph.PsychoMorphForm
It was compiled with java open jdk 11 (so you may need to upgrade/downgrade your java version to run it). I got it from here (need to scroll down a bit to find the right version):
https://www.oracle.com/java/technologies/javase-downloads.htmlIf you get an "out of memory error" you can use a smaller value for the max heap size e.g.
-Xmx1000m
asks for 1Gb of heap space, rather than the 4Gb in the commands above.
Some example images to start playing with are available here images.zip
Help pages are provided on the wiki. Details of the API (e.g. for writing plugins) are available here.
Some other (possibly) useful data is available here extra.zip. This includes some masks, symmetry file and wavelet filters.
Please reference at least one of the following papers in any published work using the software.
B. Tiddeman, Facial feature detection with 3D convex local models IEEE Conference on Face and Gesture Recognition, (to appear) 2011.
J. Chen and B. Tiddeman, Multi-Cue Facial Feature Detection and Tracking under Various Illuminations, International Journal of Robotics and Automation, Vol 25, No. 2, 2010.
M. Yu and B. Tiddeman, FACE DETECTION AND TRACKING WITH 3D PGA CLM, Int. Conf. on Computer Vision Theory and Applications (VISAPP), paper 111, 2010.
B. Tiddeman, M. Stirrat and D. Perrett, Towards realism in facial transformation: results of a wavelet MRF method Computer Graphics Forum, Eurographics conference issue, Vol 24, No 1-5, Sept 2005.
B. Tiddeman, M. Stirrat and D. Perrett, Towards realism in facial prototyping: results of a wavelet MRF method, Theory and Practice of Computer Graphics, June 2005.
B. Tiddeman, D.M. Burt and D. Perrett, Computer Graphics in Facial Perception Research, IEEE Computer Graphics and Applications, Vol 21, No. 5, pp 42-50 Sept/Oct 2001.
Bernard Tiddeman Blending Textured Images using a Non-parametric Multiscale MRF Method 12th Int. Conf. in Central Europe on Computer Graphics, Visualization and Computer Vision 2004 (WSCG2004) 2-6 Feb 2004, University of West Bohemia, Plzen, Czech RepublicB.Tiddeman and D. Perrett, Moving Facial Image Transformations Based On Static 2D Prototypes, Proc. 9th Int. Conf. In Central Europe on Computer Graphics, Visualization and Computer Vision 2001, Pilsen, Czech Republic, Feb 5-9 2001.
B. Tiddeman and D. Perrett, Transformation of Dynamic Facial Image Sequences Using Static 2D Prototypes, The Visual Computer, Vol 18, No. 4, pp. 218-225, June 2002.
Good luck!