+
+namespace app4triqs {
+
+ /**
+ * A very useful and important class
+ *
+ * @note A Useful note
+ * @include app4triqs/app4triqs.hpp
+ */
+ class toto {
+
+ int i = 0;
+
+ public:
+ toto() = default;
+
+ /**
+ * Construct from integer
+ *
+ * @param i_ a scalar :math:`G(\tau)`
+ */
+ explicit toto(int i_) : i(i_) {}
+
+ ~toto() = default;
+
+ // Copy/Move construction
+ toto(toto const &) = default;
+ toto(toto &&) = default;
+
+ /// Copy/Move assignment
+ toto &operator=(toto const &) = default;
+ toto &operator=(toto &&) = default;
+
+ /// Simple accessor
+ [[nodiscard]] int get_i() const { return i; }
+
+ /**
+ * A simple function with :math:`G(\tau)`
+ *
+ * @param u Nothing useful
+ */
+ int f(int u) { return u; }
+
+ /// Arithmetic operations
+ toto operator+(toto const &b) const;
+ toto &operator+=(toto const &b);
+
+ /// Comparison
+ bool operator==(toto const &b) const;
+
+ /// HDF5
+ static std::string hdf5_format() { return "Toto"; }
+
+ friend void h5_write(h5::group grp, std::string subgroup_name, toto const &m);
+ friend void h5_read(h5::group grp, std::string subgroup_name, toto &m);
+
+ /// Serialization
+ template void serialize(Archive &ar, const unsigned int) { ar &i; }
+ };
+
+ /**
+ * Chain digits of two integers
+ *
+ * @head A set of functions that implement chaining
+ *
+ * @tail Do I really need to explain more ?
+ *
+ * @param i The first integer
+ * @param j The second integer
+ * @return An integer containing the digits of both i and j
+ *
+ */
+ int chain(int i, int j);
+
+} // namespace app4triqs
diff --git a/deps/.gitignore b/deps/.gitignore
new file mode 100644
index 0000000..72e8ffc
--- /dev/null
+++ b/deps/.gitignore
@@ -0,0 +1 @@
+*
diff --git a/deps/CMakeLists.txt b/deps/CMakeLists.txt
new file mode 100644
index 0000000..e26dfba
--- /dev/null
+++ b/deps/CMakeLists.txt
@@ -0,0 +1,67 @@
+include(external_dependency.cmake)
+
+# Add your dependencies with the function
+#
+# external_dependency(name
+# [VERSION ]
+# [GIT_REPO ]
+# [GIT_TAG ]
+# [BUILD_ALWAYS]
+# [EXCLUDE_FROM_ALL]
+# )
+#
+# Resolve the dependency using the following steps in order.
+# If a step was successful, skip the remaining ones.
+#
+# 1. Use find_package(name [])
+# to locate the package in the system.
+# Skip this step if Build_Deps option is set.
+# 2. Try to find a directory containing the sources
+# at ${CMAKE_CURRENT_SOURCE_DIR}/name and
+# ${CMAKE_SOURCE_DIR}/deps/name. If found
+# build it as a cmake sub-project.
+# 3. If GIT_REPO is provided, git clone the sources,
+# and build them as a cmake sub-project.
+#
+# Addtional options:
+#
+# GIT_TAG - Use this keyword to specify the git-tag, branch or commit hash
+#
+# BUILD_ALWAYS - If set, this dependency will always be built from source
+# and will never be searched in the system.
+#
+# EXCLUDE_FROM_ALL - If set, targets of the dependency cmake subproject
+# will not be included in the ALL target of the project.
+# In particular the dependency will not be installed.
+
+if(NOT DEFINED Build_Deps)
+ set(Build_Deps "Always" CACHE STRING "Do we build dependencies from source? [Never/Always/IfNotFound]")
+else()
+ set(Build_Deps_Opts "Never" "Always" "IfNotFound")
+ if(NOT ${Build_Deps} IN_LIST Build_Deps_Opts)
+ message(FATAL_ERROR "Build_Deps option should be either 'Never', 'Always' or 'IfNotFound'")
+ endif()
+ set(Build_Deps ${Build_Deps} CACHE STRING "Do we build dependencies from source? [Never/Always/IfNotFound]")
+ if(NOT IS_SUBPROJECT AND NOT Build_Deps STREQUAL "Always" AND (ASAN OR UBSAN))
+ message(WARNING "For builds with llvm sanitizers (ASAN/UBSAN) it is recommended to use -DBuild_Deps=Always to avoid false positives.")
+ endif()
+endif()
+
+# -- Cpp2Py --
+if(PythonSupport OR (NOT IS_SUBPROJECT AND Build_Documentation))
+ external_dependency(Cpp2Py
+ GIT_REPO https://github.com/TRIQS/cpp2py
+ VERSION 2.0
+ GIT_TAG unstable
+ BUILD_ALWAYS
+ EXCLUDE_FROM_ALL
+ )
+endif()
+
+# -- GTest --
+external_dependency(GTest
+ GIT_REPO https://github.com/google/googletest
+ GIT_TAG main
+ BUILD_ALWAYS
+ EXCLUDE_FROM_ALL
+)
diff --git a/deps/external_dependency.cmake b/deps/external_dependency.cmake
new file mode 100644
index 0000000..252cead
--- /dev/null
+++ b/deps/external_dependency.cmake
@@ -0,0 +1,95 @@
+# Copyright (c) 2020 Simons Foundation
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You may obtain a copy of the License at
+# https://www.gnu.org/licenses/gpl-3.0.txt
+
+
+# Consider ROOT env variables in find_package
+if(POLICY CMP0074)
+ cmake_policy(SET CMP0074 NEW)
+endif()
+
+# Make sure that imported targets are always global
+get_property(IMPORTED_ALWAYS_GLOBAL GLOBAL PROPERTY IMPORTED_ALWAYS_GLOBAL)
+if(NOT IMPORTED_ALWAYS_GLOBAL)
+ function(add_library)
+ set(_args ${ARGN})
+ if ("${_args}" MATCHES ";IMPORTED")
+ list(APPEND _args GLOBAL)
+ endif()
+ _add_library(${_args})
+ endfunction()
+ set_property(GLOBAL PROPERTY IMPORTED_ALWAYS_GLOBAL TRUE)
+endif()
+
+# Define External Dependency Function
+function(external_dependency)
+ cmake_parse_arguments(ARG "EXCLUDE_FROM_ALL;BUILD_ALWAYS" "VERSION;GIT_REPO;GIT_TAG" "" ${ARGN})
+
+ # -- Was dependency already found?
+ get_property(${ARGV0}_FOUND GLOBAL PROPERTY ${ARGV0}_FOUND)
+ if(${ARGV0}_FOUND)
+ message(STATUS "Dependency ${ARGV0} was already resolved.")
+ return()
+ endif()
+
+ # -- Try to find package in system.
+ if(NOT ARG_BUILD_ALWAYS AND NOT Build_Deps STREQUAL "Always")
+ find_package(${ARGV0} ${ARG_VERSION} QUIET HINTS ${CMAKE_INSTALL_PREFIX})
+ if(${ARGV0}_FOUND)
+ message(STATUS "Found dependency ${ARGV0} in system ${${ARGV0}_ROOT}")
+ return()
+ elseif(Build_Deps STREQUAL "Never")
+ message(FATAL_ERROR "Could not find dependency ${ARGV0} in system. Please install the dependency manually or use -DBuild_Deps=IfNotFound during cmake configuration to automatically build all dependencies that are not found.")
+ endif()
+ endif()
+
+ # -- Build package from source
+ message(STATUS " =============== Configuring Dependency ${ARGV0} =============== ")
+ if(ARG_EXCLUDE_FROM_ALL)
+ set(subdir_opts EXCLUDE_FROM_ALL)
+ set(Build_Tests OFF)
+ set(Build_Documentation OFF)
+ endif()
+ if(IS_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/${ARGV0})
+ message(STATUS "Found sources for dependency ${ARGV0} at ${CMAKE_CURRENT_SOURCE_DIR}/${ARGV0}")
+ add_subdirectory(${ARGV0} ${subdir_opts})
+ elseif(IS_DIRECTORY ${CMAKE_SOURCE_DIR}/deps/${ARGV0})
+ message(STATUS "Found sources for dependency ${ARGV0} at ${CMAKE_SOURCE_DIR}/deps/${ARGV0}")
+ add_subdirectory(${ARGV0} ${subdir_opts})
+ elseif(ARG_GIT_REPO)
+ set(bin_dir ${CMAKE_CURRENT_BINARY_DIR}/${ARGV0})
+ set(src_dir ${bin_dir}_src)
+ if(NOT IS_DIRECTORY ${src_dir})
+ if(ARG_GIT_TAG)
+ set(clone_opts --branch ${ARG_GIT_TAG} -c advice.detachedHead=false)
+ endif()
+ if(NOT GIT_EXECUTABLE)
+ find_package(Git REQUIRED)
+ endif()
+ execute_process(COMMAND ${GIT_EXECUTABLE} clone ${ARG_GIT_REPO} --depth 1 ${clone_opts} ${src_dir}
+ RESULT_VARIABLE clone_failed
+ ERROR_VARIABLE clone_error
+ )
+ if(clone_failed)
+ message(FATAL_ERROR "Failed to clone sources for dependency ${ARGV0}.\n ${clone_error}")
+ endif()
+ endif()
+ add_subdirectory(${src_dir} ${bin_dir} ${subdir_opts})
+ else()
+ message(FATAL_ERROR "Could not find or build dependency ${ARGV0}")
+ endif()
+ message(STATUS " =============== End ${ARGV0} Configuration =============== ")
+ set_property(GLOBAL PROPERTY ${ARGV0}_FOUND TRUE)
+
+endfunction()
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
new file mode 100644
index 0000000..40eb49c
--- /dev/null
+++ b/doc/CMakeLists.txt
@@ -0,0 +1,81 @@
+# Generate the sphinx config file
+configure_file(${CMAKE_CURRENT_SOURCE_DIR}/conf.py.in ${CMAKE_CURRENT_BINARY_DIR}/conf.py @ONLY)
+
+# -----------------------------------------------------------------------------
+# Create an optional target that allows us to regenerate the C++ doc with c++2rst
+# -----------------------------------------------------------------------------
+add_custom_target(${PROJECT_NAME}_docs_cpp2rst)
+include(${PROJECT_SOURCE_DIR}/share/cmake/extract_flags.cmake)
+extract_flags(${PROJECT_NAME}_c BUILD_INTERFACE)
+separate_arguments(${PROJECT_NAME}_c_CXXFLAGS)
+macro(generate_docs header_file)
+ add_custom_command(
+ TARGET ${PROJECT_NAME}_docs_cpp2rst
+ COMMAND rm -rf ${CMAKE_CURRENT_SOURCE_DIR}/cpp2rst_generated
+ COMMAND
+ PYTHONPATH=${CPP2PY_BINARY_DIR}:$ENV{PYTHONPATH}
+ PATH=${CPP2PY_BINARY_DIR}/bin:${CPP2PY_ROOT}/bin:$ENV{PATH}
+ c++2rst
+ ${header_file}
+ -N ${PROJECT_NAME}
+ --output_directory ${CMAKE_CURRENT_SOURCE_DIR}/cpp2rst_generated
+ -I${PROJECT_SOURCE_DIR}/c++
+ --cxxflags="${${PROJECT_NAME}_c_CXXFLAGS}"
+ )
+endmacro(generate_docs)
+
+generate_docs(${PROJECT_SOURCE_DIR}/c++/${PROJECT_NAME}/${PROJECT_NAME}.hpp)
+
+# --------------------------------------------------------
+# Build & Run the C++ doc examples and capture the output
+# --------------------------------------------------------
+
+add_custom_target(${PROJECT_NAME}_docs_example_output)
+file(GLOB_RECURSE ExampleList RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.cpp)
+foreach(example ${ExampleList})
+ get_filename_component(f ${example} NAME_WE)
+ get_filename_component(d ${example} DIRECTORY)
+ add_executable(${PROJECT_NAME}_doc_${f} EXCLUDE_FROM_ALL ${example})
+ set_property(TARGET ${PROJECT_NAME}_doc_${f} PROPERTY RUNTIME_OUTPUT_DIRECTORY ${d})
+ target_link_libraries(${PROJECT_NAME}_doc_${f} triqs)
+ add_custom_command(TARGET ${PROJECT_NAME}_doc_${f}
+ COMMAND ${PROJECT_NAME}_doc_${f} > ${CMAKE_CURRENT_SOURCE_DIR}/${d}/${f}.output 2>/dev/null
+ WORKING_DIRECTORY ${d}
+ )
+ add_dependencies(${PROJECT_NAME}_docs_example_output ${PROJECT_NAME}_doc_${f})
+endforeach()
+
+# ---------------------------------
+# Top Sphinx target
+# ---------------------------------
+if(NOT DEFINED SPHINXBUILD_EXECUTABLE)
+ find_package(Sphinx)
+endif()
+
+# Sphinx has internal caching, always run it
+add_custom_target(${PROJECT_NAME}_docs_sphinx ALL)
+add_custom_command(
+ TARGET ${PROJECT_NAME}_docs_sphinx
+ COMMAND PYTHONPATH=${PROJECT_BINARY_DIR}/python:$ENV{PYTHONPATH} ${SPHINXBUILD_EXECUTABLE} -j auto -c . -b html ${CMAKE_CURRENT_SOURCE_DIR} html
+)
+
+option(Sphinx_Only "When building the documentation, skip the Python Modules and the generation of C++ Api and example outputs" OFF)
+if(NOT Sphinx_Only)
+ # Autodoc usage requires the python modules to be built first
+ get_property(CPP2PY_MODULES_LIST GLOBAL PROPERTY CPP2PY_MODULES_LIST)
+ if(CPP2PY_MODULES_LIST)
+ add_dependencies(${PROJECT_NAME}_docs_sphinx ${CPP2PY_MODULES_LIST})
+ endif()
+
+ # Generation of C++ Api and Example Outputs
+ add_dependencies(${PROJECT_NAME}_docs_sphinx ${PROJECT_NAME}_docs_cpp2rst ${PROJECT_NAME}_docs_example_output)
+endif()
+
+# ---------------------------------
+# Install
+# ---------------------------------
+install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/ COMPONENT documentation DESTINATION share/doc/${PROJECT_NAME}
+ FILES_MATCHING
+ REGEX "\\.(html|pdf|png|gif|jpg|svg|ico|js|xsl|css|py|txt|inv|bib|ttf|woff2|eot|sh)$"
+ PATTERN "_*"
+)
diff --git a/doc/ChangeLog.md b/doc/ChangeLog.md
new file mode 100644
index 0000000..8d708da
--- /dev/null
+++ b/doc/ChangeLog.md
@@ -0,0 +1,35 @@
+(changelog)=
+
+# Changelog
+
+## Version 3.1.0
+
+app4triqs version 3.1.0 is a compatibility
+release for TRIQS version 3.1.0 that
+* moves to cmake 3.12.4 and c++20
+* improves ghactions and jenkins configuration
+* switches documentation to read-the-docs theme
+* uses googletest main branch
+* fixes several skeleton issues
+
+We thank all contributors: Alexander Hampel, Dylan Simon, Nils Wentzell
+
+
+## Version 3.0.0
+
+app4triqs version 3.0.0 is a compatibility
+release for TRIQS version 3.0.0 that
+* introduces compatibility with Python 3 (Python 2 no longer supported)
+* adds a cmake-based dependency management
+* fixes several application issues
+
+
+## Version 2.2.0
+
+app4triqs Version 2.2.0 provides a project
+skeleton for TRIQS applications based on
+the TRIQS Library Version 2.2.0.
+It is intended for applications with both
+Python and C++ components.
+
+This is the initial release for this project.
diff --git a/doc/_static/css/custom.css b/doc/_static/css/custom.css
new file mode 100644
index 0000000..a8c2f1b
--- /dev/null
+++ b/doc/_static/css/custom.css
@@ -0,0 +1,5 @@
+@import url("theme.css");
+
+.wy-nav-content {
+ max-width: 70em;
+}
diff --git a/doc/_static/logo_cea.png b/doc/_static/logo_cea.png
new file mode 100644
index 0000000..1a28b43
Binary files /dev/null and b/doc/_static/logo_cea.png differ
diff --git a/doc/_static/logo_cnrs.png b/doc/_static/logo_cnrs.png
new file mode 100644
index 0000000..53c7af0
Binary files /dev/null and b/doc/_static/logo_cnrs.png differ
diff --git a/doc/_static/logo_erc.jpg b/doc/_static/logo_erc.jpg
new file mode 100644
index 0000000..b7181ee
Binary files /dev/null and b/doc/_static/logo_erc.jpg differ
diff --git a/doc/_static/logo_flatiron.png b/doc/_static/logo_flatiron.png
new file mode 100644
index 0000000..9c97b4b
Binary files /dev/null and b/doc/_static/logo_flatiron.png differ
diff --git a/doc/_static/logo_github.png b/doc/_static/logo_github.png
new file mode 100644
index 0000000..54bca71
Binary files /dev/null and b/doc/_static/logo_github.png differ
diff --git a/doc/_static/logo_simons.jpg b/doc/_static/logo_simons.jpg
new file mode 100644
index 0000000..8843123
Binary files /dev/null and b/doc/_static/logo_simons.jpg differ
diff --git a/doc/_static/logo_x.png b/doc/_static/logo_x.png
new file mode 100644
index 0000000..18aba0b
Binary files /dev/null and b/doc/_static/logo_x.png differ
diff --git a/doc/_static/triqs_logo/Icon/JPG/Triqs_Icon_RGB_Black.jpg b/doc/_static/triqs_logo/Icon/JPG/Triqs_Icon_RGB_Black.jpg
new file mode 100755
index 0000000..a25819a
Binary files /dev/null and b/doc/_static/triqs_logo/Icon/JPG/Triqs_Icon_RGB_Black.jpg differ
diff --git a/doc/_static/triqs_logo/Icon/JPG/Triqs_Icon_RGB_Full.jpg b/doc/_static/triqs_logo/Icon/JPG/Triqs_Icon_RGB_Full.jpg
new file mode 100755
index 0000000..8fac42a
Binary files /dev/null and b/doc/_static/triqs_logo/Icon/JPG/Triqs_Icon_RGB_Full.jpg differ
diff --git a/doc/_static/triqs_logo/Icon/SVG/Triqs_Icon_RGB_Black.svg b/doc/_static/triqs_logo/Icon/SVG/Triqs_Icon_RGB_Black.svg
new file mode 100755
index 0000000..ff59848
--- /dev/null
+++ b/doc/_static/triqs_logo/Icon/SVG/Triqs_Icon_RGB_Black.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/doc/_static/triqs_logo/Icon/SVG/Triqs_Icon_RGB_Full.svg b/doc/_static/triqs_logo/Icon/SVG/Triqs_Icon_RGB_Full.svg
new file mode 100755
index 0000000..76d6707
--- /dev/null
+++ b/doc/_static/triqs_logo/Icon/SVG/Triqs_Icon_RGB_Full.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/doc/_static/triqs_logo/Icon/SVG/Triqs_Icon_RGB_White.svg b/doc/_static/triqs_logo/Icon/SVG/Triqs_Icon_RGB_White.svg
new file mode 100755
index 0000000..4fbd963
--- /dev/null
+++ b/doc/_static/triqs_logo/Icon/SVG/Triqs_Icon_RGB_White.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/doc/_static/triqs_logo/Logo/JPG/Triqs_Logo_RGB_Black.jpg b/doc/_static/triqs_logo/Logo/JPG/Triqs_Logo_RGB_Black.jpg
new file mode 100755
index 0000000..a9206e0
Binary files /dev/null and b/doc/_static/triqs_logo/Logo/JPG/Triqs_Logo_RGB_Black.jpg differ
diff --git a/doc/_static/triqs_logo/Logo/JPG/Triqs_Logo_RGB_Full.jpg b/doc/_static/triqs_logo/Logo/JPG/Triqs_Logo_RGB_Full.jpg
new file mode 100755
index 0000000..58e6a81
Binary files /dev/null and b/doc/_static/triqs_logo/Logo/JPG/Triqs_Logo_RGB_Full.jpg differ
diff --git a/doc/_static/triqs_logo/Logo/SVG/Triqs_Logo_RGB_Black.svg b/doc/_static/triqs_logo/Logo/SVG/Triqs_Logo_RGB_Black.svg
new file mode 100755
index 0000000..27ff0f4
--- /dev/null
+++ b/doc/_static/triqs_logo/Logo/SVG/Triqs_Logo_RGB_Black.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/doc/_static/triqs_logo/Logo/SVG/Triqs_Logo_RGB_Full.svg b/doc/_static/triqs_logo/Logo/SVG/Triqs_Logo_RGB_Full.svg
new file mode 100755
index 0000000..149bdb6
--- /dev/null
+++ b/doc/_static/triqs_logo/Logo/SVG/Triqs_Logo_RGB_Full.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/doc/_static/triqs_logo/Logo/SVG/Triqs_Logo_RGB_White.svg b/doc/_static/triqs_logo/Logo/SVG/Triqs_Logo_RGB_White.svg
new file mode 100755
index 0000000..eb273f9
--- /dev/null
+++ b/doc/_static/triqs_logo/Logo/SVG/Triqs_Logo_RGB_White.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/doc/_static/triqs_logo/triqs_favicon.ico b/doc/_static/triqs_logo/triqs_favicon.ico
new file mode 100644
index 0000000..9e20d73
Binary files /dev/null and b/doc/_static/triqs_logo/triqs_favicon.ico differ
diff --git a/doc/_templates/autosummary_class_template.rst b/doc/_templates/autosummary_class_template.rst
new file mode 100644
index 0000000..49fc678
--- /dev/null
+++ b/doc/_templates/autosummary_class_template.rst
@@ -0,0 +1,29 @@
+{{ fullname | escape | underline }}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+
+{% block methods %}
+{% if methods %}
+.. rubric:: {{ _('Methods') }}
+
+.. autosummary::
+ :toctree:
+ {% for item in methods %}
+ ~{{ name }}.{{ item }}
+ {%- endfor %}
+{% endif %}
+{% endblock %}
+
+{% block attributes %}
+{% if attributes %}
+.. rubric:: {{ _('Attributes') }}
+
+.. autosummary::
+ :toctree:
+ {% for item in attributes %}
+ ~{{ name }}.{{ item }}
+ {%- endfor %}
+{% endif %}
+{% endblock %}
diff --git a/doc/_templates/autosummary_module_template.rst b/doc/_templates/autosummary_module_template.rst
new file mode 100644
index 0000000..737206f
--- /dev/null
+++ b/doc/_templates/autosummary_module_template.rst
@@ -0,0 +1,68 @@
+{{ fullname | escape | underline}}
+
+.. automodule:: {{ fullname }}
+
+{% block functions %}
+{% if functions %}
+.. rubric:: Functions
+
+.. autosummary::
+ :toctree:
+ {% for item in functions %}
+ {{ item }}
+ {%- endfor %}
+{% endif %}
+{% endblock %}
+
+{% block attributes %}
+{% if attributes %}
+.. rubric:: Module Attributes
+
+.. autosummary::
+ :toctree:
+ {% for item in attributes %}
+ {{ item }}
+ {%- endfor %}
+{% endif %}
+{% endblock %}
+
+{% block classes %}
+{% if classes %}
+.. rubric:: {{ _('Classes') }}
+
+.. autosummary::
+ :toctree:
+ :template: autosummary_class_template.rst
+ {% for item in classes %}
+ {{ item }}
+ {%- endfor %}
+{% endif %}
+{% endblock %}
+
+{% block exceptions %}
+{% if exceptions %}
+.. rubric:: {{ _('Exceptions') }}
+
+.. autosummary::
+ :toctree:
+ {% for item in exceptions %}
+ {{ item }}
+ {%- endfor %}
+{% endif %}
+{% endblock %}
+
+{% block modules %}
+{% if modules %}
+.. rubric:: Modules
+
+.. autosummary::
+ :toctree:
+ :template: autosummary_module_template.rst
+ :recursive:
+
+ {% for item in modules %}
+ {{ item }}
+ {%- endfor %}
+{% endif %}
+{% endblock %}
+
diff --git a/doc/_templates/sideb.html b/doc/_templates/sideb.html
new file mode 100644
index 0000000..b4cc0b1
--- /dev/null
+++ b/doc/_templates/sideb.html
@@ -0,0 +1,14 @@
+
+ 
+ 
+
+ 
+
+ 
+
+ 
+
+
+
+ 
+
diff --git a/doc/about.rst b/doc/about.rst
new file mode 100644
index 0000000..c91ecb8
--- /dev/null
+++ b/doc/about.rst
@@ -0,0 +1,8 @@
+.. _about:
+
+About app4triqs
+***************
+
+An example application using ``cpp2py`` and TRIQS.
+
+Written and maintained by N. Wentzell with contributions from H. U.R. Strand.
diff --git a/doc/conf.py.in b/doc/conf.py.in
new file mode 100644
index 0000000..3eb0de9
--- /dev/null
+++ b/doc/conf.py.in
@@ -0,0 +1,144 @@
+# -*- coding: utf-8 -*-
+#
+# TRIQS documentation build configuration file
+
+import sys
+sys.path.insert(0, "@CMAKE_CURRENT_SOURCE_DIR@/sphinxext")
+
+# exclude these folders from scanning by sphinx
+exclude_patterns = ['_templates']
+
+extensions = ['sphinx.ext.autodoc',
+ 'sphinx.ext.mathjax',
+ 'sphinx.ext.intersphinx',
+ 'sphinx.ext.doctest',
+ 'sphinx.ext.todo',
+ 'sphinx.ext.viewcode',
+ 'sphinx.ext.autosummary',
+ 'sphinx.ext.githubpages',
+ 'sphinx_autorun',
+ 'nbsphinx',
+ 'myst_parser',
+ 'matplotlib.sphinxext.plot_directive',
+ 'numpydoc']
+
+myst_enable_extensions = [
+ "amsmath",
+ "colon_fence",
+ "deflist",
+ "dollarmath",
+ "html_admonition",
+ "html_image",
+ "linkify",
+ "replacements",
+ "smartquotes",
+ "substitution",
+ "tasklist",
+]
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+source_suffix = '.rst'
+
+# Turn on sphinx.ext.autosummary
+autosummary_generate = True
+autosummary_imported_members=False
+
+project = '@PROJECT_NAME@'
+version = '@PROJECT_VERSION@'
+
+# this makes the current project version available as var in every rst file
+rst_epilog = """
+.. |PROJECT_VERSION| replace:: {version}
+""".format(
+version = version,
+)
+
+copyright = '2018-2021 The Simons Foundation, authors: A. Hampel, O. Parcollet, D. Simons, H. Strand, N. Wentzell'
+
+mathjax_path = "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.7/MathJax.js?config=default"
+templates_path = ['@CMAKE_CURRENT_SOURCE_DIR@/_templates']
+
+# this requires the sphinx_rtd_theme to be installed via pip
+html_theme = 'sphinx_rtd_theme'
+# this loads the custom css file to change the page width
+html_style = 'css/custom.css'
+
+html_favicon = '@CMAKE_CURRENT_SOURCE_DIR@/_static/triqs_logo/triqs_favicon.ico'
+#html_logo = '@CMAKE_CURRENT_SOURCE_DIR@/logos/logo.png'
+
+# options for the the rtd theme
+html_theme_options = {
+ 'logo_only': False,
+ 'display_version': True,
+ 'prev_next_buttons_location': 'bottom',
+ 'style_external_links': False,
+ 'vcs_pageview_mode': '',
+ 'style_nav_header_background': '#7E588A',
+ # Toc options
+ 'collapse_navigation': False,
+ 'sticky_navigation': True,
+ 'navigation_depth': 5,
+ 'includehidden': True,
+ 'titles_only': False
+}
+
+html_show_sphinx = False
+
+html_context = {'header_title': '@PROJECT_NAME@'}
+
+html_static_path = ['@CMAKE_CURRENT_SOURCE_DIR@/_static']
+html_sidebars = {'index': ['sideb.html', 'searchbox.html']}
+
+htmlhelp_basename = '@PROJECT_NAME@doc'
+
+# Plot options
+plot_include_source = True
+plot_html_show_source_link = False
+plot_html_show_formats = False
+
+intersphinx_mapping = {'python': ('https://docs.python.org/3.11', None), 'triqslibs': ('https://triqs.github.io/triqs/latest', None)}
+
+# open links in new tab instead of same window
+from sphinx.writers.html import HTMLTranslator
+from docutils import nodes
+from docutils.nodes import Element
+
+class PatchedHTMLTranslator(HTMLTranslator):
+
+ def visit_reference(self, node: Element) -> None:
+ atts = {'class': 'reference'}
+ if node.get('internal') or 'refuri' not in node:
+ atts['class'] += ' internal'
+ else:
+ atts['class'] += ' external'
+ # ---------------------------------------------------------
+ # Customize behavior (open in new tab, secure linking site)
+ atts['target'] = '_blank'
+ atts['rel'] = 'noopener noreferrer'
+ # ---------------------------------------------------------
+ if 'refuri' in node:
+ atts['href'] = node['refuri'] or '#'
+ if self.settings.cloak_email_addresses and atts['href'].startswith('mailto:'):
+ atts['href'] = self.cloak_mailto(atts['href'])
+ self.in_mailto = True
+ else:
+ assert 'refid' in node, \
+ 'References must have "refuri" or "refid" attribute.'
+ atts['href'] = '#' + node['refid']
+ if not isinstance(node.parent, nodes.TextElement):
+ assert len(node) == 1 and isinstance(node[0], nodes.image)
+ atts['class'] += ' image-reference'
+ if 'reftitle' in node:
+ atts['title'] = node['reftitle']
+ if 'target' in node:
+ atts['target'] = node['target']
+ self.body.append(self.starttag(node, 'a', '', **atts))
+
+ if node.get('secnumber'):
+ self.body.append(('%s' + self.secnumber_suffix) %
+ '.'.join(map(str, node['secnumber'])))
+
+def setup(app):
+ app.set_translator('html', PatchedHTMLTranslator)
diff --git a/doc/documentation.rst b/doc/documentation.rst
new file mode 100644
index 0000000..a05d717
--- /dev/null
+++ b/doc/documentation.rst
@@ -0,0 +1,29 @@
+.. _documentation:
+
+Documentation
+*************
+
+
+.. math::
+
+ (a + b)^2 &= (a + b)(a + b) \\
+ &= a^2 + 2ab + b^2
+
+
+C++ reference manual
+====================
+
+.. toctree::
+ :maxdepth: 5
+
+ cpp2rst_generated/contents
+
+Python reference manual
+=======================
+
+.. autosummary::
+ :toctree: _autosummary
+ :template: autosummary_module_template.rst
+ :recursive:
+
+ app4triqs
diff --git a/doc/index.rst b/doc/index.rst
new file mode 100644
index 0000000..94054b8
--- /dev/null
+++ b/doc/index.rst
@@ -0,0 +1,33 @@
+.. _welcome:
+
+app4triqs
+*********
+
+.. sidebar:: app4triqs |PROJECT_VERSION|
+
+ This is the homepage of app4triqs |PROJECT_VERSION|.
+ For changes see the :ref:`changelog page `.
+
+ .. image:: _static/logo_github.png
+ :width: 75%
+ :align: center
+ :target: https://github.com/triqs/app4triqs
+
+
+An example application using cpp2py and :ref:`TRIQS `.
+
+This documentation is generated based on `rst `_ files
+and the comments in the sources and headers.
+
+Learn how to use app4triqs in the :ref:`documentation`.
+
+
+.. toctree::
+ :maxdepth: 2
+ :hidden:
+
+ install
+ documentation
+ issues
+ ChangeLog.md
+ about
diff --git a/doc/install.rst b/doc/install.rst
new file mode 100644
index 0000000..1c7766b
--- /dev/null
+++ b/doc/install.rst
@@ -0,0 +1,77 @@
+.. highlight:: bash
+
+.. _install:
+
+Install app4triqs
+*******************
+
+Compiling app4triqs from source
+===============================
+
+.. note:: To guarantee reproducibility in scientific calculations we strongly recommend the use of a stable `release `_ of both TRIQS and its applications.
+
+Prerequisites
+-------------
+
+#. The :ref:`TRIQS ` library, see :ref:`TRIQS installation instruction `.
+ In the following, we assume that TRIQS is installed in the directory ``path_to_triqs``.
+
+Installation steps
+------------------
+
+#. Download the source code of the latest stable version by cloning the ``TRIQS/app4triqs`` repository from GitHub::
+
+ $ git clone https://github.com/TRIQS/app4triqs app4triqs.src
+
+#. Create and move to a new directory where you will compile the code::
+
+ $ mkdir app4triqs.build && cd app4triqs.build
+
+#. Ensure that your shell contains the TRIQS environment variables by sourcing the ``triqsvars.sh`` file from your TRIQS installation::
+
+ $ source path_to_triqs/share/triqs/triqsvars.sh
+
+#. In the build directory call cmake, including any additional custom CMake options, see below::
+
+ $ cmake ../app4triqs.src
+
+#. Compile the code, run the tests and install the application::
+
+ $ make
+ $ make test
+ $ make install
+
+Version compatibility
+---------------------
+
+Keep in mind that the version of ``app4triqs`` must be compatible with your TRIQS library version,
+see :ref:`TRIQS website `.
+In particular the Major and Minor Version numbers have to be the same.
+To use a particular version, go into the directory with the sources, and look at all available versions::
+
+ $ cd app4triqs.src && git tag
+
+Checkout the version of the code that you want::
+
+ $ git checkout 2.1.0
+
+and follow steps 2 to 4 above to compile the code.
+
+Custom CMake options
+--------------------
+
+The compilation of ``app4triqs`` can be configured using CMake-options::
+
+ cmake ../app4triqs.src -DOPTION1=value1 -DOPTION2=value2 ...
+
++-----------------------------------------------------------------+-----------------------------------------------+
+| Options | Syntax |
++=================================================================+===============================================+
+| Specify an installation path other than path_to_triqs | -DCMAKE_INSTALL_PREFIX=path_to_app4triqs |
++-----------------------------------------------------------------+-----------------------------------------------+
+| Build in Debugging Mode | -DCMAKE_BUILD_TYPE=Debug |
++-----------------------------------------------------------------+-----------------------------------------------+
+| Disable testing (not recommended) | -DBuild_Tests=OFF |
++-----------------------------------------------------------------+-----------------------------------------------+
+| Build the documentation | -DBuild_Documentation=ON |
++-----------------------------------------------------------------+-----------------------------------------------+
diff --git a/doc/issues.rst b/doc/issues.rst
new file mode 100644
index 0000000..bdd0d5c
--- /dev/null
+++ b/doc/issues.rst
@@ -0,0 +1,23 @@
+.. _issues:
+
+Reporting issues
+****************
+
+Please report all problems and bugs directly at the github issue page
+``_. In order to make it easier for us
+to solve the issue please follow these guidelines:
+
+#. In all cases specify which version of the application you are using. You can
+ find the version number in the file :file:`CMakeLists.txt` at the root of the
+ application sources.
+
+#. If you have a problem during the installation, give us information about
+ your operating system and the compiler you are using. Include the outputs of
+ the ``cmake`` and ``make`` commands as well as the ``CMakeCache.txt`` file
+ which is in the build directory. Please include these outputs in a
+ `gist Home »
+{% endblock %}
+
+{% block header %}
+
+
+ {% for header_link in header_links %}
+ - {{ header_link[0] }}
+ {% endfor %}
+
+
+ {{ header_title }}
+ {{ header_subtitle }}
+
+
+{% endblock %}
diff --git a/doc/themes/triqs/static/bodybg.png b/doc/themes/triqs/static/bodybg.png
new file mode 100644
index 0000000..506b6f9
Binary files /dev/null and b/doc/themes/triqs/static/bodybg.png differ
diff --git a/doc/themes/triqs/static/cufon-yui.js b/doc/themes/triqs/static/cufon-yui.js
new file mode 100644
index 0000000..935614e
--- /dev/null
+++ b/doc/themes/triqs/static/cufon-yui.js
@@ -0,0 +1,7 @@
+/*
+ * Copyright (c) 2009 Simo Kinnunen.
+ * Licensed under the MIT license.
+ *
+ * @version 1.09i
+ */
+var Cufon=(function(){var m=function(){return m.replace.apply(null,arguments)};var x=m.DOM={ready:(function(){var C=false,E={loaded:1,complete:1};var B=[],D=function(){if(C){return}C=true;for(var F;F=B.shift();F()){}};if(document.addEventListener){document.addEventListener("DOMContentLoaded",D,false);window.addEventListener("pageshow",D,false)}if(!window.opera&&document.readyState){(function(){E[document.readyState]?D():setTimeout(arguments.callee,10)})()}if(document.readyState&&document.createStyleSheet){(function(){try{document.body.doScroll("left");D()}catch(F){setTimeout(arguments.callee,1)}})()}q(window,"load",D);return function(F){if(!arguments.length){D()}else{C?F():B.push(F)}}})(),root:function(){return document.documentElement||document.body}};var n=m.CSS={Size:function(C,B){this.value=parseFloat(C);this.unit=String(C).match(/[a-z%]*$/)[0]||"px";this.convert=function(D){return D/B*this.value};this.convertFrom=function(D){return D/this.value*B};this.toString=function(){return this.value+this.unit}},addClass:function(C,B){var D=C.className;C.className=D+(D&&" ")+B;return C},color:j(function(C){var B={};B.color=C.replace(/^rgba\((.*?),\s*([\d.]+)\)/,function(E,D,F){B.opacity=parseFloat(F);return"rgb("+D+")"});return B}),fontStretch:j(function(B){if(typeof B=="number"){return B}if(/%$/.test(B)){return parseFloat(B)/100}return{"ultra-condensed":0.5,"extra-condensed":0.625,condensed:0.75,"semi-condensed":0.875,"semi-expanded":1.125,expanded:1.25,"extra-expanded":1.5,"ultra-expanded":2}[B]||1}),getStyle:function(C){var B=document.defaultView;if(B&&B.getComputedStyle){return new a(B.getComputedStyle(C,null))}if(C.currentStyle){return new a(C.currentStyle)}return new a(C.style)},gradient:j(function(F){var G={id:F,type:F.match(/^-([a-z]+)-gradient\(/)[1],stops:[]},C=F.substr(F.indexOf("(")).match(/([\d.]+=)?(#[a-f0-9]+|[a-z]+\(.*?\)|[a-z]+)/ig);for(var E=0,B=C.length,D;E0){E=" "+E}}else{if(B400}if(I==500){I=400}for(var J in G){if(!k(G,J)){continue}J=parseInt(J,10);if(!F||JD){D=J}K.push(J)}if(ID){I=D}K.sort(function(M,L){return(E?(M>=I&&L>=I)?ML:(M<=I&&L<=I)?M>L:Mcufoncanvas{text-indent:0;}@media screen{cvml\\:shape,cvml\\:rect,cvml\\:fill,cvml\\:shadow{behavior:url(#default#VML);display:block;antialias:true;position:absolute;}cufoncanvas{position:absolute;text-align:left;}cufon{display:inline-block;position:relative;vertical-align:'+(h?"middle":"text-bottom")+";}cufon cufontext{position:absolute;left:-10000in;font-size:1px;}a cufon{cursor:pointer}}@media print{cufon cufoncanvas{display:none;}}").replace(/;/g,"!important;"));function c(i,j){return a(i,/(?:em|ex|%)$|^[a-z-]+$/i.test(j)?"1em":j)}function a(l,m){if(m==="0"){return 0}if(/px$/i.test(m)){return parseFloat(m)}var k=l.style.left,j=l.runtimeStyle.left;l.runtimeStyle.left=l.currentStyle.left;l.style.left=m.replace("%","em");var i=l.style.pixelLeft;l.style.left=k;l.runtimeStyle.left=j;return i}function f(l,k,j,n){var i="computed"+n,m=k[i];if(isNaN(m)){m=k.get(n);k[i]=m=(m=="normal")?0:~~j.convertFrom(a(l,m))}return m}var g={};function d(p){var q=p.id;if(!g[q]){var n=p.stops,o=document.createElement("cvml:fill"),i=[];o.type="gradient";o.angle=180;o.focus="0";o.method="sigma";o.color=n[0][1];for(var m=1,l=n.length-1;mO){O=K}if(I>N){N=I}if(K":{"w":232},"?":{"d":"413,-133r0,133r-192,0r0,-133r192,0xm221,-188v-13,-173,78,-281,237,-282r341,0v53,0,80,-24,80,-71v0,-47,-27,-71,-80,-71r-799,0r0,-166r817,-1v141,-1,227,93,227,236v0,149,-87,234,-227,234r-315,0v-67,-1,-99,45,-89,121r-192,0","w":1218},"@":{"d":"305,-388v0,55,25,70,85,70r436,0r0,-146r-439,0v-55,0,-82,25,-82,76xm339,-62v-218,3,-334,-116,-339,-327v-4,-168,93,-282,227,-315v106,-26,574,-16,605,-3v56,23,105,70,105,151r0,316r-579,0v-98,2,-164,-54,-164,-148v0,-106,69,-154,188,-154r444,0v-2,-97,-62,-97,-185,-100v-135,-3,-342,-4,-427,22v-86,26,-136,115,-136,231v0,166,96,250,261,250r483,0r0,77r-483,0","w":1060},"A":{"d":"754,-341v0,-61,-24,-84,-89,-84r-626,0r0,-131r667,0v135,5,215,66,215,217r0,339r-745,0v-108,1,-176,-63,-176,-171v0,-107,69,-171,176,-170r578,0xm754,-131r0,-85r-534,0v-35,0,-53,14,-53,43v0,28,18,42,53,42r534,0","w":1096},"B":{"d":"969,-278v0,176,-93,278,-267,278r-702,0r0,-778r167,0r0,222r535,0v170,-2,267,101,267,278xm794,-278v0,-81,-38,-139,-114,-139r-513,0r0,278r513,0v76,0,114,-58,114,-139","w":1097},"C":{"d":"0,-278v0,-173,94,-278,267,-278r595,0r0,139r-573,0v-76,0,-114,58,-114,139v0,81,38,139,114,139r573,0r0,139r-595,0v-173,1,-267,-105,-267,-278","w":1022},"D":{"d":"0,-278v-1,-176,93,-278,267,-278r521,0r0,-222r167,0r0,778r-688,0v-171,2,-266,-102,-267,-278xm175,-278v0,81,38,139,114,139r499,0r0,-278r-499,0v-76,0,-114,58,-114,139","w":1130},"E":{"d":"176,-216v24,58,48,85,113,85r581,0r0,131r-603,0v-173,1,-267,-105,-267,-278v0,-173,94,-278,267,-278r603,0r0,131r-581,0v-65,4,-87,27,-113,84r694,0r0,125r-694,0","w":1022},"F":{"d":"105,-341v-10,-142,29,-222,167,-222r501,1r0,130r-423,0v-60,-4,-81,31,-78,91r501,-2r0,131r-501,2r0,425r-167,0r0,-425r-105,0r0,-131r105,0","w":906},"G":{"d":"0,-278v0,-173,94,-278,267,-278r770,1r0,571v3,126,-82,208,-203,208r-773,-2r0,-130r743,1v55,0,68,-33,66,-93r-603,0v-173,1,-267,-105,-267,-278xm175,-278v0,81,37,139,114,139r581,-2r0,-275r-581,-1v-76,0,-114,58,-114,139","w":1204},"H":{"d":"735,-359v1,-35,-25,-58,-58,-58r-510,0r0,417r-167,0r0,-778r167,0r0,222r537,0v116,-4,198,68,198,170r0,386r-167,0r0,-359"},"I":{"d":"167,0r-167,0r0,-556r167,0r0,556xm167,-612r-167,0r0,-133r167,0r0,133","w":334},"J":{"d":"743,-612r-167,0r0,-133r167,0r0,133xm743,40v-5,114,-100,182,-221,182r-522,0r0,-139r510,0v44,0,66,-24,66,-73r0,-566r167,0r0,596","w":916},"K":{"d":"767,-481r146,0r0,-77r-146,0r0,77xm1040,-2v25,-199,-69,-334,-263,-334r-610,1r0,-442r-167,0r0,775r167,0r0,-195r588,0v95,-4,128,100,107,195r178,0xm914,-481v0,97,-49,145,-146,145r0,-145r146,0xm767,-481v4,77,-98,149,-175,146r175,0r0,-146","w":1195},"L":{"d":"183,-299v0,80,47,132,132,132r523,0r0,167r-569,0v-174,4,-268,-107,-268,-282r0,-276r182,0r0,259","w":996},"M":{"d":"961,-556v116,-4,197,66,197,170r0,386r-167,0r0,-359v0,-39,-19,-58,-58,-58r-273,0r0,417r-167,0r0,-417r-326,0r0,417r-167,0r0,-556r961,0","w":1312},"N":{"d":"688,-556v116,-4,198,68,198,170r0,386r-167,0r0,-359v0,-39,-19,-58,-58,-58r-494,0r0,417r-167,0r0,-556r688,0","w":1057},"O":{"d":"7,-368v-3,-111,96,-207,207,-207r536,0v112,-3,207,95,207,207r0,162v3,111,-96,207,-207,207r-536,0v-110,3,-207,-97,-207,-207r0,-162xm264,-445v-45,-1,-85,40,-85,85r0,138v-1,45,40,85,85,85r428,0v45,1,85,-40,85,-85r0,-138v1,-45,-40,-85,-85,-85r-428,0","w":1104},"P":{"d":"986,-278v1,176,-93,278,-267,278r-552,0r0,222r-167,0r0,-778r719,0v171,-2,266,102,267,278xm811,-278v0,-81,-38,-139,-114,-139r-530,0r0,278r530,0v76,0,114,-58,114,-139","w":1141},"Q":{"d":"0,-278v-1,-176,93,-278,267,-278r777,2r0,776r-167,0r0,-223r-610,1v-171,2,-266,-102,-267,-278xm175,-278v0,81,38,139,114,139r588,-1r0,-275r-588,-2v-77,0,-114,58,-114,139","w":1211},"R":{"d":"610,-558v134,0,213,83,197,228r-167,0v4,-51,-8,-86,-58,-86r-415,-1r0,417r-167,0r0,-556","w":950},"S":{"d":"913,-170v0,103,-65,170,-175,170r-738,0r0,-131r705,1v37,0,55,-14,55,-43v0,-28,-18,-42,-55,-42r-530,-1v-102,1,-175,-66,-175,-169v0,-101,66,-171,175,-171r708,0r0,131r-675,0v-37,0,-55,14,-55,42v0,28,18,42,55,42r530,1v102,-1,175,67,175,170","w":1039},"T":{"d":"267,-208v1,58,20,77,78,77r425,0r0,131r-504,0v-116,-3,-166,-47,-166,-167r0,-258r-100,0r0,-131r100,0r0,-222r167,0r0,222r503,0r0,131r-503,0r0,217","w":917},"U":{"d":"198,0v-119,6,-198,-71,-198,-170r0,-386r167,0r0,358v0,39,19,59,58,59r506,0r0,-417r167,0r0,556r-700,0"},"V":{"d":"167,-139r564,0r0,-417r167,0r0,556r-898,0r0,-556r167,0r0,417"},"W":{"d":"197,0v-115,4,-197,-68,-197,-170r0,-386r167,0r0,358v0,39,19,59,58,59r273,0r0,-417r167,0r0,417r326,0r0,-417r167,0r0,556r-961,0","w":1323},"X":{"d":"132,-208r646,0r0,-131r-646,0r0,131xm1,-138v-2,-70,61,-133,131,-131r0,131r-131,0xm0,-138r132,0r0,138r-132,0r0,-138xm1,-396v-2,71,61,133,131,131r0,-131r-131,0xm0,-396r132,0r0,-158r-132,0r0,158xm909,-138v2,-70,-61,-133,-131,-131r0,131r131,0xm910,-138r-132,0r0,138r132,0r0,-138xm909,-396v2,71,-61,133,-131,131r0,-131r131,0xm910,-396r-132,0r0,-158r132,0r0,158xm133,-454v-2,62,53,117,115,115r-115,0r0,-115xm133,-94v-2,-62,53,-117,115,-115r-115,0r0,115xm777,-454v2,62,-53,117,-115,115r115,0r0,-115xm778,-93v2,-62,-54,-117,-115,-115r115,0r0,115","w":1017},"Y":{"d":"754,92v53,-1,68,-31,66,-92r-622,0v-119,6,-198,-71,-198,-170r0,-386r167,0r0,336v-1,49,32,82,81,81r572,0r0,-417r167,0r0,576v3,124,-85,207,-204,207r-769,0r0,-135r740,0","w":1169},"Z":{"d":"0,-170v0,101,66,170,175,170r738,0r0,-131r-704,1v-37,0,-56,-14,-56,-43v0,-28,19,-42,56,-42r529,-1v102,1,175,-66,175,-169v0,-102,-66,-171,-175,-171r-707,-2r0,131r674,2v37,0,55,14,55,42v0,28,-18,42,-55,42r-530,1v-102,-1,-175,67,-175,170","w":1039},"[":{"d":"0,-931r306,0r0,153r-153,0r0,778r153,0r0,153r-306,0r0,-1084","w":361},"\\":{"d":"877,0r-692,-778r-185,0r681,778r196,0","w":942},"]":{"w":366},"^":{"w":406},"_":{"d":"0,61r1001,0r0,161r-1001,0r0,-161","w":1172},"`":{"d":"0,-806r94,0r112,111r-95,0","w":261},"a":{"d":"754,-341v0,-61,-24,-84,-89,-84r-626,0r0,-131r667,0v135,5,215,66,215,217r0,339r-745,0v-108,1,-176,-63,-176,-171v0,-107,69,-171,176,-170r578,0xm754,-131r0,-85r-534,0v-35,0,-53,14,-53,43v0,28,18,42,53,42r534,0","w":1096},"b":{"d":"969,-278v0,176,-93,278,-267,278r-702,0r0,-778r167,0r0,222r535,0v170,-2,267,101,267,278xm794,-278v0,-81,-38,-139,-114,-139r-513,0r0,278r513,0v76,0,114,-58,114,-139","w":1097},"c":{"d":"0,-278v0,-173,94,-278,267,-278r595,0r0,139r-573,0v-76,0,-114,58,-114,139v0,81,38,139,114,139r573,0r0,139r-595,0v-173,1,-267,-105,-267,-278","w":1022},"d":{"d":"0,-278v-1,-176,93,-278,267,-278r521,0r0,-222r167,0r0,778r-688,0v-171,2,-266,-102,-267,-278xm175,-278v0,81,38,139,114,139r499,0r0,-278r-499,0v-76,0,-114,58,-114,139","w":1130},"e":{"d":"176,-216v24,58,48,85,113,85r581,0r0,131r-603,0v-173,1,-267,-105,-267,-278v0,-173,94,-278,267,-278r603,0r0,131r-581,0v-65,4,-87,27,-113,84r694,0r0,125r-694,0","w":1022},"f":{"d":"105,-341v-10,-142,29,-222,167,-222r501,1r0,130r-423,0v-60,-4,-81,31,-78,91r501,-2r0,131r-501,2r0,425r-167,0r0,-425r-105,0r0,-131r105,0","w":906},"g":{"d":"0,-278v0,-173,94,-278,267,-278r770,1r0,571v3,126,-82,208,-203,208r-773,-2r0,-130r743,1v55,0,68,-33,66,-93r-603,0v-173,1,-267,-105,-267,-278xm175,-278v0,81,37,139,114,139r581,-2r0,-275r-581,-1v-76,0,-114,58,-114,139","w":1204},"h":{"d":"735,-359v1,-35,-25,-58,-58,-58r-510,0r0,417r-167,0r0,-778r167,0r0,222r537,0v116,-4,198,68,198,170r0,386r-167,0r0,-359"},"i":{"d":"167,0r-167,0r0,-556r167,0r0,556xm167,-612r-167,0r0,-133r167,0r0,133","w":334},"j":{"d":"743,-612r-167,0r0,-133r167,0r0,133xm743,40v-5,114,-100,182,-221,182r-522,0r0,-139r510,0v44,0,66,-24,66,-73r0,-566r167,0r0,596","w":916},"k":{"d":"767,-481r146,0r0,-77r-146,0r0,77xm1040,-2v25,-199,-69,-334,-263,-334r-610,1r0,-442r-167,0r0,775r167,0r0,-195r588,0v95,-4,128,100,107,195r178,0xm914,-481v0,97,-49,145,-146,145r0,-145r146,0xm767,-481v4,77,-98,149,-175,146r175,0r0,-146","w":1195},"l":{"d":"183,-299v0,80,47,132,132,132r523,0r0,167r-569,0v-174,4,-268,-107,-268,-282r0,-276r182,0r0,259","w":996},"m":{"d":"961,-556v116,-4,197,66,197,170r0,386r-167,0r0,-359v0,-39,-19,-58,-58,-58r-273,0r0,417r-167,0r0,-417r-326,0r0,417r-167,0r0,-556r961,0","w":1312},"n":{"d":"688,-556v116,-4,198,68,198,170r0,386r-167,0r0,-359v0,-39,-19,-58,-58,-58r-494,0r0,417r-167,0r0,-556r688,0","w":1057},"o":{"d":"7,-368v-3,-111,96,-207,207,-207r536,0v112,-3,207,95,207,207r0,162v3,111,-96,207,-207,207r-536,0v-110,3,-207,-97,-207,-207r0,-162xm264,-445v-45,-1,-85,40,-85,85r0,138v-1,45,40,85,85,85r428,0v45,1,85,-40,85,-85r0,-138v1,-45,-40,-85,-85,-85r-428,0","w":1104},"p":{"d":"986,-278v1,176,-93,278,-267,278r-552,0r0,222r-167,0r0,-778r719,0v171,-2,266,102,267,278xm811,-278v0,-81,-38,-139,-114,-139r-530,0r0,278r530,0v76,0,114,-58,114,-139","w":1141},"q":{"d":"0,-278v-1,-176,93,-278,267,-278r777,2r0,776r-167,0r0,-223r-610,1v-171,2,-266,-102,-267,-278xm175,-278v0,81,38,139,114,139r588,-1r0,-275r-588,-2v-77,0,-114,58,-114,139","w":1211},"r":{"d":"610,-558v134,0,213,83,197,228r-167,0v4,-51,-8,-86,-58,-86r-415,-1r0,417r-167,0r0,-556","w":950},"s":{"d":"913,-170v0,103,-65,170,-175,170r-738,0r0,-131r705,1v37,0,55,-14,55,-43v0,-28,-18,-42,-55,-42r-530,-1v-102,1,-175,-66,-175,-169v0,-101,66,-171,175,-171r708,0r0,131r-675,0v-37,0,-55,14,-55,42v0,28,18,42,55,42r530,1v102,-1,175,67,175,170","w":1039},"t":{"d":"267,-208v1,58,20,77,78,77r425,0r0,131r-504,0v-116,-3,-166,-47,-166,-167r0,-258r-100,0r0,-131r100,0r0,-222r167,0r0,222r503,0r0,131r-503,0r0,217","w":917},"u":{"d":"198,0v-119,6,-198,-71,-198,-170r0,-386r167,0r0,358v0,39,19,59,58,59r506,0r0,-417r167,0r0,556r-700,0"},"v":{"d":"167,-139r564,0r0,-417r167,0r0,556r-898,0r0,-556r167,0r0,417"},"w":{"d":"197,0v-115,4,-197,-68,-197,-170r0,-386r167,0r0,358v0,39,19,59,58,59r273,0r0,-417r167,0r0,417r326,0r0,-417r167,0r0,556r-961,0","w":1323},"x":{"d":"132,-208r646,0r0,-131r-646,0r0,131xm1,-138v-2,-70,61,-133,131,-131r0,131r-131,0xm0,-138r132,0r0,138r-132,0r0,-138xm1,-396v-2,71,61,133,131,131r0,-131r-131,0xm0,-396r132,0r0,-158r-132,0r0,158xm909,-138v2,-70,-61,-133,-131,-131r0,131r131,0xm910,-138r-132,0r0,138r132,0r0,-138xm909,-396v2,71,-61,133,-131,131r0,-131r131,0xm910,-396r-132,0r0,-158r132,0r0,158xm133,-454v-2,62,53,117,115,115r-115,0r0,-115xm133,-94v-2,-62,53,-117,115,-115r-115,0r0,115xm777,-454v2,62,-53,117,-115,115r115,0r0,-115xm778,-93v2,-62,-54,-117,-115,-115r115,0r0,115","w":1017},"y":{"d":"754,92v53,-1,68,-31,66,-92r-622,0v-119,6,-198,-71,-198,-170r0,-386r167,0r0,336v-1,49,32,82,81,81r572,0r0,-417r167,0r0,576v3,124,-85,207,-204,207r-769,0r0,-135r740,0","w":1169},"z":{"d":"0,-170v0,101,66,170,175,170r738,0r0,-131r-704,1v-37,0,-56,-14,-56,-43v0,-28,19,-42,56,-42r529,-1v102,1,175,-66,175,-169v0,-102,-66,-171,-175,-171r-707,-2r0,131r674,2v37,0,55,14,55,42v0,28,-18,42,-55,42r-530,1v-102,-1,-175,67,-175,170","w":1039},"{":{"d":"0,-466v58,7,98,-17,100,-66v3,-102,-10,-222,10,-308v23,-50,68,-91,143,-91r196,0r0,153r-163,0v-22,0,-33,11,-33,33r0,289v1,35,-29,68,-64,67v36,0,65,30,64,66r0,290v0,22,11,33,33,33r163,0r0,153r-196,0v-87,1,-153,-65,-153,-153r0,-246v-1,-49,-42,-75,-100,-67r0,-153","w":515},"|":{"w":211},"}":{"d":"349,-778v0,-93,-61,-152,-153,-153r-196,0r0,153r163,0v22,0,33,11,33,33r0,289v-1,35,29,68,64,67v-36,0,-65,30,-64,66r0,290v0,22,-11,33,-33,33r-163,0r0,153r196,0v91,0,153,-64,153,-153r0,-246v1,-49,42,-75,100,-67r0,-153v-58,7,-99,-17,-100,-66r0,-246","w":515},"~":{"w":342},"\u0131":{"w":256},"\u00c7":{"w":729},"\u00d6":{"w":1084},"\u00dc":{"w":761},"\u00e7":{"w":578},"\u00f6":{"d":"7,-368v-3,-111,96,-207,207,-207r536,0v112,-3,207,95,207,207r0,162v3,111,-96,207,-207,207r-536,0v-110,3,-207,-97,-207,-207r0,-162xm264,-445v-45,-1,-85,40,-85,85r0,138v-1,45,40,85,85,85r428,0v45,1,85,-40,85,-85r0,-138v1,-45,-40,-85,-85,-85r-428,0xm289,-650r0,-128r379,0r0,128r-379,0","w":1084},"\u00fc":{"d":"198,0v-119,6,-198,-71,-198,-170r0,-386r167,0r0,358v0,39,19,59,58,59r506,0r0,-417r167,0r0,556r-700,0xm284,-650r0,-128r379,0r0,128r-379,0","w":1032},"\u00a0":{"w":668}}});
diff --git a/doc/themes/triqs/static/triqs.css b/doc/themes/triqs/static/triqs.css
new file mode 100644
index 0000000..e183cb2
--- /dev/null
+++ b/doc/themes/triqs/static/triqs.css
@@ -0,0 +1,449 @@
+/*
+ * sphinx13.css
+ * ~~~~~~~~~~~~
+ *
+ * Sphinx stylesheet -- sphinx13 theme.
+ *
+ * :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+@import url("basic.css");
+
+/* -- page layout ----------------------------------------------------------- */
+
+body {
+ font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
+ 'Verdana', sans-serif;
+ font-size: 14px;
+ text-align: center;
+ background-image: url(bodybg.png);
+ color: black;
+ padding: 0;
+ border-right: 1px solid #0a507a;
+ border-left: 1px solid #0a507a;
+
+ margin: 0 auto;
+ min-width: 780px;
+ max-width: 1080px;
+}
+
+
+.red{
+ color: red
+}
+.blue{
+ color: blue
+}
+.green{
+ color: green
+}
+
+.param{
+ color: blue
+}
+
+a.triqs {
+ color: #073958;
+ text-decoration: none;
+}
+
+a.triqs:hover {
+ color: #0a527f;
+ text-decoration: none;
+}
+
+.pageheader {
+ background-color: #dcdcdc;
+ text-align: left;
+ padding: 10px 15px;
+ color: #073958;
+ border: none;
+}
+
+.pageheader ul {
+ float: right;
+ color: #073958;
+ list-style-type: none;
+ padding-left: 0;
+ margin-top: 22px;
+ margin-right: 10px;
+}
+
+.pageheader li {
+ float: left;
+ margin: 0 0 0 10px;
+}
+
+.pageheader li a {
+ padding: 8px 12px;
+ color: #073958;
+ text-shadow: none;
+}
+
+.pageheader li a:hover {
+ background-color: #f9f9f0;
+ color: #0a507a;
+ text-shadow: none;
+}
+
+div.document {
+ background-color: white;
+ text-align: left;
+}
+
+div.bodywrapper {
+ margin: 0 240px 0 0;
+ border-right: 1px solid #0a507a;
+}
+
+div.body {
+ margin: 0;
+ padding: 0.5em 20px 20px 20px;
+}
+
+div.related {
+ font-size: 1em;
+ color: white;
+}
+
+div.related ul {
+ background-image: url(relbg.png);
+ height: 1.9em;
+ border-top: 1px solid #002e50;
+ border-bottom: 1px solid #002e50;
+}
+
+div.related ul li {
+ margin: 0 5px 0 0;
+ padding: 0;
+ float: left;
+}
+
+div.related ul li.right {
+ float: right;
+ margin-right: 5px;
+}
+
+div.related ul li a {
+ margin: 0;
+ padding: 0 5px 0 5px;
+ line-height: 1.75em;
+ color: #f9f9f0;
+ text-shadow: 0px 0px 1px rgba(0, 0, 0, 0.5);
+}
+
+div.related ul li a:hover {
+ color: white;
+ /*text-decoration: underline;*/
+ text-shadow: 0px 0px 1px rgba(255, 255, 255, 0.5);
+}
+
+div.sphinxsidebarwrapper {
+ position: relative;
+ top: 0px;
+ padding: 0;
+}
+
+div.sphinxsidebar {
+ margin: 0;
+ padding: 0 15px 15px 0;
+ width: 210px;
+ float: right;
+ font-size: 1em;
+ text-align: left;
+}
+
+div.sphinxsidebar .logo {
+ font-size: 1.8em;
+ color: #0A507A;
+ font-weight: 300;
+ text-align: center;
+}
+
+div.sphinxsidebar .logo img {
+ vertical-align: middle;
+}
+
+div.sphinxsidebar input {
+ border: 1px solid #aaa;
+ font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
+ 'Verdana', sans-serif;
+ font-size: 1em;
+}
+
+div.sphinxsidebar h3 {
+ font-size: 1.5em;
+ border-top: 1px solid #0a507a;
+ margin-top: 1em;
+ margin-bottom: 0.5em;
+ padding-top: 0.5em;
+}
+
+div.sphinxsidebar h4 {
+ font-size: 1.2em;
+ margin-bottom: 0;
+}
+
+div.sphinxsidebar h3, div.sphinxsidebar h4 {
+ margin-right: -15px;
+ margin-left: -15px;
+ padding-right: 14px;
+ padding-left: 14px;
+ color: #333;
+ font-weight: 300;
+ /*text-shadow: 0px 0px 0.5px rgba(0, 0, 0, 0.4);*/
+}
+
+div.sphinxsidebarwrapper > h3:first-child {
+ margin-top: 0.5em;
+ border: none;
+}
+
+div.sphinxsidebar h3 a {
+ color: #333;
+}
+
+div.sphinxsidebar ul {
+ color: #444;
+ margin-top: 7px;
+ padding: 0;
+ line-height: 130%;
+}
+
+div.sphinxsidebar ul ul {
+ margin-left: 20px;
+ list-style-image: url(listitem.png);
+}
+
+div.footer {
+ background-image: url(footerbg.png);
+ color: #ccc;
+ text-shadow: 0 0 .2px rgba(255, 255, 255, 0.8);
+ padding: 3px 8px 3px 0;
+ clear: both;
+ font-size: 0.8em;
+ text-align: right;
+}
+
+/* no need to make a visible link to Sphinx on the Sphinx page */
+div.footer a {
+ color: #ccc;
+}
+
+/* -- body styles ----------------------------------------------------------- */
+
+p {
+ margin: 0.8em 0 0.5em 0;
+}
+
+a {
+ color: #A2881D;
+ text-decoration: none;
+}
+
+a:hover {
+ color: #E1C13F;
+}
+
+div.body a {
+ text-decoration: underline;
+}
+
+h1 {
+ margin: 10px 0 0 0;
+ font-size: 2.4em;
+ color: #0A507A;
+ font-weight: 300;
+}
+
+h2 {
+ margin: 1.em 0 0.2em 0;
+ font-size: 1.5em;
+ font-weight: 300;
+ padding: 0;
+ color: #174967;
+}
+
+h3 {
+ margin: 1em 0 -0.3em 0;
+ font-size: 1.3em;
+ font-weight: 300;
+}
+
+div.body h1 a, div.body h2 a, div.body h3 a, div.body h4 a, div.body h5 a, div.body h6 a {
+ text-decoration: none;
+}
+
+div.body h1 a tt, div.body h2 a tt, div.body h3 a tt, div.body h4 a tt, div.body h5 a tt, div.body h6 a tt {
+ color: #0A507A !important;
+ font-size: inherit !important;
+}
+
+a.headerlink {
+ color: #0A507A !important;
+ font-size: 12px;
+ margin-left: 6px;
+ padding: 0 4px 0 4px;
+ text-decoration: none !important;
+ float: right;
+}
+
+a.headerlink:hover {
+ background-color: #ccc;
+ color: white!important;
+}
+
+cite, code, tt {
+ font-family: 'Consolas', 'DejaVu Sans Mono',
+ 'Bitstream Vera Sans Mono', monospace;
+ font-size: 14px;
+ letter-spacing: -0.02em;
+}
+
+tt {
+ background-color: #f2f2f2;
+ border: 1px solid #ddd;
+ border-radius: 2px;
+ color: #333;
+ padding: 1px;
+}
+
+tt.descname, tt.descclassname, tt.xref {
+ border: 0;
+}
+
+hr {
+ border: 1px solid #abc;
+ margin: 2em;
+}
+
+a tt {
+ border: 0;
+ color: #a2881d;
+}
+
+a tt:hover {
+ color: #e1c13f;
+}
+
+pre {
+ font-family: 'Consolas', 'DejaVu Sans Mono',
+ 'Bitstream Vera Sans Mono', monospace;
+ font-size: 13px;
+ letter-spacing: 0.015em;
+ line-height: 120%;
+ padding: 0.5em;
+ border: 1px solid #ccc;
+ border-radius: 2px;
+ background-color: #f8f8f8;
+}
+
+pre a {
+ color: inherit;
+ text-decoration: underline;
+}
+
+td.linenos pre {
+ padding: 0.5em 0;
+}
+
+div.quotebar {
+ background-color: #f8f8f8;
+ max-width: 250px;
+ float: right;
+ padding: 0px 7px;
+ border: 1px solid #ccc;
+ margin-left: 1em;
+}
+
+div.topic {
+ background-color: #f8f8f8;
+}
+
+table {
+ border-collapse: collapse;
+ margin: 0 -0.5em 0 -0.5em;
+}
+
+table td, table th {
+ padding: 0.2em 0.5em 0.2em 0.5em;
+}
+
+div.admonition, div.warning {
+ font-size: 0.9em;
+ margin: 1em 0 1em 0;
+ border: 1px solid #86989B;
+ border-radius: 2px;
+ background-color: #f7f7f7;
+ padding: 0;
+}
+
+div.admonition p, div.warning p {
+ margin: 0.5em 1em 0.5em 1em;
+ padding: 0;
+}
+
+div.admonition pre, div.warning pre {
+ margin: 0.4em 1em 0.4em 1em;
+}
+
+div.admonition p.admonition-title,
+div.warning p.admonition-title {
+ margin-top: 1em;
+ padding-top: 0.5em;
+ font-weight: bold;
+}
+
+div.warning {
+ border: 1px solid #940000;
+/* background-color: #FFCCCF;*/
+}
+
+div.warning p.admonition-title {
+}
+
+div.admonition ul, div.admonition ol,
+div.warning ul, div.warning ol {
+ margin: 0.1em 0.5em 0.5em 3em;
+ padding: 0;
+}
+
+div.admonition .highlight, div.warning .highlight {
+ background-color: #f7f7f7;
+}
+
+.viewcode-back {
+ font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva',
+ 'Verdana', sans-serif;
+}
+
+div.viewcode-block:target {
+ background-color: #f4debf;
+ border-top: 1px solid #ac9;
+ border-bottom: 1px solid #ac9;
+}
+
+
+.my-code-block.std-ref {
+ color : red;
+}
+
+.cppbrief {
+ color: #C6792C;
+ font-style: oblique;
+}
+
+.cppsynopsis {
+ background-color: #E7EDF9;
+ /*font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva', 'Verdana', sans-serif;*/
+ /*font-family: monospace; */
+ font-family: Verdana, Arial, Lucida Console;
+ font-size=80%;
+ /*font-style: oblique;*/
+ /* white-space: pre;*/
+}
+
+
+
diff --git a/doc/themes/triqs/theme.conf b/doc/themes/triqs/theme.conf
new file mode 100644
index 0000000..96ca439
--- /dev/null
+++ b/doc/themes/triqs/theme.conf
@@ -0,0 +1,4 @@
+[theme]
+inherit = basic
+stylesheet = triqs.css
+pygments_style = sphinx
diff --git a/packaging/CMakeLists.txt b/packaging/CMakeLists.txt
new file mode 100644
index 0000000..748dc4a
--- /dev/null
+++ b/packaging/CMakeLists.txt
@@ -0,0 +1,7 @@
+# Configure the version of packaging files
+configure_file(conda/meta.yaml.in conda/meta.yaml)
+configure_file(conda/build.sh conda/build.sh COPYONLY)
+configure_file(conda/conda_build_config.yaml conda/conda_build_config.yaml COPYONLY)
+configure_file(TRIQS-app4triqs-foss-2021b.eb.in TRIQS-app4triqs-foss-2021b.eb)
+
+
diff --git a/packaging/TRIQS-app4triqs-foss-2021b.eb.in b/packaging/TRIQS-app4triqs-foss-2021b.eb.in
new file mode 100644
index 0000000..384c781
--- /dev/null
+++ b/packaging/TRIQS-app4triqs-foss-2021b.eb.in
@@ -0,0 +1,60 @@
+easyblock = 'CMakeMake'
+
+name = 'TRIQS-app4triqs'
+version = '@PROJECT_VERSION@'
+
+homepage = 'https://triqs.github.io/app4triqs/'
+description = """
+ PROVIDE HERE A DESCRIPTION OF YOUR APPLICATION
+"""
+
+docurls = ['https://triqs.github.io/app4triqs/%(version_major_minor)s.x/']
+software_license = 'LicenseGPLv3'
+
+toolchain = {'name': 'foss', 'version': '2021b'}
+toolchainopts = {'pic': True, 'usempi': True}
+
+source_urls = ['https://github.com/TRIQS/app4triqs/releases/download/%(version)s/']
+sources = ['app4triqs-%(version)s.tar.gz']
+checksums = ['PUT HERE THE SHA256 OF THE RELEASE TARBALL']
+
+dependencies = [
+ ('Python', '3.9.6'),
+ ('SciPy-bundle', '2021.10'),
+ ('Boost', '1.77.0'),
+ ('Clang', '13.0.1'),
+ ('Clang-Python-bindings', '13.0.1'),
+ ('GMP', '6.2.1'),
+ ('HDF5', '1.10.7'),
+ ('Mako', '1.1.4'),
+ ('TRIQS', '3.3.0'),
+ ('NFFT', '3.5.2')
+]
+
+builddependencies = [
+ ('CMake', '3.22.1')
+]
+
+separate_build_dir = True
+
+runtest = 'test'
+
+sanity_check_paths = {
+ 'files': ['lib/libapp4triqs_c.a'],
+ 'dirs': ['include/app4triqs', 'lib', 'share',
+ 'lib/python%(pyshortver)s/site-packages/app4triqs'],
+}
+
+sanity_check_commands = ["python -c 'import app4triqs'"]
+
+modextrapaths = {
+ 'CPLUS_INCLUDE_PATH': 'include',
+ 'PYTHONPATH': 'lib/python%(pyshortver)s/site-packages',
+ 'CMAKE_PREFIX_PATH': 'lib/cmake/app4triqs',
+}
+modextravars = {
+ 'APP4TRIQS_ROOT': '%(installdir)s',
+ 'APP4TRIQS_VERSION': '%(version)s',
+}
+
+moduleclass = 'phys'
diff --git a/packaging/conda/build.sh b/packaging/conda/build.sh
new file mode 100644
index 0000000..740a84d
--- /dev/null
+++ b/packaging/conda/build.sh
@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+mkdir build
+cd build
+
+# Openmpi Specific environment setup - Cf. https://github.com/conda-forge/libnetcdf-feedstock/pull/80
+export OMPI_MCA_btl=self,tcp
+export OMPI_MCA_plm=isolated
+export OMPI_MCA_rmaps_base_oversubscribe=yes
+export OMPI_MCA_btl_vader_single_copy_mechanism=none
+mpiexec="mpiexec --allow-run-as-root"
+
+source $PREFIX/share/triqs/triqsvars.sh
+
+cmake \
+ -DCMAKE_INSTALL_PREFIX=$PREFIX \
+ -DCMAKE_BUILD_TYPE=Release \
+ ..
+
+make -j${CPU_COUNT} VERBOSE=1
+CTEST_OUTPUT_ON_FAILURE=1 ctest
+make install
diff --git a/packaging/conda/conda_build_config.yaml b/packaging/conda/conda_build_config.yaml
new file mode 100644
index 0000000..289631f
--- /dev/null
+++ b/packaging/conda/conda_build_config.yaml
@@ -0,0 +1,3 @@
+mpi:
+ - mpich
+ - openmpi
diff --git a/packaging/conda/meta.yaml.in b/packaging/conda/meta.yaml.in
new file mode 100644
index 0000000..bad6e1c
--- /dev/null
+++ b/packaging/conda/meta.yaml.in
@@ -0,0 +1,57 @@
+{% set version = "@PROJECT_VERSION@" %}
+
+package:
+ name: app4triqs
+ version: {{ version }}
+
+source:
+ url: https://github.com/TRIQS/app4triqs/releases/download/{{ version }}/app4triqs-{{ version }}.tar.gz
+ sha256: PUT HERE THE SHA256 OF YOUR RELEASE TARBALL
+
+build:
+ number: 0
+ skip: True # [win or py<30]
+
+requirements:
+ build:
+ - cmake
+ - make
+ - {{ compiler('c') }}
+ - {{ compiler('cxx') }}
+ host:
+ - triqs {{ '.'.join(version.split('.')[:2]) }}
+ - boost-cpp
+ - hdf5
+ - {{ mpi }}
+ - libblas
+ - liblapack
+ - python
+ run:
+ - {{ pin_compatible("triqs", max_pin="x.x") }}
+ - boost-cpp
+ - hdf5
+ - {{ mpi }}
+ - libblas
+ - liblapack
+ - python
+
+test:
+ commands:
+ - export OMPI_MCA_btl=self,tcp
+ - export OMPI_MCA_plm=isolated
+ - export OMPI_MCA_rmaps_base_oversubscribe=yes
+ - export OMPI_MCA_btl_vader_single_copy_mechanism=none
+ - export mpiexec="mpiexec --allow-run-as-root"
+ - python -c "import app4triqs"
+
+about:
+ home: https://triqs.github.io/app4triqs
+ license: GPL-3.0-or-later
+ license_family: GPL
+ license_file: LICENSE.txt
+ summary: 'An application based on the TRIQS library'
+
+extra:
+ recipe-maintainers:
+ - wentzell
+ - pgunn
diff --git a/python/app4triqs/CMakeLists.txt b/python/app4triqs/CMakeLists.txt
new file mode 100644
index 0000000..753f314
--- /dev/null
+++ b/python/app4triqs/CMakeLists.txt
@@ -0,0 +1,26 @@
+# Configure the version
+configure_file(version.py.in version.py)
+
+# All Python files. Copy them in the build dir to have a complete package for the tests.
+file(GLOB_RECURSE python_sources RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.py)
+file(GLOB_RECURSE wrap_generators RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *_desc.py)
+list(REMOVE_ITEM python_sources "${wrap_generators}")
+foreach(file ${python_sources})
+ configure_file(${file} ${file} COPYONLY)
+endforeach()
+
+# Install python files to proper location
+set(PYTHON_LIB_DEST ${TRIQS_PYTHON_LIB_DEST_ROOT}/${PROJECT_NAME})
+install(FILES ${CMAKE_CURRENT_BINARY_DIR}/version.py DESTINATION ${PYTHON_LIB_DEST})
+install(DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} DESTINATION ${TRIQS_PYTHON_LIB_DEST_ROOT} FILES_MATCHING PATTERN "*.py" PATTERN "*_desc.py" EXCLUDE)
+
+# Build and install any python modules
+foreach(gen ${wrap_generators})
+ string(REPLACE "_desc.py" "" gen ${gen})
+ get_filename_component(module_name ${gen} NAME_WE)
+ get_filename_component(module_dir ${gen} DIRECTORY)
+ add_cpp2py_module(NAME ${module_name} DIRECTORY ${module_dir})
+ add_library(${PROJECT_NAME}::${module_name} ALIAS ${module_name})
+ target_link_libraries(${module_name} ${PROJECT_NAME}_c triqs_py)
+ install(TARGETS ${module_name} DESTINATION ${PYTHON_LIB_DEST}/${module_dir})
+endforeach()
diff --git a/python/app4triqs/__init__.py b/python/app4triqs/__init__.py
new file mode 100644
index 0000000..1d6bdf5
--- /dev/null
+++ b/python/app4triqs/__init__.py
@@ -0,0 +1,30 @@
+################################################################################
+#
+# TRIQS: a Toolbox for Research in Interacting Quantum Systems
+#
+# Copyright (C) 2016-2018, N. Wentzell
+# Copyright (C) 2018-2019, The Simons Foundation
+# author: N. Wentzell
+#
+# TRIQS is free software: you can redistribute it and/or modify it under the
+# terms of the GNU General Public License as published by the Free Software
+# Foundation, either version 3 of the License, or (at your option) any later
+# version.
+#
+# TRIQS is distributed in the hope that it will be useful, but WITHOUT ANY
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+# details.
+#
+# You should have received a copy of the GNU General Public License along with
+# TRIQS. If not, see
+
+using namespace app4triqs;
+""")
+
+
+# The class toto
+c = class_(
+ py_type = "Toto", # name of the python class
+ c_type = "app4triqs::toto", # name of the C++ class
+ doc = r"""A very useful and important class""", # doc of the C++ class
+ hdf5 = True,
+ arithmetic = ("add_only"),
+ comparisons = "==",
+ serializable = "tuple"
+)
+
+c.add_constructor("""()""", doc = r"""""")
+
+c.add_constructor("""(int i_)""", doc = r"""Construct from integer
+
+Parameters
+----------
+i_
+ a scalar :math:`G(\tau)`""")
+
+c.add_method("""int f (int u)""",
+ doc = r"""A simple function with :math:`G(\tau)`
+
+Parameters
+----------
+u
+ Nothing useful""")
+
+c.add_method("""std::string hdf5_format ()""",
+ is_static = True,
+ doc = r"""HDF5""")
+
+c.add_property(name = "i",
+ getter = cfunction("int get_i ()"),
+ doc = r"""Simple accessor""")
+
+module.add_class(c)
+
+module.add_function ("int app4triqs::chain (int i, int j)", doc = r"""Chain digits of two integers
+
+Parameters
+----------
+i
+ The first integer
+
+j
+ The second integer
+
+Returns
+-------
+out
+ An integer containing the digits of both i and j""")
+
+
+
+module.generate_code()
diff --git a/python/app4triqs/version.py.in b/python/app4triqs/version.py.in
new file mode 100644
index 0000000..2d63daf
--- /dev/null
+++ b/python/app4triqs/version.py.in
@@ -0,0 +1,32 @@
+################################################################################
+#
+# TRIQS: a Toolbox for Research in Interacting Quantum Systems
+#
+# Copyright (C) 2016-2018, N. Wentzell
+# Copyright (C) 2018-2019, Simons Foundation
+# author: N. Wentzell
+#
+# TRIQS is free software: you can redistribute it and/or modify it under the
+# terms of the GNU General Public License as published by the Free Software
+# Foundation, either version 3 of the License, or (at your option) any later
+# version.
+#
+# TRIQS is distributed in the hope that it will be useful, but WITHOUT ANY
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+# details.
+#
+# You should have received a copy of the GNU General Public License along with
+# TRIQS. If not, see " "\\1" ${target}_LDFLAGS "${${target}_LDFLAGS}")
+ string(REGEX REPLACE "\\$" "\\1" ${target}_CXXFLAGS "${${target}_CXXFLAGS}")
+ else()
+ string(REGEX REPLACE "\\$" "\\1" ${target}_LDFLAGS "${${target}_LDFLAGS}")
+ string(REGEX REPLACE "\\$" "\\1" ${target}_CXXFLAGS "${${target}_CXXFLAGS}")
+ endif()
+
+ if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU")
+ string(REGEX REPLACE "\\$<\\$:([^ ]*)>" "\\1" ${target}_LDFLAGS "${${target}_LDFLAGS}")
+ string(REGEX REPLACE "\\$<\\$:([^ ]*)>" "\\1" ${target}_CXXFLAGS "${${target}_CXXFLAGS}")
+ elseif(CMAKE_CXX_COMPILER_ID STREQUAL "Clang")
+ string(REGEX REPLACE "\\$<\\$:([^ ]*)>" "\\1" ${target}_LDFLAGS "${${target}_LDFLAGS}")
+ string(REGEX REPLACE "\\$<\\$:([^ ]*)>" "\\1" ${target}_CXXFLAGS "${${target}_CXXFLAGS}")
+ elseif(CMAKE_CXX_COMPILER_ID STREQUAL "AppleClang")
+ string(REGEX REPLACE "\\$<\\$:([^ ]*)>" "\\1" ${target}_LDFLAGS "${${target}_LDFLAGS}")
+ string(REGEX REPLACE "\\$<\\$:([^ ]*)>" "\\1" ${target}_CXXFLAGS "${${target}_CXXFLAGS}")
+ endif()
+
+ # Remove all remaining generator expressions
+ string(REGEX REPLACE " [^ ]*\\$<[^ ]*:[^>]*>" "" ${target}_LDFLAGS "${${target}_LDFLAGS}")
+ string(REGEX REPLACE " [^ ]*\\$<[^ ]*:[^>]*>" "" ${target}_CXXFLAGS "${${target}_CXXFLAGS}")
+
+ # Filter out system directories from LDFLAGS and CXXFLAGS
+ string(REGEX REPLACE " -L/usr/lib " " " ${target}_LDFLAGS "${${target}_LDFLAGS}")
+ string(REGEX REPLACE " -I/usr/include " " " ${target}_CXXFLAGS "${${target}_CXXFLAGS}")
+ string(REGEX REPLACE " -isystem/usr/include " " " ${target}_CXXFLAGS "${${target}_CXXFLAGS}")
+
+endmacro()
diff --git a/share/replace_and_rename.py b/share/replace_and_rename.py
new file mode 100755
index 0000000..a773d19
--- /dev/null
+++ b/share/replace_and_rename.py
@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+
+import sys
+import os
+import glob
+
+if len(sys.argv) != 2:
+ print("Please pass the application name")
+ sys.exit()
+
+app_name = str(sys.argv[1]).lower()
+capital_name = app_name.upper()
+
+# Move app4triqs directories if necessary
+if os.path.isdir("c++/app4triqs"): os.rename("c++/app4triqs", "c++/" + app_name)
+if os.path.isdir("python/app4triqs"): os.rename("python/app4triqs", "python/" + app_name)
+
+# Ignore these files
+ignore_lst = [".git/", "replace_and_rename.py", "squash_history.sh"]
+
+# Find the root directory of app4triqs
+app4triqs_root = os.path.abspath(os.path.dirname(__file__) + "/..")
+
+# Blacklisted file-formats
+fmt_blacklist = ['.png', '.h5', '.jpg', '.ico']
+
+# Recurse over all subdirectories and files
+for root, dirs, files in os.walk(app4triqs_root):
+
+ for fname in files:
+ fpath = os.path.join(root, fname)
+
+ if os.path.splitext(fname)[1] in fmt_blacklist:
+ continue
+
+ # Ignore certain files / directories
+ if any(it in fpath for it in ignore_lst): continue
+
+ if os.path.isfile(fpath):
+ # Rename files containing app4triqs in their filename
+ if "app4triqs" in fname:
+ new_fpath = os.path.join(root, fname.replace("app4triqs", app_name))
+ os.rename(fpath, new_fpath)
+ fpath = new_fpath
+
+ # Replace app4triqs and APP4TRIQS in all files
+ with open(fpath, 'r') as f:
+ s = f.read()
+ if "app4triqs" in s or "APP4TRIQS" in s:
+ with open(fpath, 'w') as f:
+ f.write(s.replace("app4triqs", app_name).replace("APP4TRIQS", capital_name))
diff --git a/share/squash_history.sh b/share/squash_history.sh
new file mode 100755
index 0000000..8c03c08
--- /dev/null
+++ b/share/squash_history.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+
+git reset $(git commit-tree HEAD\^{tree} -m "Initialize project from github.com/triqs/app4triqs@$(git rev-parse --short HEAD)")
+git merge --allow-unrelated-histories -s ours HEAD@{1} -m "Track app4triqs skeleton"
+git remote rm origin
+git remote add app4triqs_remote https://github.com/triqs/app4triqs
diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt
new file mode 100644
index 0000000..e79313f
--- /dev/null
+++ b/test/CMakeLists.txt
@@ -0,0 +1,5 @@
+add_subdirectory(c++)
+
+if(PythonSupport)
+ add_subdirectory(python)
+endif()
diff --git a/test/c++/CMakeLists.txt b/test/c++/CMakeLists.txt
new file mode 100644
index 0000000..14ac6ae
--- /dev/null
+++ b/test/c++/CMakeLists.txt
@@ -0,0 +1,35 @@
+# Copy h5 files to binary dir
+file(GLOB_RECURSE all_h5_ref_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.ref.h5)
+foreach(file ${all_h5_ref_files})
+ configure_file(${file} ${file} COPYONLY)
+endforeach()
+
+# List of all tests
+file(GLOB_RECURSE all_tests RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.cpp)
+
+foreach(test ${all_tests})
+ get_filename_component(test_name ${test} NAME_WE)
+ get_filename_component(test_dir ${test} DIRECTORY)
+ add_executable(${test_name} ${test})
+ target_link_libraries(${test_name} ${PROJECT_NAME}::${PROJECT_NAME}_c ${PROJECT_NAME}_warnings gtest_main)
+ set_property(TARGET ${test_name} PROPERTY RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/${test_dir})
+ add_test(NAME ${test_name} COMMAND ${test_name} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/${test_dir})
+ # Run clang-tidy if found
+ if(CLANG_TIDY_EXECUTABLE)
+ set_target_properties(${test_name} PROPERTIES CXX_CLANG_TIDY "${CLANG_TIDY_EXECUTABLE}")
+ endif()
+ # Run cppcheck if found
+ if(CPPCHECK_EXECUTABLE)
+ add_custom_command(
+ TARGET ${test_name}
+ COMMAND ${CPPCHECK_EXECUTABLE}
+ --enable=warning,style,performance,portability
+ --std=c++20
+ --template=gcc
+ --verbose
+ --force
+ --quiet
+ ${CMAKE_CURRENT_SOURCE_DIR}/${test}
+ )
+ endif()
+endforeach()
diff --git a/test/c++/basic.cpp b/test/c++/basic.cpp
new file mode 100644
index 0000000..aecf689
--- /dev/null
+++ b/test/c++/basic.cpp
@@ -0,0 +1,30 @@
+#include
+#include
+
+using namespace app4triqs;
+
+TEST(Toto, Add) { // NOLINT
+
+ toto a(0);
+ toto b(2);
+
+ auto c = a + b;
+ EXPECT_EQ(c, b); // NOLINT
+}
+
+TEST(Toto, H5) { // NOLINT
+
+ toto a(0);
+ { // Local scope for file
+ h5::file f("f.h5", 'w');
+ h5_write(f, "a", a);
+ }
+
+ toto a2;
+ {
+ h5::file f("f.h5", 'a');
+ h5_read(f, "a", a2);
+ }
+
+ EXPECT_EQ(a, a2); // NOLINT
+}
diff --git a/test/python/Basic.py b/test/python/Basic.py
new file mode 100644
index 0000000..c0472fc
--- /dev/null
+++ b/test/python/Basic.py
@@ -0,0 +1,50 @@
+#!/usr/bin/env python
+
+import unittest
+
+from app4triqs import Toto, chain
+from h5 import *
+from triqs.utility import mpi
+
+class test_toto(unittest.TestCase):
+
+ def test_add(self):
+
+ a=Toto(0)
+ b=Toto(2)
+
+ c=a+b
+ self.assertEqual(c, b)
+
+
+ def test_h5(self):
+
+ a=Toto(0)
+ with HDFArchive("f.h5",'w') as A:
+ A["a"] = a
+ with HDFArchive("f.h5",'r') as A:
+ a_read = A["a"]
+ self.assertEqual(a, a_read)
+
+
+ def test_mpi(self):
+
+ a=Toto(0)
+
+ if mpi.is_master_node():
+ a=Toto(1)
+ mpi.bcast(a)
+
+ self.assertEqual(a, Toto(1))
+
+class test_chain(unittest.TestCase):
+
+ def test_chain(self):
+
+ i = 111
+ j = 222
+ ij = chain(i,j)
+ self.assertEqual(ij, 111222)
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/test/python/CMakeLists.txt b/test/python/CMakeLists.txt
new file mode 100644
index 0000000..aa9d877
--- /dev/null
+++ b/test/python/CMakeLists.txt
@@ -0,0 +1,15 @@
+# Copy h5 files to binary dir
+file(GLOB_RECURSE all_h5_ref_files RELATIVE ${CMAKE_CURRENT_SOURCE_DIR} *.ref.h5)
+foreach(file ${all_h5_ref_files})
+ configure_file(${file} ${file} COPYONLY)
+endforeach()
+
+# List of all tests
+set(all_tests Basic)
+
+foreach(test ${all_tests})
+ get_filename_component(test_name ${test} NAME_WE)
+ get_filename_component(test_dir ${test} DIRECTORY)
+ add_test(NAME Py_${test_name} COMMAND ${TRIQS_PYTHON_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/${test_dir}/${test_name}.py WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/${test_dir})
+ set_property(TEST Py_${test_name} APPEND PROPERTY ENVIRONMENT PYTHONPATH=${PROJECT_BINARY_DIR}/python:$ENV{PYTHONPATH} ${SANITIZER_RT_PRELOAD})
+endforeach()
+
+
+
+
+
+
+
+
+
+
+
+
+
+{% endblock %}
diff --git a/doc/themes/triqs/static/bodybg.png b/doc/themes/triqs/static/bodybg.png
new file mode 100644
index 0000000..506b6f9
Binary files /dev/null and b/doc/themes/triqs/static/bodybg.png differ
diff --git a/doc/themes/triqs/static/cufon-yui.js b/doc/themes/triqs/static/cufon-yui.js
new file mode 100644
index 0000000..935614e
--- /dev/null
+++ b/doc/themes/triqs/static/cufon-yui.js
@@ -0,0 +1,7 @@
+/*
+ * Copyright (c) 2009 Simo Kinnunen.
+ * Licensed under the MIT license.
+ *
+ * @version 1.09i
+ */
+var Cufon=(function(){var m=function(){return m.replace.apply(null,arguments)};var x=m.DOM={ready:(function(){var C=false,E={loaded:1,complete:1};var B=[],D=function(){if(C){return}C=true;for(var F;F=B.shift();F()){}};if(document.addEventListener){document.addEventListener("DOMContentLoaded",D,false);window.addEventListener("pageshow",D,false)}if(!window.opera&&document.readyState){(function(){E[document.readyState]?D():setTimeout(arguments.callee,10)})()}if(document.readyState&&document.createStyleSheet){(function(){try{document.body.doScroll("left");D()}catch(F){setTimeout(arguments.callee,1)}})()}q(window,"load",D);return function(F){if(!arguments.length){D()}else{C?F():B.push(F)}}})(),root:function(){return document.documentElement||document.body}};var n=m.CSS={Size:function(C,B){this.value=parseFloat(C);this.unit=String(C).match(/[a-z%]*$/)[0]||"px";this.convert=function(D){return D/B*this.value};this.convertFrom=function(D){return D/this.value*B};this.toString=function(){return this.value+this.unit}},addClass:function(C,B){var D=C.className;C.className=D+(D&&" ")+B;return C},color:j(function(C){var B={};B.color=C.replace(/^rgba\((.*?),\s*([\d.]+)\)/,function(E,D,F){B.opacity=parseFloat(F);return"rgb("+D+")"});return B}),fontStretch:j(function(B){if(typeof B=="number"){return B}if(/%$/.test(B)){return parseFloat(B)/100}return{"ultra-condensed":0.5,"extra-condensed":0.625,condensed:0.75,"semi-condensed":0.875,"semi-expanded":1.125,expanded:1.25,"extra-expanded":1.5,"ultra-expanded":2}[B]||1}),getStyle:function(C){var B=document.defaultView;if(B&&B.getComputedStyle){return new a(B.getComputedStyle(C,null))}if(C.currentStyle){return new a(C.currentStyle)}return new a(C.style)},gradient:j(function(F){var G={id:F,type:F.match(/^-([a-z]+)-gradient\(/)[1],stops:[]},C=F.substr(F.indexOf("(")).match(/([\d.]+=)?(#[a-f0-9]+|[a-z]+\(.*?\)|[a-z]+)/ig);for(var E=0,B=C.length,D;E-
+ {% for header_link in header_links %}
+
- {{ header_link[0] }} + {% endfor %} +
+
+