support for arrays of tensors (aka nested tensors, or tensors-of-tensors)

.travis.yml

@@ -148,7 +148,7 @@ before_install:
 # use timeout to stop long-running (i.e. cache-rebuilding) jobs right before they get killed by Travis-CI
 # in case of timeout report success to Travis to force cache upload
 script:
-  - travis_wait 50 timeout 2200 ${TRAVIS_BUILD_DIR}/bin/build-$TRAVIS_OS_NAME.sh;  RESULT=$?; if [ $RESULT -eq 0 ] || [ $RESULT -eq 124 ]; then true; else false; fi;
+  - travis_wait 50 timeout 2850 ${TRAVIS_BUILD_DIR}/bin/build-$TRAVIS_OS_NAME.sh;  RESULT=$?; if [ $RESULT -eq 0 ] || [ $RESULT -eq 124 ]; then true; else false; fi;
 after_failure:
   - cat ${BUILD_PREFIX}/TA/external/madness-build/CMakeFiles/CMakeError.log
   - cat ${BUILD_PREFIX}/TA/external/madness-build/CMakeFiles/CMakeOutput.log

CMakeLists.txt

@@ -59,9 +59,9 @@ endif(TILEDARRAY_PRERELEASE_ID)
 
 # Set install paths ============================================================
 
-set(TILEDARRAY_INSTALL_BINDIR "bin" 
+set(TILEDARRAY_INSTALL_BINDIR "bin"
     CACHE PATH "TiledArray binary install directory")
-set(TILEDARRAY_INSTALL_INCLUDEDIR "include" 
+set(TILEDARRAY_INSTALL_INCLUDEDIR "include"
     CACHE PATH "TiledArray INCLUDE install directory")
 set(TILEDARRAY_INSTALL_LIBDIR "lib"
     CACHE PATH "TiledArray LIB install directory")
@@ -162,16 +162,15 @@ else ()
 endif()
 redefaultable_option(CMAKE_POSITION_INDEPENDENT_CODE "Default value for POSITION_INDEPENDENT_CODE of targets" ${default_CMAKE_POSITION_INDEPENDENT_CODE})
 
+set(BLA_STATIC FALSE CACHE BOOL "Whether to use static linkage for BLAS, LAPACK, and related libraries")
 if(BUILD_SHARED_LIBS)
-  set(BLA_STATIC FALSE CACHE BOOL "Whether to use static linkage for BLAS, LAPACK, and related libraries")
   set(CMAKE_MACOSX_RPATH TRUE)
 else()
-  set(BLA_STATIC TRUE CACHE BOOL "Whether to use static linkage for BLAS, LAPACK, and related libraries")
   set(CMAKE_MACOSX_RPATH FALSE)
 endif()
 
 # miscellaneous cmake platform-neutral and platform-specific configuration =============================
-set(CMAKE_FIND_NO_INSTALL_PREFIX TRUE)  # do not search in CMAKE_INSTALL_PREFIX 
+set(CMAKE_FIND_NO_INSTALL_PREFIX TRUE)  # do not search in CMAKE_INSTALL_PREFIX
 set(CMAKE_SKIP_RPATH FALSE)
 set(CMAKE_SKIP_BUILD_RPATH  FALSE)
 set(CMAKE_SKIP_INSTALL_RPATH FALSE)
@@ -394,19 +393,19 @@ export(EXPORT tiledarray
 configure_package_config_file(cmake/tiledarray-config.cmake.in
     "${PROJECT_BINARY_DIR}/tiledarray-config.cmake"
   INSTALL_DESTINATION "${TILEDARRAY_INSTALL_CMAKEDIR}"
-  PATH_VARS CMAKE_INSTALL_PREFIX TILEDARRAY_INSTALL_BINDIR 
+  PATH_VARS CMAKE_INSTALL_PREFIX TILEDARRAY_INSTALL_BINDIR
             TILEDARRAY_INSTALL_INCLUDEDIR TILEDARRAY_INSTALL_LIBDIR
             TILEDARRAY_INSTALL_DOCDIR TILEDARRAY_INSTALL_CMAKEDIR)
 
 # Install config, version, and target files
 install(EXPORT tiledarray
     FILE "tiledarray-targets.cmake"
-    DESTINATION "${TILEDARRAY_INSTALL_CMAKEDIR}" 
+    DESTINATION "${TILEDARRAY_INSTALL_CMAKEDIR}"
     COMPONENT tiledarray)
 install(FILES
     "${PROJECT_BINARY_DIR}/tiledarray-config.cmake"
     "${PROJECT_BINARY_DIR}/tiledarray-config-version.cmake"
-    DESTINATION "${TILEDARRAY_INSTALL_CMAKEDIR}" 
+    DESTINATION "${TILEDARRAY_INSTALL_CMAKEDIR}"
     COMPONENT tiledarray)
 
 

INSTALL.md

@@ -1,6 +1,6 @@
 # Synopsis
 
-```
+```.cpp
 $ git clone https://github.com/ValeevGroup/TiledArray.git tiledarray
 $ cd tiledarray
 $ cmake -B build \
@@ -30,11 +30,11 @@ $ cmake --build build --target install
   - Boost.Container: header-only
   - Boost.Test: header-only or (optionally) as a compiled library, *only used for unit testing*
   - Boost.Range: header-only, *only used for unit testing*
-- [BTAS](http://github.com/BTAS/BTAS), tag 3e286d05ee3a19ac320c12c380d947c3e31d77ff (will be downloaded automatically, if missing)
+- [BTAS](http://github.com/ValeevGroup/BTAS), tag 8418021a283000ada8edd4994bd81f35652d4b49 (will be downloaded automatically, if missing)
 - BLAS library
-- [MADNESS](https://github.com/m-a-d-n-e-s-s/madness), tag eee5fd9f940ef422ee4ee5abf852c910bc826fd4 .
+- [MADNESS](https://github.com/m-a-d-n-e-s-s/madness), tag 925552feaf326cca8e83de7bd042074ad3cfd3f1 .
   Only the MADworld runtime and BLAS/LAPACK C API component of MADNESS is used by TiledArray.
-  If usable MADNESS installation is now found, TiledArray will download and compile
+  If usable MADNESS installation is not found, TiledArray will download and compile
   MADNESS. *This is the recommended way to compile MADNESS for all users*.
   A detailed list of MADNESS prerequisites can be found at [MADNESS' INSTALL file](https://github.com/m-a-d-n-e-s-s/madness/blob/master/INSTALL_CMake);
   it also also contains detailed
@@ -110,7 +110,7 @@ we specify CMake variables "manually" (on the command line).
 * Basic configuration. This will search for dependencies on your system. If the 
   required dependencies are not found on your system, they will be downloaded 
   and installed during the build process (this includes Eigen, Boost,
-  and MADNESS, but not MPI or TBB). The CMAKE_PREFIX_PATH cache variables
+  and MADNESS, but not MPI or TBB). The `CMAKE_PREFIX_PATH` cache variables
   is a semicolon separated list of search paths. 
 
 ```
@@ -177,10 +177,6 @@ Additional CMake variables are given below.
 
 Most of these are best specified in a _toolchain file_. TiledArray is recommended to use the toolchains distributed via [the Valeev Group CMake kit](https://github.com/ValeevGroup/kit-cmake/tree/master/toolchains). TiledArray by default downloads (via [the FetchContent CMake module](https://cmake.org/cmake/help/latest/module/FetchContent.html)) the VG CMake toolkit which makes the toolchains available without having to download the toolchain files manually. E.g., to use toolchain `x` from the VG CMake kit repository provide `-DCMAKE_TOOLCHAIN_FILE=cmake/vg/toolchains/x.cmake` to CMake when configuring TiledArray.
 
--D CMAKE_BUILD_TYPE=(Release|Debug|RelWithDebInfo)
--D BUILD_SHARED_LIBS=(TRUE|FALSE)
--D CMAKE_CXX_STANDARD=(17|20)
--D TA_ERROR=(none|throw|assert)
 It is typically not necessary to specify optimization or debug flags as the
 default values provided by CMake are usually correct.
 
@@ -300,7 +296,7 @@ variable:
 
 If Eigen is not found at the configure time, it will be downloaded from the Bitbucket repository.
 
-## Pythom
+## Python
 
 To build Python bindings use the following variable:
 
@@ -366,6 +362,7 @@ support may be added.
 ## Expert configure options:
 
 * `TA_EXPERT` -- Set to `ON` to disable automatic installation of prerequisites. Useful for experts, hence the name. [Default=OFF].
+* `TA_ERROR` -- Set to `none` to disable `TA_ASSERT` assertions, `throw` to cause `TA_ASSERT` assertions to throw, `abort` to cause `TA_ASSERT` assertions to abort, or `assert` to cause `TA_ASSERT` assertions to use C++ assert.
 * `TA_TRACE_TASKS` -- Set to `ON` to enable tracing of MADNESS tasks using custom task tracer. Note that standard profilers/tracers are generally useless (except in the trivial cases) with MADWorld-based programs since the submission context of tasks is not captured by standard tracing tools; this makes it impossible in a nontrivial program to attribute tasks to source code. WARNING: task tracing his will greatly increase the memory requirements. [Default=OFF].
 * `TA_ENABLE_RANGEV3` -- Set to `ON` to find or fetch the Range-V3 library and enable additional tests of TA components with constructs anticipated to be supported in the future. [Default=OFF].
 * `TA_SIGNED_1INDEX_TYPE` -- Set to `OFF` to use unsigned 1-index coordinate type (default for TiledArray 1.0.0-alpha.2 and older). The default is `ON`, which enables the use of negative indices in coordinates.

README.md

@@ -20,25 +20,25 @@ The following example expressions are written in C++ with TiledArray. TiledArray
 
 * Matrix-matrix multiplication
 
-   ```
+   ```.cpp
    C("m,n") = 2.0 * A("m,k") * B("k,n");
    ```
 
 * Matrix-vector multiplication
 
-   ```
+   ```.cpp
    C("n") = A("k") * B("k,n");
    ```
 
 * A more complex tensor expression
 
-   ```
+   ```.cpp
    E("m,n") = 2.0 * A("m,k") * B("k,n") + C("k,n") * D("k,m");
    ```
 
 The following application is a minimal example of a distributed-memory matrix multiplcation.
 
-```
+```.cpp
 #include <tiledarray.h>
 
 int main(int argc, char** argv) {

bin/admin/dependency-versions-update-hook.py

@@ -148,7 +148,7 @@ def replace_dep_id(topsrc, file_ext, dep_name, old_id, new_id, search_prefix = '
 any_files_changed |= replace_dep_id(topsrc, 'md', 'MADNESS', madness_old_tag, madness_new_tag, 'm-a-d-n-e-s-s/madness), tag ', ' ')
 
 # BTAS tag in INSTALL.md
-any_files_changed |= replace_dep_id(topsrc, 'md', 'BTAS', btas_old_tag, btas_new_tag, 'BTAS/BTAS), tag ', '')
+any_files_changed |= replace_dep_id(topsrc, 'md', 'BTAS', btas_old_tag, btas_new_tag, 'ValeevGroup/BTAS), tag ', '')
 
 # cuTT tag in INSTALL.md
 any_files_changed |= replace_dep_id(topsrc, 'md', 'cuTT', cutt_old_tag, cutt_new_tag, '', '')