From 9fde54922e3f0cf8cab6cb4278694b189fda62d4 Mon Sep 17 00:00:00 2001 From: Anthony Scemama Date: Thu, 22 Oct 2020 01:24:14 +0200 Subject: [PATCH] Added make doc --- src/.gitignore | 1 + src/Makefile | 5 +- src/README.org | 285 +++++++++++++++++++++-------------------- src/create_doc.sh | 22 ++++ src/qmckl.org | 7 + src/qmckl_context.org | 12 +- src/qmckl_distance.org | 55 ++++---- src/qmckl_memory.org | 92 +++++++------ src/test_qmckl.org | 7 + 9 files changed, 278 insertions(+), 208 deletions(-) create mode 100755 src/create_doc.sh diff --git a/src/.gitignore b/src/.gitignore index 1ce56e6..90eb50e 100644 --- a/src/.gitignore +++ b/src/.gitignore @@ -2,6 +2,7 @@ *.c *.f90 *.h +*.html *~ *.so Makefile.generated diff --git a/src/Makefile b/src/Makefile index 8aa37d5..d5b363d 100644 --- a/src/Makefile +++ b/src/Makefile @@ -21,8 +21,11 @@ libqmckl.so: Makefile.generated test: Makefile.generated $(MAKE) -f Makefile.generated test +doc:$(ORG_SOURCE_FILES) + ./create_doc.sh $(ORG_SOURCE_FILES) + clean: - rm -f qmckl.h test_qmckl_* qmckl_*.f90 qmckl_*.c qmckl_*.o qmckl_*.h Makefile.generated libqmckl.so + rm -f qmckl.h test_qmckl_* qmckl_*.f90 qmckl_*.c qmckl_*.o qmckl_*.h Makefile.generated libqmckl.so Makefile.generated: $(ORG_SOURCE_FILES) Makefile create_makefile.sh ./create_makefile.sh $(ORG_SOURCE_FILES) diff --git a/src/README.org b/src/README.org index a0f7028..5b2ade4 100644 --- a/src/README.org +++ b/src/README.org @@ -1,53 +1,60 @@ -* QMCkl source code +#+TITLE: QMCkl source code documentation -** Introduction +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: - The ultimate goal of QMCkl is to provide a high-performance - implementation of the main kernels of QMC. In this particular - repository, we focus on the definition of the API and the tests, - and on a /pedagogical/ presentation of the algorithms. We expect the - HPC experts to use this repository as a reference for re-writing - optimized libraries. +* Introduction - Literate programming is particularly adapted in this context. - Source files are written in [[ottps://karl-voit.at/2017/09/23/orgmode-as-markup-only/][org-mode]] format, to provide useful - comments and LaTex formulas close to the code. There exists multiple - possibilities to convert org-mode files into different formats such as - HTML or pdf. - For a tutorial on literate programming with org-mode, follow - [[http://www.howardism.org/Technical/Emacs/literate-programming-tutorial.html][this link]]. + The ultimate goal of QMCkl is to provide a high-performance + implementation of the main kernels of QMC. In this particular + repository, we focus on the definition of the API and the tests, + and on a /pedagogical/ presentation of the algorithms. We expect the + HPC experts to use this repository as a reference for re-writing + optimized libraries. - The code is extracted from the org files using Emacs as a command-line - tool in the =Makefile=, and then the produced files are compiled. + Literate programming is particularly adapted in this context. + Source files are written in [[https://karl-voit.at/2017/09/23/orgmode-as-markup-only/][org-mode]] format, to provide useful + comments and LaTex formulas close to the code. There exists multiple + possibilities to convert org-mode files into different formats such as + HTML or pdf. + For a tutorial on literate programming with org-mode, follow + [[http://www.howardism.org/Technical/Emacs/literate-programming-tutorial.html][this link]]. -*** Language used + The code is extracted from the org files using Emacs as a command-line + tool in the =Makefile=, and then the produced files are compiled. - Fortran is one of the most common languages used by the community, - and is simple enough to make the algorithms readable. Hence we - propose in this pedagogical implementation of QMCkl to use Fortran - to express the algorithms. For specific internal functions where - the C language is more natural, C is used. +** Language used - As Fortran modules generate compiler-dependent files, the use of - modules is restricted to the internal use of the library, otherwise - the compliance with C is violated. + Fortran is one of the most common languages used by the community, + and is simple enough to make the algorithms readable. Hence we + propose in this pedagogical implementation of QMCkl to use Fortran + to express the algorithms. For specific internal functions where + the C language is more natural, C is used. - The external dependencies should be kept as small as possible, so - external libraries should be used /only/ if their used is strongly - justified. + As Fortran modules generate compiler-dependent files, the use of + modules is restricted to the internal use of the library, otherwise + the compliance with C is violated. -*** Source code editing + The external dependencies should be kept as small as possible, so + external libraries should be used /only/ if their used is strongly + justified. - Any text editor can be used to edit org-mode files. For a better - user experience Emacs is recommended. - For users hating Emacs, it is good to know that Emacs can behave - like Vim when switched into ``Evil'' mode. There also exists - [[https://www.spacemacs.org][Spacemacs]] which helps the transition for Vim users. +** Source code editing - For users with a preference for Jupyter notebooks, the following - script can convert jupyter notebooks to org-mode files: + Any text editor can be used to edit org-mode files. For a better + user experience Emacs is recommended. + For users hating Emacs, it is good to know that Emacs can behave + like Vim when switched into ``Evil'' mode. There also exists + [[https://www.spacemacs.org][Spacemacs]] which helps the transition for Vim users. - #+BEGIN_SRC sh tangle: nb_to_org.sh + For users with a preference for Jupyter notebooks, the following + script can convert jupyter notebooks to org-mode files: + + #+BEGIN_SRC sh tangle: nb_to_org.sh #!/bin/bash # $ nb_to_org.sh notebook.ipynb # produces the org-mode file notebook.org @@ -58,143 +65,143 @@ nb=$(basename $1 .ipynb) jupyter nbconvert --to markdown ${nb}.ipynb --output ${nb}.md pandoc ${nb}.md -o ${nb}.org rm ${nb}.md - #+END_SRC + #+END_SRC - And pandoc can convert multiple markdown formats into org-mode. + And pandoc can convert multiple markdown formats into org-mode. -*** Writing in Fortran +** Writing in Fortran - The Fortran source files should provide a C interface using - iso-c-binding. The name of the Fortran source files should end - with =_f.f90= to be properly handled by the Makefile. + The Fortran source files should provide a C interface using + iso-c-binding. The name of the Fortran source files should end + with =_f.f90= to be properly handled by the Makefile. -*** Coding style - # TODO: decide on a coding style +** Coding style + # TODO: decide on a coding style - To improve readability, we maintain a consistent coding style in the library. + To improve readability, we maintain a consistent coding style in the library. - - For C source files, we will use __(decide on a coding style)__ - - For Fortran source files, we will use __(decide on a coding style)__ + - For C source files, we will use __(decide on a coding style)__ + - For Fortran source files, we will use __(decide on a coding style)__ - Coding style can be automatically checked with [[https://clang.llvm.org/docs/ClangFormat.html][clang-format]]. + Coding style can be automatically checked with [[https://clang.llvm.org/docs/ClangFormat.html][clang-format]]. -** Design of the library +* Design of the library - The proposed API should allow the library to: - - deal with memory transfers between CPU and accelerators - - use different levels of floating-point precision + The proposed API should allow the library to: + - deal with memory transfers between CPU and accelerators + - use different levels of floating-point precision - We chose a multi-layered design with low-level and high-level - functions (see below). + We chose a multi-layered design with low-level and high-level + functions (see below). -*** Naming conventions +** Naming conventions - Use =qmckl_= as a prefix for all exported functions and variables. - All exported header files should have a filename with the prefix - =qmckl_=. + Use =qmckl_= as a prefix for all exported functions and variables. + All exported header files should have a filename with the prefix + =qmckl_=. - If the name of the org-mode file is =xxx.org=, the name of the - produced C files should be =xxx.c= and =xxx.h= and the name of the - produced Fortran files should be =xxx.f90= + If the name of the org-mode file is =xxx.org=, the name of the + produced C files should be =xxx.c= and =xxx.h= and the name of the + produced Fortran files should be =xxx.f90= -*** Application programming interface +** Application programming interface - The application programming interface (API) is designed to be - compatible with the C programming language (not C++), to ensure - that the library will be easily usable in any language. - This implies that only the following data types are allowed in the API: + The application programming interface (API) is designed to be + compatible with the C programming language (not C++), to ensure + that the library will be easily usable in any language. + This implies that only the following data types are allowed in the API: - - 32-bit and 64-bit floats and arrays - - 32-bit and 64-bit integers and arrays - - Pointers should be represented as 64-bit integers (even on - 32-bit architectures) - - ASCII strings are represented as a pointers to a character arrays - and terminated by a zero character (C convention). + - 32-bit and 64-bit floats and arrays + - 32-bit and 64-bit integers and arrays + - Pointers should be represented as 64-bit integers (even on + 32-bit architectures) + - ASCII strings are represented as a pointers to a character arrays + and terminated by a zero character (C convention). - To facilitate the use in other languages than C, we provide some - bindings in other languages in other repositories. + To facilitate the use in other languages than C, we provide some + bindings in other languages in other repositories. - # TODO : Link to repositories for bindings + # TODO : Link to repositories for bindings -*** Global state +** Global state - Global variables should be avoided in the library, because it is - possible that one single program needs to use multiple instances of - the library. To solve this problem we propose to use a pointer to a - =context= variable, built by the library with the - =qmckl_context_create= function. The =context= contains the global - state of the library, and is used as the first argument of many - QMCkl functions. + Global variables should be avoided in the library, because it is + possible that one single program needs to use multiple instances of + the library. To solve this problem we propose to use a pointer to a + =context= variable, built by the library with the + =qmckl_context_create= function. The =context= contains the global + state of the library, and is used as the first argument of many + QMCkl functions. - Modifying the state is done by setters and getters, prefixed - by =qmckl_context_set_= an =qmckl_context_get_=. - When a context variable is modified by a setter, a copy of the old - data structure is made and updated, and the pointer to the new data - structure is returned, such that the old contexts can still be - accessed. - It is also possible to modify the state in an impure fashion, using - the =qmckl_context_update_= functions. - The context and its old versions can be destroyed with - =qmckl_context_destroy=. + Modifying the state is done by setters and getters, prefixed + by =qmckl_context_set_= an =qmckl_context_get_=. + When a context variable is modified by a setter, a copy of the old + data structure is made and updated, and the pointer to the new data + structure is returned, such that the old contexts can still be + accessed. + It is also possible to modify the state in an impure fashion, using + the =qmckl_context_update_= functions. + The context and its old versions can be destroyed with + =qmckl_context_destroy=. -*** Low-level functions +** Low-level functions - Low-level functions are very simple functions which are leaves of the - function call tree (they don't call any other QMCkl function). + Low-level functions are very simple functions which are leaves of the + function call tree (they don't call any other QMCkl function). - This functions are /pure/, and unaware of the QMCkl =context=. They are - not allowed to allocate/deallocate memory, and if they need - temporary memory it should be provided in input. + This functions are /pure/, and unaware of the QMCkl =context=. They are + not allowed to allocate/deallocate memory, and if they need + temporary memory it should be provided in input. -*** High-level functions +** High-level functions - High-level functions are at the top of the function call tree. - They are able to choose which lower-level function to call - depending on the required precision, and do the corresponding type - conversions. - These functions are also responsible for allocating temporary - storage, to simplify the use of accelerators. + High-level functions are at the top of the function call tree. + They are able to choose which lower-level function to call + depending on the required precision, and do the corresponding type + conversions. + These functions are also responsible for allocating temporary + storage, to simplify the use of accelerators. - The high-level functions should be pure, unless the introduction of - non-purity is justified. All the side effects should be made in the - =context= variable. + The high-level functions should be pure, unless the introduction of + non-purity is justified. All the side effects should be made in the + =context= variable. - # TODO : We need an identifier for impure functions + # TODO : We need an identifier for impure functions -*** Numerical precision +** Numerical precision - The number of bits of precision required for a function should be - given as an input of low-level computational functions. This input will - be used to define the values of the different thresholds that might - be used to avoid computing unnecessary noise. - High-level functions will use the precision specified in the - =context= variable. + The number of bits of precision required for a function should be + given as an input of low-level computational functions. This input will + be used to define the values of the different thresholds that might + be used to avoid computing unnecessary noise. + High-level functions will use the precision specified in the + =context= variable. -** Algorithms +* Algorithms - Reducing the scaling of an algorithm usually implies also reducing - its arithmetic complexity (number of flops per byte). Therefore, - for small sizes \(\mathcal{O}(N^3)\) and \(\mathcal{O}(N^2)\) algorithms - are better adapted than linear scaling algorithms. - As QMCkl is a general purpose library, multiple algorithms should - be implemented adapted to different problem sizes. + Reducing the scaling of an algorithm usually implies also reducing + its arithmetic complexity (number of flops per byte). Therefore, + for small sizes \(\mathcal{O}(N^3)\) and \(\mathcal{O}(N^2)\) algorithms + are better adapted than linear scaling algorithms. + As QMCkl is a general purpose library, multiple algorithms should + be implemented adapted to different problem sizes. -** Rules for the API +* Rules for the API - - =stdint= should be used for integers (=int32_t=, =int64_t=) - - integers used for counting should always be =int64_t= - - floats should be by default =double=, unless explicitly mentioned - - pointers are converted to =int64_t= to increase portability + - =stdint= should be used for integers (=int32_t=, =int64_t=) + - integers used for counting should always be =int64_t= + - floats should be by default =double=, unless explicitly mentioned + - pointers are converted to =int64_t= to increase portability -** Documentation +* Documentation -- [[qmckl.org][Main QMCkl header file]] -- [[qmckl_memory.org][Memory management]] -- [[qmckl_context.org][Context]] -- [[qmckl_distance.org][Distance]] + - [[./qmckl.org][Main QMCkl header file]] + - [[./qmckl_memory.org][Memory management]] + - [[./qmckl_context.org][Context]] + - [[./qmckl_distance.org][Distance]] -** Acknowledgments +* Acknowledgments -[[https://trex-coe.eu/sites/default/files/inline-images/euflag.jpg]] -[[https://trex-coe.eu][TREX: Targeting Real Chemical Accuracy at the Exascale]] project has received funding from the European Union’s Horizon 2020 - Research and Innovation program - under grant agreement no. 952165. The content of this document does not represent the opinion of the European Union, and the European Union is not responsible for any use that might be made of such content. + [[https://trex-coe.eu/sites/default/files/inline-images/euflag.jpg]] + [[https://trex-coe.eu][TREX: Targeting Real Chemical Accuracy at the Exascale]] project has received funding from the European Union’s Horizon 2020 - Research and Innovation program - under grant agreement no. 952165. The content of this document does not represent the opinion of the European Union, and the European Union is not responsible for any use that might be made of such content. diff --git a/src/create_doc.sh b/src/create_doc.sh new file mode 100755 index 0000000..eddf509 --- /dev/null +++ b/src/create_doc.sh @@ -0,0 +1,22 @@ +#!/bin/bash + +# Tangle org files + +emacsclient -a "" \ + --socket-name=org_to_code \ + --eval "(require 'org)" + +for INPUT in $@ ; do + echo $INPUT + emacsclient \ + --no-wait \ + --socket-name=org_to_code \ + --eval "(find-file \"$INPUT\")" \ + --eval "(org-html-export-to-html)" +done + +emacsclient \ + --no-wait \ + --socket-name=org_to_code \ + --eval '(kill-emacs)' + diff --git a/src/qmckl.org b/src/qmckl.org index f1065f5..2d7e4f7 100644 --- a/src/qmckl.org +++ b/src/qmckl.org @@ -2,6 +2,13 @@ # vim: syntax=c #+TITLE: QMCkl C header +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: + This file produces the =qmckl.h= header file, which is included in all other C header files. It is the main entry point to the library. diff --git a/src/qmckl_context.org b/src/qmckl_context.org index a2ea884..dd5b843 100644 --- a/src/qmckl_context.org +++ b/src/qmckl_context.org @@ -2,6 +2,14 @@ # vim: syntax=c #+TITLE: Context +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: + + This file is written in C because it is more natural to express the context in C than in Fortran. @@ -36,7 +44,7 @@ MunitResult test_qmckl_context() { outside of the library. To simplify compatibility with other languages, the pointer to the internal data structure is converted into a 64-bit signed integer, defined in the =qmckl_context= type. - A value of 0 for the context is equivalent to a NULL pointer. + A value of 0 for the context is equivalent to a =NULL= pointer. *** Source #+BEGIN_SRC C :comments link :tangle qmckl_context.c @@ -347,7 +355,7 @@ qmckl_context qmckl_context_set_range(const qmckl_context context, const int ran #+END_SRC - + ** =qmckl_context_get_precision= #+BEGIN_SRC C :comments link :tangle qmckl_context.h diff --git a/src/qmckl_distance.org b/src/qmckl_distance.org index d3d76e2..b5deee5 100644 --- a/src/qmckl_distance.org +++ b/src/qmckl_distance.org @@ -2,14 +2,21 @@ # vim: syntax=c #+TITLE: Computation of distances +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: + Function for the computation of distances between particles. 3 files are produced: -- a header file : =qmckl_distance.h= -- a source file : =qmckl_distance.f90= -- a test file : =test_qmckl_distance.c= +- a header file : =qmckl_distance.h= +- a source file : =qmckl_distance.f90= +- a test file : =test_qmckl_distance.c= -*** Header +*** Header #+BEGIN_SRC C :comments link :tangle qmckl_distance.h #ifndef QMCKL_DISTANCE_H #define QMCKL_DISTANCE_H @@ -34,7 +41,7 @@ MunitResult test_qmckl_distance() { context = qmckl_context_create(); m = 5; - n = 6; + n = 6; LDA = 6; LDB = 10; LDC = 5; @@ -61,13 +68,13 @@ MunitResult test_qmckl_distance() { * Squared distance ** =qmckl_distance_sq= - + Computes the matrix of the squared distances between all pairs of points in two sets, one point within each set: \[ - C_{ij^2} = \sum_{k=1}^3 (A_{i,k}-B_{j,k})^2 + C_{ij} = \sum_{k=1}^3 (A_{i,k}-B_{j,k})^2 \] - + *** Arguments | =context= | input | Global state | @@ -95,7 +102,7 @@ MunitResult test_qmckl_distance() { *** Header #+BEGIN_SRC C :comments link :tangle qmckl_distance.h -qmckl_exit_code qmckl_distance_sq(qmckl_context context, +qmckl_exit_code qmckl_distance_sq(qmckl_context context, int64_t m, int64_t n, double *A, int64_t LDA, double *B, int64_t LDB, @@ -116,42 +123,42 @@ integer(c_int32_t) function qmckl_distance_sq(context, m, n, A, LDA, B, LDB, C, real (c_double) , intent(in) :: B(LDB,3) integer (c_int64_t) , intent(in) , value :: LDC real (c_double) , intent(out) :: C(LDC,n) - + integer (c_int64_t) :: i,j real (c_double) :: x, y, z - + info = 0 - + if (context == 0_8) then info = -1 return endif - + if (m <= 0_8) then info = -2 return endif - + if (n <= 0_8) then info = -3 return endif - + if (LDA < m) then info = -4 return endif - + if (LDB < n) then info = -5 return endif - + if (LDC < m) then info = -6 return endif - + do j=1,n do i=1,m x = A(i,1) - B(j,1) @@ -160,25 +167,25 @@ integer(c_int32_t) function qmckl_distance_sq(context, m, n, A, LDA, B, LDB, C, C(i,j) = x*x + y*y + z*z end do end do - + end function qmckl_distance_sq #+END_SRC *** Test #+BEGIN_SRC C :comments link :tangle test_qmckl_distance.c - munit_assert_int64(QMCKL_SUCCESS, ==, + munit_assert_int64(QMCKL_SUCCESS, ==, qmckl_distance_sq(context, m, n, A, LDA, B, LDB, C, LDC) ); for (j=0 ; j +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: + + We override the allocation functions to enable the possibility of optimized libraries to fine-tune the memory allocation. 3 files are produced: -- a header file : =qmckl_memory.h= -- a source file : =qmckl_memory.c= -- a test file : =test_qmckl_memory.c= +- a header file : =qmckl_memory.h= +- a source file : =qmckl_memory.c= +- a test file : =test_qmckl_memory.c= -*** Header - #+BEGIN_SRC C :comments link :tangle qmckl_memory.h +** Header + #+BEGIN_SRC C :comments link :tangle qmckl_memory.h #ifndef QMCKL_MEMORY_H #define QMCKL_MEMORY_H #include "qmckl.h" - #+END_SRC + #+END_SRC -*** Source - #+BEGIN_SRC C :comments link :tangle qmckl_memory.c +** Source + #+BEGIN_SRC C :comments link :tangle qmckl_memory.c #include #include "qmckl_memory.h" - #+END_SRC + #+END_SRC -*** Test - #+BEGIN_SRC C :comments link :tangle test_qmckl_memory.c +** Test + #+BEGIN_SRC C :comments link :tangle test_qmckl_memory.c #include "qmckl.h" #include "munit.h" MunitResult test_qmckl_memory() { - #+END_SRC + #+END_SRC -** =qmckl_malloc= - Analogous of =malloc, but passing a context and a signed 64-bit integers as argument.= -*** Header - #+BEGIN_SRC C :comments link :tangle qmckl_memory.h +* =qmckl_malloc= + Analogous of =malloc, but passing a context and a signed 64-bit integers as argument.= +** Header + #+BEGIN_SRC C :comments link :tangle qmckl_memory.h void* qmckl_malloc(const qmckl_context ctx, const size_t size); - #+END_SRC + #+END_SRC -*** Source - #+BEGIN_SRC C :comments link :tangle qmckl_memory.c +** Source + #+BEGIN_SRC C :comments link :tangle qmckl_memory.c void* qmckl_malloc(const qmckl_context ctx, const size_t size) { if (ctx == (qmckl_context) 0) { /* Avoids unused parameter error */ @@ -47,10 +55,10 @@ void* qmckl_malloc(const qmckl_context ctx, const size_t size) { return malloc( (size_t) size ); } - #+END_SRC - -*** Test - #+BEGIN_SRC C :comments link :tangle test_qmckl_memory.c + #+END_SRC + +** Test + #+BEGIN_SRC C :comments link :tangle test_qmckl_memory.c int *a; a = (int*) qmckl_malloc( (qmckl_context) 1, 3*sizeof(int)); a[0] = 1; @@ -59,37 +67,37 @@ void* qmckl_malloc(const qmckl_context ctx, const size_t size) { munit_assert_int(a[0], ==, 1); munit_assert_int(a[1], ==, 2); munit_assert_int(a[2], ==, 3); - #+END_SRC + #+END_SRC -** =qmckl_free= +* =qmckl_free= -*** Header - #+BEGIN_SRC C :comments link :tangle qmckl_memory.h +** Header + #+BEGIN_SRC C :comments link :tangle qmckl_memory.h void qmckl_free(void *ptr); - #+END_SRC + #+END_SRC -*** Source - #+BEGIN_SRC C :comments link :tangle qmckl_memory.c +** Source + #+BEGIN_SRC C :comments link :tangle qmckl_memory.c void qmckl_free(void *ptr) { free(ptr); } - #+END_SRC - -*** Test - #+BEGIN_SRC C :comments link :tangle test_qmckl_memory.c + #+END_SRC + +** Test + #+BEGIN_SRC C :comments link :tangle test_qmckl_memory.c qmckl_free(a); - #+END_SRC + #+END_SRC * End of files -*** Header - #+BEGIN_SRC C :comments link :tangle qmckl_memory.h +** Header + #+BEGIN_SRC C :comments link :tangle qmckl_memory.h #endif - #+END_SRC + #+END_SRC -*** Test - #+BEGIN_SRC C :comments link :tangle test_qmckl_memory.c +** Test + #+BEGIN_SRC C :comments link :tangle test_qmckl_memory.c return MUNIT_OK; -} +} - #+END_SRC + #+END_SRC diff --git a/src/test_qmckl.org b/src/test_qmckl.org index 2171739..f2ca850 100644 --- a/src/test_qmckl.org +++ b/src/test_qmckl.org @@ -1,5 +1,12 @@ #+TITLE: QMCkl test +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: +#+HTML_HEAD: + This file is the main program of the unit tests. The tests rely on the $\mu$unit framework, which is provided as a git submodule.