Fast Semi Causal Nonparametric Markov Random Field Texture Synthesis

My Home Page

Original Version

Fast Version on a Gaussian Pyramid with K Nearest Search

This algorithm is a cut down version of the algorithm published in IEEE Transactions on Image Processing 1998. In this version, it has been rewritten for a single cpu machine. To maintain speed of synthesis, the update function pUpdateFn() has been set to return the maximum value. If this was modified to return a portion of the maximum value, then the synthesis would take longer, but there would be a gain in quality. If you do decide to modify the code, be careful, as I have not put in any safeguard checks. Best to fully understand the whole code, before modifying it.

This fast version implements a modification based on Ashikhmin's Synthesizing Natural Textures. As noted in his work, the L2 norm may not be the best measure to test for perceptual similarity between two neighbourhoods. Instead, we may note that if we are only taking pixels from the input image (and not sampling from a larger distribution), then when we iterate a respective pixel, we can be assured that each of its defined neighbours occur within the input image. Speed can be gained if, instead of doing a exhaustive search, we only sample from those pixels which have the same neighbour. In this algorithm I have modified Ashikhmin's approach by using my previous algorithm, and sampling from all pixels which have at least one of its neighbours the same colour as its respective neighbour of the pixel being iterated.

Recently there has been quite an influx of nonparametric sampling techniques for texture synthesis (,here is a brief list). This is because it has been the nonparametric models that have had the greatest success at synthesising arbitrary textures. This technique uses a multiscale approach, which has the advantage that only a small neighbourhood is required.

However the basis of the algorithm first appeared in:

Source Code

Download Source Code Copyright (C) 2002, by Rupert Paget, all rights reserved.

The source code requires ImageMagick to be preinstalled. To compile the code, run gmake in the parent directory. There are two makefiles, one in parent directory, and in the src directory. If the code does not compile, both makefiles will need to be edited. I have written one for a sun (default) and one for an sgi machine, but I give no guarantees that they will work.

The program is executed with the following command

nonparaMRF_fast [-l levels] [-n neighOrder] [-s] [-t treeMax] [-c] [-x cols] [-y rows] [-m maskfile] [-h] texturefile


levels =
number of gray levels the image will be compacted to. Reducing the number from 255, will probably not improve the synthesis, and will most likely increase the run time.
neighOrder =
number to signify neighbourhood size. See neighbourhoods for schematics of the neighbourhoods used in the texture synthesis algorithm.
s =
if set, the neighbourhood becomes a square neighbourhood.
treeMax =
maximum quadtree height. The algorithm will not allow the quadtree height to be set to a value that will allow either the input image or output image to be reduced to less than a 2x2 pixel image.
c =
if set, the output image is defined to be toroidal (ie cyclic) where each border matches with its opposite border.
cols =
number of columns in the output image. If undefined, number columns in the output image will equal number columns in the input image.
rows =
number of rows in the output image. If undefined, number rows in the output image will equal number rows in the input image.
maskfile =
is a mask image that must be the same size as the input texture image. Only where the mask image is non zero is the input image used.
h =
if set, will mean that just usage and default values will be displayed. This will also occur if no input values are given.
texturefile =
is the input texture image that is to be synthesised.

Default values are : levels = 256, neighOrder = 1, square = false, treeMax = 6, cyclic = false

Schematic of the neighbourhoods used in the texture synthesis algorithmSchematic of the neighbourhoods used in the texture synthesis algorithm

Synthesis run times for various input parameters

These times were compiled on a distributed system of mainly SunBlades 100: 500 MHz, 256 MBytes RAM. The input textures were 128x128 pixel images, and the output synthesised textures were 256x256 pixel images. The run times are basically dependent on output image size and the type of input texture. This is due to the nearest neighbour search algorithm used in the code. If the input texture is fairly uniform in colour, then the search algorithm will be more of an exhaustive search, and therefore more dependent on input image size. Time stamps are in "Days Hours:Minutes:Seconds".

Neighbourhood# of TestsMin Run TimeMax Run TimeMean Run TimeStdev Run Time
1 1650 0:03:470 0:20:340 0:04:450 0:06:46
1 -c 1650 0:03:450 0:12:580 0:04:350 0:01:26
1 -s 1650 0:01:420 0:09:230 0:02:170 0:00:59
1 -s -c1650 0:01:430 0:09:530 0:02:190 0:00:59
2 1650 0:01:430 0:08:380 0:02:170 0:00:51
2 -c 1650 0:01:430 0:07:280 0:02:200 0:00:58
2 -s 1650 0:01:520 0:31:540 0:04:420 0:07:57
2 -s -c1650 0:01:510 0:38:090 0:05:040 0:08:15
3 1650 0:01:440 0:17:320 0:02:310 0:01:35
3 -c 1650 0:01:430 0:07:010 0:02:150 0:00:51
3 -s 1650 0:01:590 1:44:450 0:12:050 0:19:34
3 -s -c1650 0:01:580 1:49:560 0:13:280 0:22:08
4 1650 0:01:450 0:10:540 0:02:410 0:01:34
4 -c 1650 0:01:450 0:10:540 0:02:460 0:01:32
4 -s 1650 0:02:130 4:47:030 0:27:170 0:46:45
4 -s -c1650 0:02:080 4:20:260 0:30:180 0:52:10


Additional Information

For More Information

Email Rupert Paget at:

Valid HTML 4.01!

This site was proofread by
English Editing Experts.