.. image:: https://img.shields.io/pypi/v/edrixs.svg :target: https://pypi.python.org/pypi/edrixs
.. image:: https://mybinder.org/badge_logo.svg :target: https://mybinder.org/v2/gh/NSLS-II/edrixs.git/master?urlpath=lab
An open source toolkit for simulating RIXS spectra based on exact diagonalization (ED) for strongly correlated materials.
It is developed <https://www.bnl.gov/comscope/software/EDRIXS.php>
as part of COMSCOPE project <https://www.bnl.gov/comscope/software/comsuite.php/>
in the Center for Computational Material Spectroscopy and Design, Brookhaven National Laboratory
MyBinder Session <https://mybinder.org/v2/gh/NSLS-II/edrixs.git/master?urlpath=lab>
_ to try the code.If you are using the EDRIXS code to do some studies and would like to publish your great works, it would be really appreciated if you can cite the following paper:
EDRIXS: An open source toolkit for simulating spectra of resonant inelastic x-ray scattering, Y.L. Wang, G. Fabbris, M.P.M. Dean and G. Kotliar
, Computer Physics Communications,243, 151 (2019) <https://doi.org/10.1016/j.cpc.2019.04.018>
, arXiv:1812.05735 <https://arxiv.org/abs/1812.05735/>
.
.. code-block:: bash
$ conda create --name edrixs_env python=3.7
$ conda activate edrixs_env
$ conda install -c conda-forge edrixs
To make life easier, we have built a docker image based on Ubuntu Linux (18.04) for edrixs, so you don't need to struggle with the installation anymore.
The docker image can be used on any OS as long as the docker <https://www.docker.com/>
_ application are available.
Follow these steps to use the docker image:
Install the docker <https://www.docker.com/>
application on your system and learn how to use it <https://docs.docker.com/get-started/>
.
Once the docker is running, create a directory to store data in your host OS and launch a container to run edrixs
.. code-block:: bash
$ mkdir /dir/on/your/host/os # A directory on your host OS $ docker pull edrixs/edrixs # pull latest version $ docker run -it -p 8888:8888 -u rixs -w /home/rixs -v /dir/on/your/host/os:/home/rixs/data edrixs/edrixs
it will take a while to pull the image from Docker Hub <https://cloud.docker.com/repository/docker/edrixs/edrixs/>
_ for the first time, while, it will launch the local one very fast at the next time.
-p 8888:8888
maps container's port 8888 to host port 8888.-u rix
means using a default user rixs
to login the Ubuntu Linux, the password is rixs
.-v /dir/on/your/host/os:/home/rixs/dat
means mounting the directory /dir/on/your/host/os
from your host OS to /home/rixs/data
on the Ubuntu Linux in the container.After launching the container, you will see data
and edrixs_examples
in /home/rixs
directory. If you want to save the data from edrixs calculations to your host system, you need to work in /home/rixs/data
directory.
.. code-block:: bash
$ cd /home/rixs/data $ cp -r ../edrixs_examples . $ Play with edrixs ...
Note that any changes outside /home/rixs/data
will be lost when this container stops. You can only use your host OS to make interactive plots. Use sudo apt-get install
to install softwares if they are needed.
Type exit
in the container to exit. You can delete all the stopped containers by
.. code-block:: bash
$ docker rm $(docker ps -a -q)
You can delete the edrixs image by
.. code-block:: bash
$ docker rmi edrixs/edrixs
Required tools and libraries
Be sure to compile OpenBLAS, arpack-ng, mpi4py and edrixs with the same (MPI) Fortran compiler.
Install edrixs
.. code-block:: bash
$ pip install -v .
There will be problems when using gfortran with MKL, so we recommend gfortran+OpenBLAS
or ifort+MKL
. The executable .x
files will be installed in the bin
directory of the active python environment.
The fortran library and compiled python extension are built using cmake
which can be configured by setting the CMAKE_CONFIGURE_ARGS
environment variable.
Please see our online documentation <https://nsls-ii.github.io/edrixs/user/installation.html>
_ for more details of installation.