Skip to content

Latest commit

 

History

History
93 lines (82 loc) · 2.78 KB

ReadMe.md

File metadata and controls

93 lines (82 loc) · 2.78 KB

Adaptable Input / Output System (ADIOS) v2.0

This is v2.0 of the ADIOS I/O system, developed as part of the U.S. Department of Energy Exascale Computing Program.

License

ADIOS >= 2.0 is licensed under the Apache License v2.0. See the accompanying Copyright.txt for more details.

Directory layout

  • cmake - Project specific CMake modules
  • examples - ADIOS Examples
  • include - Public header files
  • scripts - Project maintenance and development scripts
  • source - Main ADIOS source
  • testing - Tests

Getting Started

ADIOS 2.0 uses CMake for it's build environment. CMake expects projects to use "out-of-source" builds, which means keeping a separate build and source directory (different from autotools, which usually uses an in-source build). To build ADIOS:

  1. Clone the repository:
$ mkdir adios
$ cd adios
$ git clone https://github.com/ornladios/adios2.git source
  1. Create a separate build directory:
$ mkdir build
  1. Configure the project with CMake. The following options can be specified as ON or OFF with cmake's -DVAR=VALUE syntax:
  • ADIOS_BUILD_SHARED_LIBS - Build shared libraries (OFF for static)
  • ADIOS_BUILD_EXAMPLES - Build examples
  • ADIOS_BUILD_TESTING - Build test code
  • ADIOS_USE_MPI - Enable MPI
  • ADIOS_USE_BZip2 - Enable BZip2 compression
  • ADIOS_USE_ADIOS1 - Enable the ADIOS 1.x engine
  • ADIOS_USE_DataMan - Enable the DataMan engine
$ cd build
$ cmake -DADIOS_USE_MPI=OFF ../source
-- The C compiler identification is GNU 6.3.1
-- The CXX compiler identification is GNU 6.3.1
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Found BZip2: /usr/lib64/libbz2.so (found version "1.0.6") 
-- Looking for BZ2_bzCompressInit
-- Looking for BZ2_bzCompressInit - found

ADIOS2 build configuration:
  C++ Compiler: GNU 6.3.1 
  /usr/bin/c++

  Installation prefix: /usr/local
  Features:
    Library Type: shared
    Build Type:   Debug
    Testing: ON
    MPI:     OFF
    BZip2:   ON
    ADIOS1:  OFF
    DataMan: OFF

-- Configuring done
-- Generating done
-- Build files have been written to: /path/to/adios/build
$

You can also use CMake's curses-base UI with ccmake ../source.

  1. Compile:
$ make -j8
  1. Run tests:
$ make test

Developers

Please see the Contributors Guide for how to submit changes to ADIOS.