Step-by-step instructions to build KAPSEL †

The following things are needed to use KAPSEL.

  • Windows (with Cygwin) or Linux
  • gcc
  • GOURMET2013 (included in OCTA2013)
  • KAPSEL source code (kapsel3.**.zip)
↑

STEP 0: Linux or Windows? †

  • To build KAPSEL on Linux, goto STEP 1.
  • To build KAPSEL on Windows, install "Cygwin" first, then goto STEP 1. Be sure to include "gcc", "make" (both exist under "Devel" tree).
  • KAPSEL can be build also on Mac OS-X. (not officially supported)
↑

STEP 1: Download and install OCTA/GOURMET †

  • Visit OCTA-BBS and Login. Registration is required if you haven't yet complete it.
  • For Linux
    • Follow "DOWNLOAD" -> "OCTA2013" -> "OCTA2013 for linux iso image".
    • Download "OCTA2013LINUX.ISO" and follow the instructions to install OCTA2013.
  • For Windows
    • Follow "DOWNLOAD" -> "OCTA2013" -> "OCTA2013 for Windows 32/64bit iso image".
    • Download "OCTA2013WIN.ISO" and follow the instructions to install OCTA2013.
↑

STEP 2: Build "libplatform" †

  • "libplatform" is an I/O library developed by OCTA project. One needs this library to access to UDF-formatted files.
  • For Linux:
   > su
   > cd /usr/local/OCTA2013/GOURMET_2013/src
   > ./configure
   > make
   > make install
  • For Windows:
    • Logon Windows with an administrator authorization
    • Open Cygwin terminal window
   $ ln -s /cygdrive/c/OCTA2013/ /usr/local/.
   $ cd /usr/local/OCTA2013/GOURMET_2013/src
   $ ./configure
   $ make
   $ make install
  • See manuals for more detailed information on libplatform
    • English: &ref(): File not found: "libplatform_eng.pdf" at page "Install";
    • Japanese: &ref(): File not found: "libplatform_jpn.pdf" at page "Install";
↑

STEP 3: Download "KAPSEL" source code †

  • You can download the source code from here.
  • Source code &ref(): File not found: "kapsel3.02.zip" at page "Install";
↑

STEP 4: Build "KAPSEL" binary executable †

   > unzip kapsel3.0.zip
   > cd kapsel3.0
   > make 'ENV=CYGWIN'       (Cygwin on Windows)
   or
   > make 'ENV=GCC'          (gcc on Linux)
   or
   > make 'ENV=ICC'          (icc on Linux)
   or
   > make 'ENV=ICC_MKL_OMP'  (icc + MKL + OpenMP on Linux)
   or
   > make clean   (clean-up working files)
↑

STEP 5: Test run †

   > cd UDF
   > ../kapsel -Iinput.udf -Ooutput.udf -Ddefine.udf -Rrestart.udf
  #using input.udf as input
  #using output.udf as output
  #using define.udf as definition
  #using restart.udf as restart
  #
  # Navier_Stokes eq. selected.
   ...
  • If you see a command-line output as shown above, KAPSEL has been successfully built and run.