ImageMagick-7.0.0-0/www/openmp.html - platform/external/ImageMagick - Gitiles



 <!DOCTYPE html>
 <html lang="en">
 <head>
   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
     <title>ImageMagick: Parallel Execution with OpenMP</title>
   <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
   <meta name="application-name" content="ImageMagick"/>
   <meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves."/>
   <meta name="application-url" content="http://www.imagemagick.org"/>
   <meta name="generator" content="PHP"/>
   <meta name="keywords" content="parallel, execution, with, openmp, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
   <meta name="rating" content="GENERAL"/>
   <meta name="robots" content="INDEX, FOLLOW"/>
   <meta name="generator" content="ImageMagick Studio LLC"/>
   <meta name="author" content="ImageMagick Studio LLC"/>
   <meta name="revisit-after" content="2 DAYS"/>
   <meta name="resource-type" content="document"/>
   <meta name="copyright" content="Copyright (c) 1999-2015 ImageMagick Studio LLC"/>
   <meta name="distribution" content="Global"/>
   <meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
   <link rel="icon" href="../images/wand.png"/>
   <link rel="shortcut icon" href="../images/wand.ico"/>
   <link rel="stylesheet" href="css/magick.css"/>
 </head>
 <body>
 <div class="main">
 <div class="magick-masthead">
   <div class="container">
     <script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script>    <ins class="adsbygoogle"
          style="display:block"
          data-ad-client="ca-pub-3129977114552745"
          data-ad-slot="6345125851"
          data-ad-format="auto"></ins>
     <script>
       (adsbygoogle = window.adsbygoogle || []).push({});
     </script>
     <nav class="magick-nav">
       <a class="magick-nav-item " href="../index.html">Home</a>
       <a class="magick-nav-item " href="binary-releases.html">Download</a>
       <a class="magick-nav-item " href="command-line-tools.html">Tools</a>
       <a class="magick-nav-item " href="command-line-processing.html">Command-line</a>
       <a class="magick-nav-item " href="resources.html">Resources</a>
       <a class="magick-nav-item " href="api.html">Develop</a>
       <a class="magick-nav-item " href="http://nextgen.imagemagick.org/script/search.php">Search</a>
       <a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
     </nav>
   </div>
 </div>
 <div class="container">
 <div class="magick-header">

 <p class="lead magick-description">Many of ImageMagick's internal algorithms are threaded to take advantage of speed-ups offered by the multicore processor chips and <a href="http://www.openmp.org">OpenMP</a>. OpenMP, is an API specification for parallel programming. If your compiler supports OpenMP (e.g. gcc, Visual Studio 2005) directives, ImageMagick automatically includes support. To verify, look for the OpenMP feature of ImageMagick with this command:</p>
 <pre>
 -> identify -version
 Version: ImageMagick 6.9.1-2 2015-10-14 Q16 http://www.imagemagick.org
 Copyright: Copyright (C) 1999-2016 ImageMagick Studio LLC
 Features: OpenMP
 </pre>
 <p>With OpenMP enabled, most ImageMagick algorithms execute on all the cores on your system in parallel.  ImageMagick typically divides the work so that each thread processes four rows of pixels. As rows are completed, OpenMP assigns more chunks of pixel rows to each thread until the algorithm completes. For example, if you have a quad-core system, and attempt to resize an image, the resizing takes place on 4 cores (8 if hyperthreading is enabled).</p>
 <h4>The Perils of Parallel Execution</h4>
 <p>It can be difficult to predict behavior in a parallel environment. Performance might depend on a number of factors including the compiler, the version of the OpenMP library, the processor type, the number of cores, the amount of memory, whether hyperthreading is enabled, the mix of applications that are executing concurrently with ImageMagick, or the particular image-processing algorithm you utilize. The only way to be certain of the optimal performance, in terms of the number of threads, is to benchmark. ImageMagick includes progressive threading when benchmarking a command and returns the elapsed time and efficiency for one or more threads. This can help you identify how many threads are the most efficient in your environment. Here is an example benchmark for threads 1-8:</p>

 <pre>
 -> convert -bench 40 model.png -sharpen 0x1 null:
 Performance[1]: 40i 0.712ips 1.000e 14.000u 0:14.040
 Performance[2]: 40i 1.362ips 0.657e 14.550u 0:07.340
 Performance[3]: 40i 2.033ips 0.741e 14.530u 0:04.920
 Performance[4]: 40i 2.667ips 0.789e 14.590u 0:03.750
 Performance[5]: 40i 3.236ips 0.820e 14.970u 0:03.090
 Performance[6]: 40i 3.802ips 0.842e 15.280u 0:02.630
 Performance[7]: 40i 4.274ips 0.857e 15.540u 0:02.340
 Performance[8]: 40i 4.831ips 0.872e 15.680u 0:02.070
 </pre>
 <p>Better performance correlates with higher values of IPS (iterations-per-second).  In our example, 8 cores are optimal.  However, in certain cases it might be optimal to set the number of threads to 1 (e.g. <code>-limit thread 1</code>) or to disable OpenMP completely.  To disable this feature, add <code>--disable-openmp</code> to your configure script command line then rebuild and re-install ImageMagick.</p>
 </div>
   <footer class="magick-footer">
     <p><a href="support.html">Donate</a> •
      <a href="sitemap.html">Sitemap</a> •
     <a href="links.html">Related</a> •
     <a href="architecture.html">Architecture</a>
 </p>
     <p><a href="openmp.html#">Back to top</a> •
     <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
     <a href="http://nextgen.imagemagick.org/script/contact.php">Contact Us</a></p>
         <p><small>©  1999-2016 ImageMagick Studio LLC</small></p>
   </footer>
 </div><!-- /.container -->

   <script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
   <script src="http://nextgen.imagemagick.org/js/magick.html"></script>
 </div>
 </body>
 </html>




	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
	<title>ImageMagick: Parallel Execution with OpenMP</title>
	<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
	<meta name="application-name" content="ImageMagick"/>
	<meta name="description" content="ImageMagick® is a software suite to create, edit, compose, or convert bitmap images. It can read and write images in a variety of formats (over 200) including PNG, JPEG, JPEG-2000, GIF, WebP, Postscript, PDF, and SVG. Use ImageMagick to resize, flip, mirror, rotate, distort, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves."/>
	<meta name="application-url" content="http://www.imagemagick.org"/>
	<meta name="generator" content="PHP"/>
	<meta name="keywords" content="parallel, execution, with, openmp, ImageMagick, PerlMagick, image processing, image, photo, software, Magick++, OpenMP, convert"/>
	<meta name="rating" content="GENERAL"/>
	<meta name="robots" content="INDEX, FOLLOW"/>
	<meta name="generator" content="ImageMagick Studio LLC"/>
	<meta name="author" content="ImageMagick Studio LLC"/>
	<meta name="revisit-after" content="2 DAYS"/>
	<meta name="resource-type" content="document"/>
	<meta name="copyright" content="Copyright (c) 1999-2015 ImageMagick Studio LLC"/>
	<meta name="distribution" content="Global"/>
	<meta name="magick-serial" content="P131-S030410-R485315270133-P82224-A6668-G1245-1"/>
	<link rel="icon" href="../images/wand.png"/>
	<link rel="shortcut icon" href="../images/wand.ico"/>
	<link rel="stylesheet" href="css/magick.css"/>
	</head>
	<body>
	<div class="main">
	<div class="magick-masthead">
	<div class="container">
	<script async="async" src="http://localhost/pagead/js/adsbygoogle.js"></script> <ins class="adsbygoogle"
	style="display:block"
	data-ad-client="ca-pub-3129977114552745"
	data-ad-slot="6345125851"
	data-ad-format="auto"></ins>
	<script>
	(adsbygoogle = window.adsbygoogle \|\| []).push({});
	</script>
	<nav class="magick-nav">
	<a class="magick-nav-item " href="../index.html">Home</a>
	<a class="magick-nav-item " href="binary-releases.html">Download</a>
	<a class="magick-nav-item " href="command-line-tools.html">Tools</a>
	<a class="magick-nav-item " href="command-line-processing.html">Command-line</a>
	<a class="magick-nav-item " href="resources.html">Resources</a>
	<a class="magick-nav-item " href="api.html">Develop</a>
	<a class="magick-nav-item " href="http://nextgen.imagemagick.org/script/search.php">Search</a>
	<a class="magick-nav-item pull-right" href="http://www.imagemagick.org/discourse-server/">Community</a>
	</nav>
	</div>
	</div>
	<div class="container">
	<div class="magick-header">

	<p class="lead magick-description">Many of ImageMagick's internal algorithms are threaded to take advantage of speed-ups offered by the multicore processor chips and <a href="http://www.openmp.org">OpenMP</a>. OpenMP, is an API specification for parallel programming. If your compiler supports OpenMP (e.g. gcc, Visual Studio 2005) directives, ImageMagick automatically includes support. To verify, look for the OpenMP feature of ImageMagick with this command:</p>
	<pre>
	-> identify -version
	Version: ImageMagick 6.9.1-2 2015-10-14 Q16 http://www.imagemagick.org
	Copyright: Copyright (C) 1999-2016 ImageMagick Studio LLC
	Features: OpenMP
	</pre>
	<p>With OpenMP enabled, most ImageMagick algorithms execute on all the cores on your system in parallel. ImageMagick typically divides the work so that each thread processes four rows of pixels. As rows are completed, OpenMP assigns more chunks of pixel rows to each thread until the algorithm completes. For example, if you have a quad-core system, and attempt to resize an image, the resizing takes place on 4 cores (8 if hyperthreading is enabled).</p>
	<h4>The Perils of Parallel Execution</h4>
	<p>It can be difficult to predict behavior in a parallel environment. Performance might depend on a number of factors including the compiler, the version of the OpenMP library, the processor type, the number of cores, the amount of memory, whether hyperthreading is enabled, the mix of applications that are executing concurrently with ImageMagick, or the particular image-processing algorithm you utilize. The only way to be certain of the optimal performance, in terms of the number of threads, is to benchmark. ImageMagick includes progressive threading when benchmarking a command and returns the elapsed time and efficiency for one or more threads. This can help you identify how many threads are the most efficient in your environment. Here is an example benchmark for threads 1-8:</p>

	<pre>
	-> convert -bench 40 model.png -sharpen 0x1 null:
	Performance[1]: 40i 0.712ips 1.000e 14.000u 0:14.040
	Performance[2]: 40i 1.362ips 0.657e 14.550u 0:07.340
	Performance[3]: 40i 2.033ips 0.741e 14.530u 0:04.920
	Performance[4]: 40i 2.667ips 0.789e 14.590u 0:03.750
	Performance[5]: 40i 3.236ips 0.820e 14.970u 0:03.090
	Performance[6]: 40i 3.802ips 0.842e 15.280u 0:02.630
	Performance[7]: 40i 4.274ips 0.857e 15.540u 0:02.340
	Performance[8]: 40i 4.831ips 0.872e 15.680u 0:02.070
	</pre>
	<p>Better performance correlates with higher values of IPS (iterations-per-second). In our example, 8 cores are optimal. However, in certain cases it might be optimal to set the number of threads to 1 (e.g. <code>-limit thread 1</code>) or to disable OpenMP completely. To disable this feature, add <code>--disable-openmp</code> to your configure script command line then rebuild and re-install ImageMagick.</p>
	</div>
	<footer class="magick-footer">
	<p><a href="support.html">Donate</a> •
	<a href="sitemap.html">Sitemap</a> •
	<a href="links.html">Related</a> •
	<a href="architecture.html">Architecture</a>
	</p>
	<p><a href="openmp.html#">Back to top</a> •
	<a href="http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
	<a href="http://nextgen.imagemagick.org/script/contact.php">Contact Us</a></p>
	<p><small>© 1999-2016 ImageMagick Studio LLC</small></p>
	</footer>
	</div><!-- /.container -->

	<script src="https://localhost/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
	<script src="http://nextgen.imagemagick.org/js/magick.html"></script>
	</div>
	</body>
	</html>