diff options
| author | CoprDistGit <infra@openeuler.org> | 2023-05-10 03:34:50 +0000 |
|---|---|---|
| committer | CoprDistGit <infra@openeuler.org> | 2023-05-10 03:34:50 +0000 |
| commit | c33f816a00c19f255a7b63e60af92480e00a112f (patch) | |
| tree | db62634d4d3bf816c36148ff2f1ebfb64d9b8956 | |
| parent | 1428036c69bd1d72dd036b7009ca4f3b28a67a56 (diff) | |
automatic import of python-hecssopeneuler20.03
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-hecss.spec | 365 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 367 insertions, 0 deletions
@@ -0,0 +1 @@ +/hecss-0.5.0.2.tar.gz diff --git a/python-hecss.spec b/python-hecss.spec new file mode 100644 index 0000000..b28cf92 --- /dev/null +++ b/python-hecss.spec @@ -0,0 +1,365 @@ +%global _empty_manifest_terminate_build 0 +Name: python-hecss +Version: 0.5.0.2 +Release: 1 +Summary: High Efficiency Configuration Space Sampler +License: GNU General Public License ver. 3 +URL: https://gitlab.com/jochym/hecss/tree/devel/ +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/fb/67/a3a62e85a70be58d9a0a8090792a164ab5dcd7b7bca085b100e22acd90a8/hecss-0.5.0.2.tar.gz +BuildArch: noarch + +Requires: python3-ase +Requires: python3-spglib +Requires: python3-tqdm +Requires: python3-click +Requires: python3-matplotlib +Requires: python3-numpy +Requires: python3-scipy +Requires: python3-ipython + +%description +# HECSS +> High Efficiency Configuration Space Sampler + + +[](https://pypi.org/project/hecss/) +[](https://pypi.org/project/hecss/) +[](https://anaconda.org/conda-forge/hecss) +[](https://anaconda.org/conda-forge/hecss) +[](https://anaconda.org/jochym/hecss) + +HECSS is a Markow chain Monte-Carlo, configuration space sampler using Metropolis-Hastings algorithm for probablity distribution sampling. It provides an alternative way to create representations of systems at thermal equilibrium without running a very expensive molecular dynamics simulation. The theoretical foundation of the code are presented in [SciPost Phys. 10, 129 (2021)](https://scipost.org/SciPostPhys.10.6.129) (short excerpt in [Background](https://jochym.gitlab.io/hecss/Background) in the [Documentation](https://jochym.gitlab.io/hecss/)). More detailed examples are included in the [LAMMPS](https://jochym.gitlab.io/hecss/LAMMPS_Tutorial) and [VASP](https://jochym.gitlab.io/hecss/VASP_Tutorial) tutorials. + +If you use this software in published research please cite the above paper ([BibTeX](https://gitlab.com/jochym/hecss/-/raw/master/scipost.bib)) in your publication. + +## A very short example + +Minimal example using LAMMPS potential from the asap3 package and OpenKIM database. Here we will sample the thermodynamic distribution of 3C-SiC crystal at 300K. We start by importing required modules, define the crystal and energy/forces calculator, run the sampler and finally plot the energy distribution. + +```python +#asap +from ase.build import bulk +import asap3 +from hecss.core import HECSS, select_asap_model +from hecss.monitor import plot_stats +``` + +Then we define the crystal and interaction model used in the calculation. In this case we use 3x3x3 supercell of the SiC crystal in zincblende structure and describe the interaction using LAMMPS potential from the OpenKIM database and ASAP3 implementation of the calculator. + +```python +#asap +# model = 'Tersoff_LAMMPS_ErhartAlbe_2005_SiC__MO_903987585848_003' +model = select_asap_model('SiC') +cryst = bulk('SiC', crystalstructure='zincblende', a=4.38120844, cubic=True).repeat((3,3,3)) +cryst.set_calculator(asap3.OpenKIMcalculator(model)) +``` + +Then we define the sampler parameters (N -- number of samples, T -- temperature) and run it. + +```python +#asap +T = 300 +N = 1_000 +samples = HECSS(cryst, asap3.OpenKIMcalculator(model), T).generate(N) +``` + +And finally we plot the histogram of the resulting energy distribution which corresponds to the thermal equilibrium distribution. + +```python +#asap +plot_stats(samples, T) +``` + + + + + + + +## Install + +The HECSS package is avaliable on pypi and conda-forge additionally the package is present also in my personal anaconda channel (jochym). Installation is simple, but requires a number of other packages to be installed as well. Package menagers handle these dependencies automatically. + +### Install with pip +It is advisable to install in a dedicated virtual environment e.g.: +``` +python3 -m venv venv +. venv/bin/activate +``` +then install with `pip`: +``` +pip install hecss +``` + +### Install with conda +Also installation with conda should be performed for dedicated or some other non-base environment. To create dedicated environment you can invoke `conda create`: +``` +conda create -n hecss -c conda-forge hecss +``` +or you can install in some working environment `venv`: +``` +conda install -n venv -c conda-forge hecss +``` + +### Example data archive + +The example subdirectory from the source may be downloaded directly from the source repository: [hecss-examples.zip](https://gitlab.com/jochym/hecss/-/archive/master/hecss-master.zip?path=example) + +### The source code + +The source is published at the [Gitlab hecss repository](https://gitlab.com/jochym/hecss). +You can access it with git (recommended, particularly if you want to contribute to the development): +```bash +git clone https://gitlab.com/jochym/hecss.git +``` +or you can download the whole distribution as a zip archive: [hecss.zip](https://gitlab.com/jochym/hecss/-/archive/master/hecss-master.zip) + + +%package -n python3-hecss +Summary: High Efficiency Configuration Space Sampler +Provides: python-hecss +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-hecss +# HECSS +> High Efficiency Configuration Space Sampler + + +[](https://pypi.org/project/hecss/) +[](https://pypi.org/project/hecss/) +[](https://anaconda.org/conda-forge/hecss) +[](https://anaconda.org/conda-forge/hecss) +[](https://anaconda.org/jochym/hecss) + +HECSS is a Markow chain Monte-Carlo, configuration space sampler using Metropolis-Hastings algorithm for probablity distribution sampling. It provides an alternative way to create representations of systems at thermal equilibrium without running a very expensive molecular dynamics simulation. The theoretical foundation of the code are presented in [SciPost Phys. 10, 129 (2021)](https://scipost.org/SciPostPhys.10.6.129) (short excerpt in [Background](https://jochym.gitlab.io/hecss/Background) in the [Documentation](https://jochym.gitlab.io/hecss/)). More detailed examples are included in the [LAMMPS](https://jochym.gitlab.io/hecss/LAMMPS_Tutorial) and [VASP](https://jochym.gitlab.io/hecss/VASP_Tutorial) tutorials. + +If you use this software in published research please cite the above paper ([BibTeX](https://gitlab.com/jochym/hecss/-/raw/master/scipost.bib)) in your publication. + +## A very short example + +Minimal example using LAMMPS potential from the asap3 package and OpenKIM database. Here we will sample the thermodynamic distribution of 3C-SiC crystal at 300K. We start by importing required modules, define the crystal and energy/forces calculator, run the sampler and finally plot the energy distribution. + +```python +#asap +from ase.build import bulk +import asap3 +from hecss.core import HECSS, select_asap_model +from hecss.monitor import plot_stats +``` + +Then we define the crystal and interaction model used in the calculation. In this case we use 3x3x3 supercell of the SiC crystal in zincblende structure and describe the interaction using LAMMPS potential from the OpenKIM database and ASAP3 implementation of the calculator. + +```python +#asap +# model = 'Tersoff_LAMMPS_ErhartAlbe_2005_SiC__MO_903987585848_003' +model = select_asap_model('SiC') +cryst = bulk('SiC', crystalstructure='zincblende', a=4.38120844, cubic=True).repeat((3,3,3)) +cryst.set_calculator(asap3.OpenKIMcalculator(model)) +``` + +Then we define the sampler parameters (N -- number of samples, T -- temperature) and run it. + +```python +#asap +T = 300 +N = 1_000 +samples = HECSS(cryst, asap3.OpenKIMcalculator(model), T).generate(N) +``` + +And finally we plot the histogram of the resulting energy distribution which corresponds to the thermal equilibrium distribution. + +```python +#asap +plot_stats(samples, T) +``` + + + + + + + +## Install + +The HECSS package is avaliable on pypi and conda-forge additionally the package is present also in my personal anaconda channel (jochym). Installation is simple, but requires a number of other packages to be installed as well. Package menagers handle these dependencies automatically. + +### Install with pip +It is advisable to install in a dedicated virtual environment e.g.: +``` +python3 -m venv venv +. venv/bin/activate +``` +then install with `pip`: +``` +pip install hecss +``` + +### Install with conda +Also installation with conda should be performed for dedicated or some other non-base environment. To create dedicated environment you can invoke `conda create`: +``` +conda create -n hecss -c conda-forge hecss +``` +or you can install in some working environment `venv`: +``` +conda install -n venv -c conda-forge hecss +``` + +### Example data archive + +The example subdirectory from the source may be downloaded directly from the source repository: [hecss-examples.zip](https://gitlab.com/jochym/hecss/-/archive/master/hecss-master.zip?path=example) + +### The source code + +The source is published at the [Gitlab hecss repository](https://gitlab.com/jochym/hecss). +You can access it with git (recommended, particularly if you want to contribute to the development): +```bash +git clone https://gitlab.com/jochym/hecss.git +``` +or you can download the whole distribution as a zip archive: [hecss.zip](https://gitlab.com/jochym/hecss/-/archive/master/hecss-master.zip) + + +%package help +Summary: Development documents and examples for hecss +Provides: python3-hecss-doc +%description help +# HECSS +> High Efficiency Configuration Space Sampler + + +[](https://pypi.org/project/hecss/) +[](https://pypi.org/project/hecss/) +[](https://anaconda.org/conda-forge/hecss) +[](https://anaconda.org/conda-forge/hecss) +[](https://anaconda.org/jochym/hecss) + +HECSS is a Markow chain Monte-Carlo, configuration space sampler using Metropolis-Hastings algorithm for probablity distribution sampling. It provides an alternative way to create representations of systems at thermal equilibrium without running a very expensive molecular dynamics simulation. The theoretical foundation of the code are presented in [SciPost Phys. 10, 129 (2021)](https://scipost.org/SciPostPhys.10.6.129) (short excerpt in [Background](https://jochym.gitlab.io/hecss/Background) in the [Documentation](https://jochym.gitlab.io/hecss/)). More detailed examples are included in the [LAMMPS](https://jochym.gitlab.io/hecss/LAMMPS_Tutorial) and [VASP](https://jochym.gitlab.io/hecss/VASP_Tutorial) tutorials. + +If you use this software in published research please cite the above paper ([BibTeX](https://gitlab.com/jochym/hecss/-/raw/master/scipost.bib)) in your publication. + +## A very short example + +Minimal example using LAMMPS potential from the asap3 package and OpenKIM database. Here we will sample the thermodynamic distribution of 3C-SiC crystal at 300K. We start by importing required modules, define the crystal and energy/forces calculator, run the sampler and finally plot the energy distribution. + +```python +#asap +from ase.build import bulk +import asap3 +from hecss.core import HECSS, select_asap_model +from hecss.monitor import plot_stats +``` + +Then we define the crystal and interaction model used in the calculation. In this case we use 3x3x3 supercell of the SiC crystal in zincblende structure and describe the interaction using LAMMPS potential from the OpenKIM database and ASAP3 implementation of the calculator. + +```python +#asap +# model = 'Tersoff_LAMMPS_ErhartAlbe_2005_SiC__MO_903987585848_003' +model = select_asap_model('SiC') +cryst = bulk('SiC', crystalstructure='zincblende', a=4.38120844, cubic=True).repeat((3,3,3)) +cryst.set_calculator(asap3.OpenKIMcalculator(model)) +``` + +Then we define the sampler parameters (N -- number of samples, T -- temperature) and run it. + +```python +#asap +T = 300 +N = 1_000 +samples = HECSS(cryst, asap3.OpenKIMcalculator(model), T).generate(N) +``` + +And finally we plot the histogram of the resulting energy distribution which corresponds to the thermal equilibrium distribution. + +```python +#asap +plot_stats(samples, T) +``` + + + + + + + +## Install + +The HECSS package is avaliable on pypi and conda-forge additionally the package is present also in my personal anaconda channel (jochym). Installation is simple, but requires a number of other packages to be installed as well. Package menagers handle these dependencies automatically. + +### Install with pip +It is advisable to install in a dedicated virtual environment e.g.: +``` +python3 -m venv venv +. venv/bin/activate +``` +then install with `pip`: +``` +pip install hecss +``` + +### Install with conda +Also installation with conda should be performed for dedicated or some other non-base environment. To create dedicated environment you can invoke `conda create`: +``` +conda create -n hecss -c conda-forge hecss +``` +or you can install in some working environment `venv`: +``` +conda install -n venv -c conda-forge hecss +``` + +### Example data archive + +The example subdirectory from the source may be downloaded directly from the source repository: [hecss-examples.zip](https://gitlab.com/jochym/hecss/-/archive/master/hecss-master.zip?path=example) + +### The source code + +The source is published at the [Gitlab hecss repository](https://gitlab.com/jochym/hecss). +You can access it with git (recommended, particularly if you want to contribute to the development): +```bash +git clone https://gitlab.com/jochym/hecss.git +``` +or you can download the whole distribution as a zip archive: [hecss.zip](https://gitlab.com/jochym/hecss/-/archive/master/hecss-master.zip) + + +%prep +%autosetup -n hecss-0.5.0.2 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-hecss -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed May 10 2023 Python_Bot <Python_Bot@openeuler.org> - 0.5.0.2-1 +- Package Spec generated @@ -0,0 +1 @@ +3ab20e8579630e0b9dd6e53411210864 hecss-0.5.0.2.tar.gz |
