3rd-party/tbb/examples/parallel_for/seismic/readme.html
Parallel seismic wave simulation that demonstrates use of parallel_for and affinity_partitioner.
The example can be built in the offload version to run on Intel® Many Integrated Core (Intel® MIC) Architecture based coprocessor (see build instructions).
Note: Currently, the offload version does not support GUI and can only be used with console mode.
System Requirements
For the most up to date system requirements, see the release notes.
Files
main.cppMain program which parses command line options and runs the algorithm with different numbers of threads. universe.hWave propagation methods interface. universe.cppWave propagation methods implementation. seismic_video.hGUI mode support interface. seismic_video.cppGUI mode support implementation. MakefileMakefile for building the example.
Directories
msvsContains Microsoft* Visual Studio* workspace for building and running the example (Windows* systems only). xcodeContains Xcode* IDE workspace for building and running the example (macOS* systems only).
For information about the minimum supported version of IDE, see release notes.
Build instructions
General build directions can be found here.
The following additional options are supported:
make [(general targets: {release, debug} [test])] UI={con, gdi, d2d, x, mac}Build and run as usual, but build with the specified GUI driver: console, GDI+*, Direct2D*, X11, or OpenGL* (see the description of the common GUI code for more information on available graphics support).
For Linux* and macOS* systems, the best available driver is detected automatically by the Makefile.
For Windows* systems, UI=gdi is the default GUI driver; compiling with UI=d2d may offer superior performance, but can only be used if the Microsoft* DirectX* SDK is installed on your system and if overlay is supported by your graphics card.
Use UI=con to build without the GUI for use in making performance measurements (strongly recommended when measuring performance or scalability; see note below). make [(above options or targets)] XARCH=x64Build and run as above, but also specify XARCH=x64 (or XARCH=AMD64 for older compilers) when building the example on Windows* as a 64-bit binary. make [(above options or targets)] DDLIB_DIR=<specify path to Direct Draw* SDK here>If you experience ddraw.lib linking problems, specify the correct library directory via this option. make [(above options or targets)] CXXFLAGS=-DX_FULLSYNCBuild and run as above, but enable full X11 synchronization if you experience "tearing" of motion on slower video systems.
Usage
seismic _-h_Prints the help for command line options seismic [n-of-threads=value] [n-of-frames=value] [silent] [serial]seismic [n-of-threads [n-of-frames]] [silent] [serial]n-of-threads is the number of threads to use; a range of the form low[:high], where low and optional high are non-negative integers or 'auto' for a platform-specific default number.
n-of-frames is a number of frames the example processes internally.
silent - no output except elapsed time.
serial - in GUI mode start with serial version of algorithm.
To run a short version of this example, e.g., for use with Intel® Parallel Inspector:: Build a debug version of the example (see the build instructions).
Run it with the desired number of threads and smaller number of frames, e.g., seismic 4 5.
Hot keys
The following hot keys can be used in interactive execution mode when the example is compiled with the graphical user interface:
<left mouse button> Starts new seismic wave in place specified by mouse cursor. <space> Toggles between parallel and serial execution modes. <p> Enables parallel execution mode. <s> Enables serial execution mode. <e> Enables screen updates. <d> Disables screen updates (strongly recommended when measuring performance or scalability; see note below). <esc> Stops execution.
Notes
Legal Information
Intel and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.
* Other names and brands may be claimed as the property of others.
© 2020, Intel Corporation