Skip to content

Windows

Choose the correct executable

numgeo for Windows is available in combination with Intel OneAPI and Visual Studio. If you only want to try out numgeo, you do not need to install these programmes, but can use the DLL files supplied with numgeo. These files must be present in the calculation folder or added to the system path. You can still install Intel OneAPI and Visual Studio at a later point if you want to be able to use user-defined subroutines.

No installation of Intel OneAPI and Visual Studio

If you do not want to install Intel OneAPI and Visual Studio you can directly jump to the tutorial section and run your first simulation. Note that you need to have the DLL files shipped together with the numgeo executable either in the calculation folder or in your system path. Adding a file to your system path is desribed here. There you also find a instruction how to add numgeo to your system path.

User subroutines

By default, the tutorials with user-defined subroutines are shipped together with shell scripts using Intel OneAPI to compile the user routines. If you have not installed it, you will receive an error. If you have another compiler you can replace it in the shell script.

Full installation including Intel OneAPI and Visual Studio

The installation steps are as follows:

  1. Optional: Install Intel Visual Studio as described here
  2. Install oneAPI Base Toolkit following the procedure given in this section
  3. Install oneAPI HPC Toolkit following these instructions
  4. Optional: Add numgeo to your system path as detailed in this section
  5. numgeo is now ready to use

Windows 11

The Windows 11 executable was created using Intel Visual Studio Community 2022 Version 17.6.4 and Intel OneAPI 2023.1.

This executable was also successfully used on

  • Intel Visual Studio Community Version 2022 17.7.0 and Intel OneAPI 2023.2.
  • Intel Visual Studio Community Version 2022 17.7.7 and Intel OneAPI 2023.2.
  • Intel Visual Studio Community Version 2022 17.4.0 and Intel OneAPI 2022.2.1

Visual Studio

Visual Studio (Community) is free to use and can be downloaded here.

When installing Visual Studio, make sure to install "Desktop development with C++"


oneAPI Base Toolkit

The oneAPI Base Toolkit can be installed either using the Graphical User Interface (GUI) or using the package manager apt. I used the GUI with the following steps:

  1. Download the oneAPI Base Toolkit from here

  2. Installation Linux:

    i. Launch the installer with administrator rights

    ii. Follow the installer instructions, but choose "Custom" installation. The only packages required are:

    • Intel® oneAPI DPC++/C++ Compiler
    • Intel® oneAPI DPC++ Library
    • Intel® oneAPI Math Kernel Library
    • Intel® oneAPI Threading Building Blocks (not sure, maybe we can skip this one if not required by other module)
    • Intel® Distribution for GDB*
    • Intel® Integrated Performance Primitives
    • Intel® VTune™ Profiler
    • Intel® Advisor

oneAPI HPC Toolkit

The oneAPI HPC Toolkit can be installed either using the Graphical User Interface (GUI) or using the package manager apt. I used the GUI with the following steps:

  1. Download the oneAPI HPC Toolkit from here

  2. Installation Linux:

    i. Launch the installer as administrator

    ii. Follow the installer instructions, but choose "Custom" installation. The only packages required are:

    • Intel oneAPI DPC++/C++ Compiler (the installation from the Base Toolkit will be extended)
    • Intel® Fortran Compiler
    • Intel® Fortran Compiler Classic
    • Intel® Inspector
    • Intel® MPI Library (I think currently not needed, but in future)
    • Intel® Trace Analyzer and Collector (I think currently not needed, but in future)

Adding numgeo to your system path (optional)

You can add numgeo to your system path. This allows you to run numgeo without placing the executable in the simulation directory every time. To add numgeo to the system path perform the following steps:

  1. Create a folder numgeo
  2. Inside this folder create a folder bin
  3. Place the numgeo executable in numgeo\bin
  4. Move the parent folder numgeo to the root of the C drive or the folder of your choice
  5. Type system variables into the search bar and click the Edit the system environment variables option
  6. Under the User variables section, select Path and click the Edit button
  7. Choose New from the side menu
  8. Add C:\numgeo\bin to the empty field and confirm changes with OK