你已经派生过 gprMax
镜像自地址
https://gitee.com/sunhf/gprMax.git
已同步 2025-08-06 12:36:51 +08:00
Updated installation instructions for optional MPI and GPU components.
这个提交包含在:
@@ -9,16 +9,15 @@ The most computationally intensive parts of gprMax, which are the FDTD solver lo
|
||||
Extra installation steps for GPU usage
|
||||
======================================
|
||||
|
||||
The following steps provide guidance on how to install the extra components to allow gprMax to run on your GPU:
|
||||
|
||||
1. Install the `NVIDIA CUDA Toolkit <https://developer.nvidia.com/cuda-toolkit>`_. You can follow the Installation Guides in the `NVIDIA CUDA Toolkit Documentation <http://docs.nvidia.com/cuda/index.html#installation-guides>`_
|
||||
2. Install the pycuda Python module. Open a Terminal (Linux/macOS) or Command Prompt (Windows), navigate into the top-level gprMax directory, and if it is not already active, activate the gprMax conda environment :code:`source activate gprMax` (Linux/macOS) or :code:`activate gprMax` (Windows). Run :code:`pip install pycuda`
|
||||
The following steps provide guidance on how to install the extra components to allow gprMax to run on your NVIDIA GPU:
|
||||
|
||||
1. Install the `NVIDIA CUDA Toolkit <https://developer.nvidia.com/cuda-toolkit>`_. You can follow the Installation Guides in the `NVIDIA CUDA Toolkit Documentation <http://docs.nvidia.com/cuda/index.html#installation-guides>`_ You must ensure the version of CUDA you install is compatible with the compiler you are using. This information can usually be found in a table in the CUDA Installation Guide under System Requirements. You should add the location of the CUDA compiler (:code:`nvcc`) to your user path.
|
||||
2. Install the pycuda Python module. Open a Terminal (Linux/macOS) or Command Prompt (Windows), navigate into the top-level gprMax directory, and if it is not already active, activate the gprMax conda environment :code:`conda activate gprMax`. Run :code:`pip install pycuda`
|
||||
|
||||
Running gprMax using GPU(s)
|
||||
===========================
|
||||
|
||||
Open a Terminal (Linux/macOS) or Command Prompt (Windows), navigate into the top-level gprMax directory, and if it is not already active, activate the gprMax conda environment :code:`source activate gprMax` (Linux/macOS) or :code:`activate gprMax` (Windows)
|
||||
Open a Terminal (Linux/macOS) or Command Prompt (Windows), navigate into the top-level gprMax directory, and if it is not already active, activate the gprMax conda environment :code:`conda activate gprMax`
|
||||
|
||||
Run one of the test models:
|
||||
|
||||
|
@@ -16,7 +16,24 @@ MPI
|
||||
|
||||
The Message Passing Interface (MPI) has been utilised to implement a simple task farm that can be used to distribute a series of models as independent tasks. This can be useful in many GPR simulations where a B-scan (composed of multiple A-scans) is required. Each A-scan can be task-farmed as a independent model. Within each independent model OpenMP threading will continue to be used (as described above). Overall this creates what is know as a mixed mode OpenMP/MPI job.
|
||||
|
||||
By default the MPI task farm functionality is turned off. It can be switched on using the ``-mpi`` command line flag. MPI requires an installation of the ``mpi4py`` Python package, which itself depends on an underlying MPI installation, usually `OpenMPI <http://www.open-mpi.org>`_. On Microsoft Windows ``mpi4py`` requires `Microsoft MPI 6 <https://www.microsoft.com/en-us/download/details.aspx?id=47259>`_.
|
||||
By default the MPI task farm functionality is turned off. It can be used with the ``-mpi`` command line option, which specifies the total number of MPI tasks, i.e. master + workers, for the MPI task farm. This option is most usefully combined with ``-n`` to allow individual models to be farmed out using a MPI task farm, e.g. to create a B-scan with 60 traces and use MPI to farm out each trace: ``(gprMax)$ python -m gprMax user_models/cylinder_Bscan_2D.in -n 60 -mpi 61``.
|
||||
|
||||
Extra installation steps for MPI task farm usage
|
||||
------------------------------------------------
|
||||
|
||||
The following steps provide guidance on how to install the extra components to allow the MPI task farm functionality with gprMax:
|
||||
|
||||
1. Install a flavour of MPI on your system.
|
||||
|
||||
Linux/macOS
|
||||
^^^^^^^^^^^
|
||||
It is recommended to use `OpenMPI <http://www.open-mpi.org>`_.
|
||||
|
||||
Microsoft Windows
|
||||
^^^^^^^^^^^^^^^^^
|
||||
It is recommended to use `Microsoft MPI <https://docs.microsoft.com/en-us/message-passing-interface/microsoft-mpi>`_. Download and install both the .exe and .msi files.
|
||||
|
||||
2. Install the ``mpi4py`` Python module. Open a Terminal (Linux/macOS) or Command Prompt (Windows), navigate into the top-level gprMax directory, and if it is not already active, activate the gprMax conda environment :code:`conda activate gprMax`. Run :code:`pip install mpi4py`
|
||||
|
||||
HPC job scripts
|
||||
===============
|
||||
|
在新工单中引用
屏蔽一个用户