From 1711163dba591ae7ab8016959f892394f0ec8f39 Mon Sep 17 00:00:00 2001 From: mkstoyanov Date: Mon, 30 Sep 2019 10:59:34 -0400 Subject: [PATCH 1/3] expand the code boxes by a small notch to get to 100 chars --- Doxygen/InterfacePython.md | 4 ++-- Doxygen/tasmanian.css | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Doxygen/InterfacePython.md b/Doxygen/InterfacePython.md index 8f15c9b1d..843e15c9e 100644 --- a/Doxygen/InterfacePython.md +++ b/Doxygen/InterfacePython.md @@ -86,8 +86,8 @@ accessed with the Python `help()` function, e.g., ``` * Addon module methods and C++ equivalent: ``` - Tasmanian.loadNeededPoints -> TasGrid::loadNeededPoints - Tasmanian.reloadLoadedPoints -> TasGrid::loadNeededPoints + Tasmanian.loadNeededPoints -> TasGrid::loadNeededPoints + Tasmanian.reloadLoadedPoints -> TasGrid::loadNeededPoints Tasmanian.constructAnisotropicSurrogate -> TasGrid::constructSurrogate (anistropic overload) Tasmanian.constructSurplusSurrogate -> TasGrid::constructSurrogate (surplus overload) ``` diff --git a/Doxygen/tasmanian.css b/Doxygen/tasmanian.css index 392aabddb..e109300c5 100644 --- a/Doxygen/tasmanian.css +++ b/Doxygen/tasmanian.css @@ -312,7 +312,7 @@ tr[class^="separator:"] { div.fragment { border-radius: 5px; - padding: 1em; + padding: 0.5em; } div.line { From 6a473d5f4ce6ac250052151081e3c8ec1a3a16af Mon Sep 17 00:00:00 2001 From: mkstoyanov Date: Mon, 30 Sep 2019 11:25:07 -0400 Subject: [PATCH 2/3] added a list of issues known at release time --- Doxygen/Installation.md | 24 ++++++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) diff --git a/Doxygen/Installation.md b/Doxygen/Installation.md index ac0d2a7e1..8dd44842c 100644 --- a/Doxygen/Installation.md +++ b/Doxygen/Installation.md @@ -87,6 +87,7 @@ The preferred way to install Tasmanian is to use the included CMake build script -D Tasmanian_ENABLE_MPI:BOOL= (mostly stable) -D Tasmanian_ENABLE_DOXYGEN:BOOL= (mostly stable) ``` + * Acceleration options: * OpenMP allows Tasmanian to use more than one CPU core, which greatly increases the performance * Basic Linear Algebra Subroutines (BLAS) is a standard with many implementations, @@ -202,7 +203,7 @@ Tasmanian has been tested with MS Visual Studio 2015 and 2017 and CMake 3.11. ctest -C Release cmake --build . --config Release --target install ``` -* Both Debug and Release are supported config modes above +* Both Debug and Release are supported config modes, but do not use simultaneously ### Install folder structure @@ -288,4 +289,23 @@ For example: find_package(... OPTIONAL_COMPONENTS SHARED) # Tasmanian::Tasmanian is shared find_package(... REQUIRED SHARED OPTIONAL_COMPONENTS STATIC) # Tasmanian::Tasmanian is static find_package(... ) # Tasmanian::Tasmanian is static -``` \ No newline at end of file +``` + +### Known Issues + +Several known issues and work-around fixes: +* The addon tests sometime fail due to thread scheduling + * The overhead associated with thread scheduling is much larger than the simple test models used, + which leads to unrealistically large fluctuations in sample run-time, which in turn leads to + randomness in the results, most notably on machines with few cpu cores. + * Rerun the tests and/or installation to see if the problem is persistent +* The GNU Make script sometimes fails under MacOSX because of security policies related to `rpath` + * use either the `install` script or CMake + * the CMake GUI works under MaxOSX and Linux the same way as Windows +* Mixing the GCC and Clang compilers and linkers sometimes fails with an error about the architecture + * use shared libraries only, i.e., `-D BUILD_SHARED_LIBS=ON` in CMake +* The PGI compiler fails when using optimization `-O2` with an error about an empty `free()` + * the bug happens when `std::vector::resize()` is called on an empty vector + * use the `-O1` instead, this issue needs further investigation +* Older versions of CUDA do not work with newer versions of some compilers, e.g., gcc + * consult the CUDA manual for a list of acceptable compilers From de365ffbab3055f4dfdff6453b777967cfb0dd90 Mon Sep 17 00:00:00 2001 From: mkstoyanov Date: Mon, 30 Sep 2019 11:49:51 -0400 Subject: [PATCH 3/3] removed windows compiler (not working) --- Doxygen/Installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doxygen/Installation.md b/Doxygen/Installation.md index 8dd44842c..df61fe7a6 100644 --- a/Doxygen/Installation.md +++ b/Doxygen/Installation.md @@ -193,7 +193,7 @@ Tasmanian is also included in Spack: [https://spack.io/](https://spack.io/) ### Install on MS Windows platform -Tasmanian has been tested with MS Visual Studio 2015 and 2017 and CMake 3.11. +Tasmanian has been tested with MS Visual Studio 2017 and CMake 3.11. * First use the CMake GUI to set the folders and options * Then use the command prompt (`cmd.exe`) to enter the build folder