mirror of
https://github.com/triqs/dft_tools
synced 2024-12-25 13:53:40 +01:00
Work on doc
This commit is contained in:
parent
f04b0b1058
commit
352d049137
@ -2,7 +2,9 @@
|
|||||||
Authors & contributors
|
Authors & contributors
|
||||||
=========================
|
=========================
|
||||||
|
|
||||||
The TRIQS library is currrently developed by O. Parcollet (IPhT, CEA-Saclay) and M. Ferrero (CPHT, Ecole Polytechique).
|
The TRIQS library has been developed and is currently maintained by :
|
||||||
|
|
||||||
|
O. Parcollet (IPhT, CEA-Saclay) and M. Ferrero (CPHT, Ecole Polytechique).
|
||||||
|
|
||||||
It is supported by ERC under Grant Number XXX.
|
It is supported by ERC under Grant Number XXX.
|
||||||
|
|
||||||
|
@ -16,7 +16,7 @@ is a scientific project providing a set of C++ and Python libraries to develop n
|
|||||||
for the study of interacting quantum systems.
|
for the study of interacting quantum systems.
|
||||||
|
|
||||||
The goal of this toolkit is to provide condensed matter physicists with
|
The goal of this toolkit is to provide condensed matter physicists with
|
||||||
high level, efficient and simple to use libraries in C++ and Python,
|
some high level, efficient and simple to use libraries in C++ and Python,
|
||||||
and to promote the use of modern programming techniques in our field.
|
and to promote the use of modern programming techniques in our field.
|
||||||
|
|
||||||
TRIQS is free software (GPL).
|
TRIQS is free software (GPL).
|
||||||
|
@ -14,29 +14,17 @@ To specify the compiler with cmake one may use the CXX, CXXFLAGS variables, e.g.
|
|||||||
|
|
||||||
CXX=clang++ CXXFLAGS=XXXX cmake path_to_TRIQS_source_directory ...
|
CXX=clang++ CXXFLAGS=XXXX cmake path_to_TRIQS_source_directory ...
|
||||||
|
|
||||||
Customize the installation
|
cmake options
|
||||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||||
|
|
||||||
You can then customize the installation options using the :program:`ccmake` program::
|
|
||||||
|
|
||||||
ccmake .
|
+--------------------------------------+------------------------------------------------+
|
||||||
|
| Options | Syntax |
|
||||||
This opens an interface with your main installation options shown::
|
+======================================+================================================+
|
||||||
|
| Build the documentation | -DBuild_Documentation=ON |
|
||||||
BUILD_SHARED_LIBS ON
|
+--------------------------------------+------------------------------------------------+
|
||||||
Build_Documentation OFF
|
| Special python interpreter | -DPYTHON_INTERPRETER=path/python |
|
||||||
Build_Triqs_General_Tools_Test ON
|
+--------------------------------------+------------------------------------------------+
|
||||||
CMAKE_INSTALL_PREFIX /home/parcolle/BUILD2/Triqs_dynamic/INSTALL_DIR
|
| Specify the installation directory | -DCMAKE_INSTALL_PREFIX=install_path |
|
||||||
Install_dev OFF
|
+--------------------------------------+------------------------------------------------+
|
||||||
LAPACK_LIBS /usr/lib/liblapack.so;/usr/lib/libblas.so;/usr/lib/libpthread.so;/usr/lib/libblas.so
|
|
||||||
PYTHON_INTERPRETER /usr/bin/python
|
|
||||||
|
|
||||||
You can for instance change the following options:
|
|
||||||
|
|
||||||
* ``CMAKE_INSTALL_PREFIX``: This is the directory :file:`path_to_install_directory` where you want to install TRIQS.
|
|
||||||
* ``Build_Documentation``: Get the documentation locally in :file:`path_to_install_directory/share/doc`.
|
|
||||||
|
|
||||||
You may change all other installation options (like locations of libraries, the choice of compilers, etc.) in the advanced mode, by typing 't' after having opened the *ccmake* interface.
|
|
||||||
|
|
||||||
After having corrected your options you may build, test and install TRIQS as described in :ref:`installation`.
|
|
||||||
|
|
||||||
|
@ -43,26 +43,6 @@ Installation of the dependencies
|
|||||||
### brew install boost --without-single --with-mpi --with-c++11
|
### brew install boost --without-single --with-mpi --with-c++11
|
||||||
brew install http://ipht.cea.fr/triqs/boost.rb --without-single --with-mpi --with-c++11 -v
|
brew install http://ipht.cea.fr/triqs/boost.rb --without-single --with-mpi --with-c++11 -v
|
||||||
|
|
||||||
4. Now install virtualenv: ::
|
|
||||||
|
|
||||||
pip install virtualenv
|
|
||||||
virtualenv mypython
|
|
||||||
|
|
||||||
Using virtualenv provides a clean way to set up a different python environment for each user.
|
|
||||||
The first line in the instructions above installs the package and the second creates the virtual
|
|
||||||
environment, which is created in ``$HOME/mypython``.
|
|
||||||
Make sure to permanently add (prepend) ``$HOME/mypython/bin`` to your path by adding ::
|
|
||||||
|
|
||||||
export PATH = $HOME/mypython/bin:$PATH
|
|
||||||
|
|
||||||
to your ``.bashrc file`` (assuming bash). Within a new shell, check that
|
|
||||||
|
|
||||||
which python
|
|
||||||
which pip
|
|
||||||
which easy_install
|
|
||||||
|
|
||||||
yield the ones located in ``$HOME/mypython``.
|
|
||||||
|
|
||||||
5. Install the required python packages: ::
|
5. Install the required python packages: ::
|
||||||
|
|
||||||
pip install numpy
|
pip install numpy
|
||||||
@ -70,14 +50,13 @@ yield the ones located in ``$HOME/mypython``.
|
|||||||
pip install scipy
|
pip install scipy
|
||||||
pip install mpi4py
|
pip install mpi4py
|
||||||
pip install matplotlib
|
pip install matplotlib
|
||||||
# seems useless now...
|
|
||||||
#pip install git+https://github.com/matplotlib/matplotlib.git#egg=matplotlib-dev
|
|
||||||
pip install tornado
|
pip install tornado
|
||||||
pip install pyzmq
|
pip install pyzmq
|
||||||
pip install jinja2
|
pip install jinja2
|
||||||
pip install ipython
|
pip install ipython
|
||||||
pip install cython
|
pip install cython
|
||||||
|
# strangely, cython is not in bin, hence not in the path...
|
||||||
|
pushd /usr/local/bin && ln -s /usr/local/share/python/cython . && popd
|
||||||
|
|
||||||
6. If you wish to compile the documentation locally, install sphinx, its dependencies and mathjax: ::
|
6. If you wish to compile the documentation locally, install sphinx, its dependencies and mathjax: ::
|
||||||
|
|
||||||
@ -87,7 +66,6 @@ yield the ones located in ``$HOME/mypython``.
|
|||||||
|
|
||||||
NB : you need pyparsing <=1.5.7 since apparently v.2.0 works only for python 3.
|
NB : you need pyparsing <=1.5.7 since apparently v.2.0 works only for python 3.
|
||||||
|
|
||||||
7. Download the latest `sources of boost <http://www.boost.org/users/download/>`_ and untar them into a directory ``BOOST_SRC``.
|
|
||||||
|
|
||||||
Possible issues
|
Possible issues
|
||||||
---------------
|
---------------
|
||||||
|
Loading…
Reference in New Issue
Block a user