1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
|
<!DOCTYPE html>
<html lang="en" data-bs-theme="dark">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
<!-- Title and Description -->
<title>ImageMagick | Parallel Execution with OpenMP</title>
<meta name="description" content="ImageMagick is a powerful open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for developers, designers, and researchers." />
<!-- Canonical URL -->
<link rel="canonical" href="openmp.html" />
<!-- Robots -->
<meta name="robots" content="index, follow" />
<!-- Theme Color -->
<meta name="theme-color" content="#000000" />
<!-- Verification Tags -->
<meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4" />
<!-- Favicon and Apple Icon -->
<link rel="shortcut icon" href="../images/wand.png" type="images/png" />
<link rel="apple-touch-icon" href="../images/wand.png" type="images/png" />
<!-- Preconnect for External Resources -->
<link rel="preconnect" href="../index.html" />
<!-- Stylesheets -->
<link rel="preload" href="assets/bootstrap.min.css" as="style" crossorigin="anonymous" />
<link rel="stylesheet" href="assets/bootstrap.min.css" />
<!-- Accessibility Enhancement -->
<style>
html {
scroll-padding-top: 70px;
}
</style>
<!-- Open Graph Meta Tags -->
<meta property="og:title" content="ImageMagick | Parallel Execution with OpenMP" />
<meta property="og:description" content="ImageMagick is a powerful open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for developers, designers, and researchers." />
<meta property="og:image" content="../images/logo.png" />
<meta property="og:logo" content="../images/logo.png" />
<meta property="og:url" content="../www/openmp.html" />
<meta property="og:type" content="website" />
<meta property="og:site_name" content="ImageMagick" />
<meta property="og:locale" content="en_us" />
<!-- Twitter Card Meta Tags -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@imagemagick" />
<meta name="twitter:creator" content="@imagemagick" />
<meta name="twitter:title" content="ImageMagick | Parallel Execution with OpenMP" />
<meta name="twitter:description" content="ImageMagick is a powerful open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for developers, designers, and researchers." />
<meta name="twitter:image" content="../images/logo.png" />
<meta name="twitter:image:alt" content="ImageMagick logo and tag line" />
<!-- JSON-LD Structured Data -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "SoftwareApplication",
"name": "ImageMagick",
"url": "../www/openmp.html",
"image": "../images/logo.png",
"description": "ImageMagick is a powerful open-source software suite for creating, editing, converting, and manipulating images in over 200 formats. Ideal for developers, designers, and researchers.",
"applicationCategory": "Multimedia",
"operatingSystem": "Windows, macOS, Linux, Unix",
"softwareVersion": "7.1.2-1",
"license": "../www/license.html",
"creator": {
"@type": "Organization",
"name": "ImageMagick Studio LLC",
"url": "https://imagemagick.org"
},
"keywords": [
"Parallel Execution with OpenMP",
"image processing software",
"image conversion tool",
"batch image editing",
"open-source image editor",
"ImageMagick command-line",
"resize images ImageMagick",
"crop and rotate images",
"ImageMagick tutorial",
"ImageMagick automation",
"ImageMagick for developers",
"ImageMagick CLI",
"ImageMagick filters and effects",
"ImageMagick scripting",
"ImageMagick API integration"
],
"sameAs": [
"https://github.com/ImageMagick",
"https://x.com/imagemagick"
],
"offers": {
"@type": "Offer",
"price": "0.00",
"priceCurrency": "USD"
}
}
</script>
<!-- Google Custom Search -->
</head>
<body>
<script>
function setTheme(theme) {
localStorage.setItem('theme', theme);
updateThemeIcon(theme);
document.documentElement.setAttribute('data-bs-theme', theme === 'auto' ? getSystemTheme() : theme);
}
function getSystemTheme() {
return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
}
function updateThemeIcon(theme) {
const iconMap = {
light: '☀️',
dark: '🌙',
auto: '🌓'
};
document.getElementById('currentThemeIcon').textContent = iconMap[theme] || '🌓';
}
document.addEventListener('DOMContentLoaded', () => {
const savedTheme = localStorage.getItem('theme') || 'auto';
setTheme(savedTheme);
});
</script>
<nav class="navbar navbar-expand-md navbar-dark bg-dark fixed-top">
<div class="container-fluid">
<a class="navbar-brand fw-bold" href="../index.html" title="$meta->sitename;">
ImageMagick </a>
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#magick-navbars" aria-controls="magick-navbars" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse" id="magick-navbars">
<ul class="navbar-nav me-auto">
<li class="nav-item">
<a class="nav-link " href="download.html">Download</a>
</li>
<li class="nav-item">
<a class="nav-link " href="../www/command-line-tools.html">Tools</a>
</li>
<li class="nav-item">
<a class="nav-link " href="command-line-processing.html">CLI</a>
</li>
<li class="nav-item">
<a class="nav-link " href="develop.html">Develop</a>
</li>
<li class="nav-item">
<a class="nav-link" rel="noopener" target="_blank" href="https://github.com/ImageMagick/ImageMagick/discussions">Community</a>
</li>
<li class="nav-item ms-4">
<iframe src="https://github.com/sponsors/ImageMagick/button" title="Sponsor ImageMagick" height="35" width="107" style="border: 0;"></iframe>
</li>
</ul>
<ul class="navbar-nav ms-auto">
<li class="nav-item dropdown">
</li>
<li class="nav-item dropdown ms-2">
<a class="nav-link dropdown-toggle" href="#" id="themeDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
<span id="currentThemeIcon">🌓</span>
</a>
<ul class="dropdown-menu dropdown-menu-end" aria-labelledby="themeDropdown">
<li><a class="dropdown-item" href="#" onclick="setTheme('light')">☀️ Light</a></li>
<li><a class="dropdown-item" href="#" onclick="setTheme('dark')">🌙 Dark</a></li>
<li><a class="dropdown-item" href="#" onclick="setTheme('auto')">🌓 Auto</a></li>
</ul>
</li>
</ul>
</div>
</div>
</nav>
<div class="col-lg-8 mx-auto text-body-secondary pt-5 pt-lg-5">
<header class="d-flex align-items-center pb-3 mb-5 border-bottom">
<div class="mt-3 ms-3">
<a href="../index.html" class="text-decoration-none">
<h1 class="fs-2 mb-1">Parallel Execution with OpenMP</h1>
</a>
<h2 class="fs-5 text-muted">ImageMagick</h2>
</div>
</header>
<main class="container">
<div>
<p class="lead">Many of ImageMagick's internal algorithms are threaded to take advantage of speed-ups offered by the multicore processor chips and <a href="../index.html">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 class="p-3 mb-2 text-body-secondary bg-body-tertiary"><samp>$ magick identify -version
Version: ImageMagick 7.0.10-50 2021-01-04 Q16 https://imagemagick.org
Copyright: © 1999-2021 ImageMagick Studio LLC
Features: OpenMP(4.5)</samp></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 64 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>
<p>You can further increase performance by reducing lock contention with the <a href="http://goog-perftools.sourceforge.net/doc/tcmalloc.html">tcmalloc</a> memory allocation library. To enable, add <samp>--with-tcmalloc</samp> to the <samp>configure</samp> command-line when you build ImageMagick.</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 class="p-3 mb-2 text-body-secondary bg-body-tertiary"><samp>$ magick -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</samp></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. <samp>-limit thread 1</samp>) or to disable OpenMP completely. To disable this feature, add <samp>--disable-openmp</samp> to your configure script command line then rebuild and re-install ImageMagick.</p>
</div>
</main><!-- /.container -->
<footer class="text-center pt-5 my-5 text-body-secondary border-top">
<div class="container-fluid">
<a href="security-policy.html">Security</a> •
<a href="news.html">News</a>
<a href="#"><img class="d-inline" id="wand" alt="And Now a Touch of Magick" width="16" height="16" src="../images/wand.ico" /></a>
<a href="../www/links.html">Related</a> •
<a href="../www/sitemap.html">Sitemap</a>
<br />
<a href="../www/support.html">Sponsor</a> •
<a href="../www/cite.html">Cite</a> •
<a href="http://pgp.mit.edu/pks/lookup?op=get&search=0x89AB63D48277377A">Public Key</a> •
<a href="../www/https://imagemagick.org/script/contact.php">Contact Us</a>
<br />
<a href="https://github.com/imagemagick/imagemagick" rel="noopener" target="_blank" aria-label="GitHub"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 512 499.36" width="2%" height="2%" role="img" focusable="false"><title>GitHub</title><path fill="currentColor" fill-rule="evenodd" d="M256 0C114.64 0 0 114.61 0 256c0 113.09 73.34 209 175.08 242.9 12.8 2.35 17.47-5.56 17.47-12.34 0-6.08-.22-22.18-.35-43.54-71.2 15.49-86.2-34.34-86.2-34.34-11.64-29.57-28.42-37.45-28.42-37.45-23.27-15.84 1.73-15.55 1.73-15.55 25.69 1.81 39.21 26.38 39.21 26.38 22.84 39.12 59.92 27.82 74.5 21.27 2.33-16.54 8.94-27.82 16.25-34.22-56.84-6.43-116.6-28.43-116.6-126.49 0-27.95 10-50.8 26.35-68.69-2.63-6.48-11.42-32.5 2.51-67.75 0 0 21.49-6.88 70.4 26.24a242.65 242.65 0 0 1 128.18 0c48.87-33.13 70.33-26.24 70.33-26.24 14 35.25 5.18 61.27 2.55 67.75 16.41 17.9 26.31 40.75 26.31 68.69 0 98.35-59.85 120-116.88 126.32 9.19 7.9 17.38 23.53 17.38 47.41 0 34.22-.31 61.83-.31 70.23 0 6.85 4.61 14.81 17.6 12.31C438.72 464.97 512 369.08 512 256.02 512 114.62 397.37 0 256 0z"/></svg></a> •
<a href="https://twitter.com/imagemagick" rel="noopener" target="_blank" aria-label="Twitter"><svg xmlns="http://www.w3.org/2000/svg" class="navbar-nav-svg" viewBox="0 0 300 300" width="2%" height="2%" role="img" focusable="false"><title>Twitter</title><path d="M178.57 127.15 290.27 0h-26.46l-97.03 110.38L89.34 0H0l117.13 166.93L0 300.25h26.46l102.4-116.59 81.8 116.59h89.34M36.01 19.54H76.66l187.13 262.13h-40.66"/></svg></a>
<br />
<small>Copyright © 1999 ImageMagick Studio LLC</small>
</div>
</footer>
</div>
<!-- Javascript assets -->
<script src="assets/bootstrap.bundle.min.js" ></script>
</body>
</html>
|
