ProteinDF has several distributions. If a README file is provided, first read the README file.
To execute ProteinDF, the following environment is required:
UNIX/Linux operating system
C runtime library (normally bundled with the OS)
BLAS, LAPACK library
MPI runtime environment (only for parallel version)
Distributed matrix operation library (ScaLAPACK)
ProteinDF has been confirmed to operate on POSIX-compliant computer systems, as well on as the following computing systems:
SGI Altix 3000 series
Cray XT-5, XT-6
The program should also work on the x86 PC Linux system.
The required memory size depends on the scale of computation model. Furthermore, in parallel computation, the required memory size per node varies depending on whether one uses LAPACK or ScaLAPACK for matrix operations. For LAPACK, the maximum computation scale is equal to the memory size on each node. For ScaLAPACK, the scale is equal to the total memory size on all nodes, since the computation area is distributed and stored in all nodes. Note that this estimation serves only as a guideline, since other factors also determine the available computation scale.
Warning
Caution: For a 32bit OS, ProteinDF may have some limitations in available memory size, file size, etc.
Several python scripts are prepared for ProteinDF. These scripts are not necessary for program execution, but for analysis of calculation results. To use these python scripts, the following programs (modules) are required. For configuration of these programs, follow the system guidelines.
python (version 2.5 or greater)
argparse module
numpy module
matplotlib module
MessagePack module
YAML module
The installation procedure varies according to the distributed package. If a README file is provided, follow the README file instructions.
ProteinDF requires the user to configure the following environment variables. Appropriately set the variables according to the user’s environment.
Specify the directory where the ProteinDF package was copied.
For example, when the package was copied to /usr/local/ProteinDF and when bash is used as the login shell, add the following to .bashrc:
PDF_HOME=/usr/local/ProteinDF
export PDF_HOME
When executing ProteinDF with the OpenMP multi-threading, specify the maximum number of threads inside the OpenMP parallel region.
When executing ProteinDF with the OpenMP multi-threading, specify the type and chunk size of the parallel schedule inside the OpenMP parallel region.
For the binary package for X86 and X86_64 environments, some of the Intel shared libraries may be required. Download the redistributable libraries from the link below and install them to the user’s system: http://software.intel.com/en-us/articles/redistributable-libraries-for-the-intelr-c-and-visual-fortran-compiler-professional-editions-for-linux/
The source file extracted from the tarball contains the configure script. Executing the configure script creates the Makefile according to the user’s environment.
$ ./configure 2>&1 | tee out.configure
Note
If the user obtained the source code from the source code repository, create the configure script using the autotools. Refer to [xxx] for details.
The following are the options/environment variables typically used. Refer to configure –help for details.
Specifies the program installation directory. The default is /usr/local. Use this option to install the program at the user’s home directory, etc.
Creates the parallel processing program, in addition to the serial version.
Specifies the BLAS library location.
Specifies the LAPACK library location.
Specifies the ScaLAPACK library location.
Environment variables CC, CXX, MPICXX
Specifies the C/C++ compiler used for the build. When linking MPI libraries, use the compiler appropriate to the computing system, such as mpicxx.
Environment variables CFLAGS, CXXFLAGS
Specifies the options to pass to the C/C++ compiler. Use this variable to specify the options to the OpenMP compilers, etc.
Environment variables LIBS
Specifies the other libraries required for the build.
Environment variables BLAS_LIBS
Specifies the BLAS library.
Environment variables LAPACK_LIBS
Specifies the LAPACK library.
Environment variables SCALAPACK_LIBS
Specifies the ScaLAPACK library.
Execute the configure command, and make sure the Makefile is created. Once the Makefile is created, execute the make command.
$ make 2>&1 | tee out.make
After executing “make”, install the execution file/data to the specified path.
$ make install 2>&1 | tee out.make_install
After the execution above, the following files will be created:
In some environments, problems may occur such that no script can be executed, or no build is possible. In such cases, check the output of each script thoroughly (i.e. out.configure, out.make, and out.make_install in the case above).
When the user obtained the development code from the source code repository, create the configure script using the autotools. To do so, execute the bundled bootstrap.sh under the directory where automake, autoconf, and libtool are installed.