Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
0203 Compilation INMOST Windows
Compilation guide for INMOST on Windows
Please share any issues with this compilation guide at https://github.com/INMOST-DEV/INMOST/issues
This guide was tested with:
- Microsoft Visual Studio 2013 Express and Professional Edition
- Microsoft Visual Studio 2010 Professional Edition
- Microsoft Visual Studio 2008 Express Edition
- Misrosoft Visual Studio 2005 Express Edition
For instructions on preparing Visual Studio to work on your computer refer to guide for Microsoft Visual Studio. If you have successfully compiled INMOST with other compilers, please share your experience.
Download source archive from https://github.com/INMOST-DEV/INMOST/releases and unpack it into inmost_source_path.
Create new folder for building purposes. We will refere to it inmost_build_path.
Start CMake-gui application and enter inmost_source_path into the field right after the text "Where is the source code". Enter inmost_build_path into the field to the right from "Where to build the binaries".
Click on the "Generate" button. You will be prompted to select the compiler which you would like to use.
Select Visual Studio as your compiler and press "Finish". Once configured it will provide you options that are avialible in INMOST.
USE_AUTODIFF checkboxes are activated.
They are related to internal services within INMOST:
USE_MESHprovides tools to work with mesh and mesh data in distributed parallel environment.
USE_SOLVERprovides capabilities to solve sparse linear algebraic problem Ax=b in distributed parallel environment and can interface with PETSc and Trilinos libraries.
USE_PARTITIONERgives capability to partition the mesh in serial execution and can interface with ParMetis and Zoltan libraries for parallel execution.
USE_AUTODIFFis a tool that automatically constructs Jacobian matrix for nonlinear problem, works in parallel.
You can uncheck any of this checkboxes and click "Configure" again.
There are also several options that allows to extend functionality by using side libraries:
USE_PARTITIONER_PARMETISactivates ParMetis library interface for graph partitioning. Refer to compilation guide with ParMetis for further instructions.
USE_PARTITIONER_ZOLTANactivates Zoltan library interface for graph partitioning. Refer to compilation guide with Zoltan for further instructions.
USE_SOLVER_PETSCthat activates PETSc library interface for linear problem solution in parallel. Refer to compilation guide with PETSc for further instructions.
USE_SOLVER_TRILINOSthat activates Trilinos library interface for linear problem solution in parallel. Refer to compilation guide with Trilinos for further instructions.
TEST_FORTRAN_ANI3Dtest for presence of fortran compiler and compile ANI3D serial solver.
In case CMake detects presence of MPI library then it will also activate the following checkboxes:
USE_MPIcompile INMOST for distributed environment.
USE_MPI2that will activate features from MPI-2, this option is provided to you in the case you have MPI-1 library. Then in order to compile INMOST you will have to uncheck this checkbox manually.
USE_MPI_FILEthis will activate input-output algorithms using MPI-ROMIO functionality in INMOST. In case your MPI does not have ROMIO you should manualy uncheck this checkbox.
USE_MPI_P2Pthis will activate point to point algorithms using MPI-RDMA functionality in INMOST. In case your MPI does not have RDMA or your hardware does not support RDMA operations you should manualy uncheck this checkbox.
If your MPI library was not detected automatically you may try providing it manually. Click "Add Entry" button and enter:
PATHthe path to header files of MPI library.
FILEPATHthe MPI library
Then click "Configure" again and in case you see "MPI FOUND" words then you have successfully activated MPI in INMOST.
MPI is not required for INMOST to work. You may uncheck the checkbox USE_MPI if you don't plan to use INMOST library in parallel. In this case all parallel algorithms would be deactivated.
You may also set two checkboxes:
COMPILE_TESTSthat will activate tests for inner functionality. You can get the information about those tests here.
COMPILE_EXAMPLESthat will activate attached examples. You can get the information about those examples here.
At last you may setup
CMAKE_INSTALL_PREFIX variable. By this variable you provide the path where the library and all the relevant header files will be installed. It will also provide instructions for other cmake projects that will have to use INMOST library.
Then click "Configure" again and then "Generate". In output you should see the words "Generation done".
Go to your inmost_build_path. You should see there multiple files.
Double click on Visual Studio solution file INMOST.sln. Hit F7 to compile library and additional components.
Compilation should end successfully. In the case you have activated
COMPILE_TESTS you may go to "View/Solution Explorer".
There you can find "RUN_TESTS" project in the list, right click on it and then click build.
If everything is fine all testing should end successfully.
Now you can install library. Go to "View/Solution Explorer" again. Find "INSTALL" project there, right click on it and then click build.
In output window it should report you destination where it installs library, headers and binaries of examples. This destination should match with the one you have provided through
Now you are ready to use INMOST. Check examples for practice of using INMOST.
When you are developing your application with INMOST library it is recommended that you use the library in Debug mode. This will activate numerous internal checks within the library. Once you are done you'd better use Release mode. In order to switch the mode go to "Build/Configuration Manager".
And there switch from Debug to Release mode.