From 7dfcc480ba1e19bd3232349fc733caef94034292 Mon Sep 17 00:00:00 2001
From: stainer_t <thomas.stainer@oecd-nea.org>
Date: Mon, 8 Sep 2025 13:48:49 +0200
Subject: Initial commit from Polytechnique Montreal

---
 readme | 138 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 138 insertions(+)
 create mode 100644 readme

(limited to 'readme')

diff --git a/readme b/readme
new file mode 100644
index 0000000..9b008fb
--- /dev/null
+++ b/readme
@@ -0,0 +1,138 @@
+# Version5 readme
+
+# To activate hdf5 and Python3 bindings in the make utility, you need to define
+# environment variables on a UNIX system. Add the information about the HDF5_INC,
+# HDF5_API and FORTRANPATH environment variables in the .profile or .bashrc script.
+# These lines are OS-dependent.
+
+# Availability of python2 or python3 utility is a prerequisite requirement for using
+# Makefiles. Availability of python3 utility and definition of the FORTRANPATH
+# environment variable are prerequisite requirements for using the PyGan bindings.
+
+#
+# On the recherche network at Polytechnique Montreal:
+# Support for HDF5
+export HDF5_INC="/usr/local/hdf5/include" # HDF5 include directory
+if [ $MachineExtension = "-aix" ]
+then
+    export HDF5_INC="/usr/include" # HDF5 include directory
+fi
+export HDF5_API="$HDF5_INC/../lib" # HDF5 C API
+export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$HDF5_API"
+# Support for Python3 API
+export FORTRANPATH="/usr/lib/gcc/x86_64-redhat-linux/4.8.5/" # contains libgfortran.so
+
+#
+# On the RedHat 8 operating system:
+# Support for HDF5
+export HDF5_INC="/usr/include" # HDF5 include directory
+export HDF5_API="$HDF5_INC/../lib64" # HDF5 C API
+export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$HDF5_API"
+# Support for Python3 API
+export FORTRANPATH="/usr/lib/gcc/x86_64-redhat-linux/8/" # contains libgfortran.so
+
+#
+# On the Ubuntu/arm64 operating system:
+# Support for HDF5
+export HDF5_INC="/usr/include/hdf5/serial/" # HDF5 include directory
+export HDF5_API="/usr/lib/aarch64-linux-gnu/hdf5/serial" # HDF5 C API
+export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$HDF5_API"
+# Support for Python3 API
+export FORTRANPATH="/usr/lib/gcc/aarch64-linux-gnu/9/" # contains libgfortran.so
+
+#
+# On the Scibian 10 operating system:
+# Support for HDF5
+export HDF5_INC="/usr/include/hdf5/serial" # HDF5 include directory
+export HDF5_API="/usr/lib/x86_64-linux-gnu/hdf5/serial" # HDF5 C API
+export LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$HDF5_API"
+# Support for Python3 API
+export FORTRANPATH="/usr/lib/gcc/x86_64-linux-gnu/8/" # contains libgfortran.so
+
+#
+# Instructions for configuring Version5 of Dragon/Donjon on UNIX systems
+#
+# To configure Version5 components with custom compilers using makefiles:
+cd ~/Version5_evn/Donjon/
+make
+make clean
+#
+# To configure Version5 components with Intel compilers (icc and ifort) using makefiles:
+cd ~/Version5_evn/Donjon/
+make intel=1
+make clean
+#
+# To configure Version5 components with Nvidia compilers (nvc and nvfortran) using
+# makefiles:
+cd ~/Version5_evn/Donjon/
+make nvidia=1
+make clean
+#
+# To configure Version5 components with LLVM compilers (clang and flang) using makefiles:
+cd ~/Version5_evn/Donjon/
+make llvm=1
+make clean
+#
+# To build an HDF5-enabled version, simply write
+make hdf5=1
+#
+# To build an OpenMP-enabled version, simply write
+make openmp=1
+#
+# To execute the non-regression tests with custom compilers:
+make tests
+#
+# To execute the non-regression tests with Intel compilers:
+make tests intel=1
+#
+# To execute the non-regression tests with Nvidia compilers:
+make tests nvidia=1
+#
+# To execute the non-regression tests with LLVM compilers:
+make tests llvm=1
+#
+# To execute the non-regression tests, including those requiring hdf5 support:
+make tests hdf5=1
+#
+# On AIX and Solaris OS, you must use GNU Make:
+cd ~/Version5_evn/Donjon/
+gmake
+gmake clean
+gmake tests
+
+# To execute Trivac with custom compiler:
+cd ~/Version5_evn/Trivac/
+./rtrivac iaea3d.x2m
+
+# In case of bug:
+./rtrivac -w iaea3d.x2m
+
+# To execute Dragon with custom compiler:
+cd ~/Version5_evn/Dragon/
+./rdragon iaea2d.x2m
+
+# In case of bug:
+./rdragon -w iaea2d.x2m
+
+# To execute Dragon with Intel compiler:
+cd ~/Version5_evn/Dragon/
+./rdragon -c intel iaea2d.x2m
+
+# To execute Dragon with Nvidia compiler:
+cd ~/Version5_evn/Dragon/
+./rdragon -c nvidia iaea2d.x2m
+
+# To execute Dragon with Nvidia compiler and 50 OpenMP threads:
+cd ~/Version5_evn/Dragon/
+./rdragon -c nvidia -p 50 iaea2d.x2m
+
+# To execute Donjon with custom compiler:
+cd ~/Version5_evn/Donjon/
+./rdonjon Candu6.x2m
+
+# To configure the doc
+cd ~/Version5_evn/doc/IGE335
+./install
+
+# To read the doc:
+gv -antialias ~/Version5_evn/doc/IGE335/IGE335.pdf
-- 
cgit v1.2.3