pyALF 2.5.post55__tar.gz → 2.6__tar.gz

pyalf-2.6/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: pyALF
+Version: 2.6
+Summary: Python interface for ALF, plus scripts and Jupyter notebooks.
+Author-email: ALF Collaboration <alf@physik.uni-wuerzburg.de>, Jonas Schwab <jonas.schwab@uni-wuerzburg.de>
+License-Expression: GPL-2.0-or-later
+Project-URL: Documentation, https://alf.physik.uni-wuerzburg.de/pyalf-doc/
+Project-URL: Repository, https://github.com/ALF-QMC/pyALF
+Project-URL: Issues, https://github.com/ALF-QMC/pyALF/issues
+Project-URL: ALF Homepage, https://alf.physik.uni-wuerzburg.de/
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: f90nml
+Requires-Dist: h5py
+Requires-Dist: ipympl
+Requires-Dist: ipywidgets
+Requires-Dist: matplotlib
+Requires-Dist: numba
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: scipy
+Provides-Extra: gui
+Requires-Dist: tkinter; extra == "gui"
+Provides-Extra: doc
+Requires-Dist: sphinxcontrib-svg2pdfconverter; extra == "doc"
+Requires-Dist: jupyter-book<2.0; extra == "doc"
+Requires-Dist: numpydoc; extra == "doc"
+Requires-Dist: sphinx-argparse; extra == "doc"
+Dynamic: license-file
+
+[![Documentation](https://img.shields.io/badge/-Documentation-blue)](https://gitpages.physik.uni-wuerzburg.de/ALF/pyALF)
+[<img src="https://img.shields.io/badge/Supported%20By-UNITARY%20FUND-brightgreen.svg?style=for-the-badge" alt="drawing" width="170"/>](https://unitary.fund)
+
+## pyALF
+
+A Python package building on top of [ALF](https://github.com/ALF-QMC/ALF), meant to simplify the different steps of working with ALF, including:
+
+* Obtaining and compiling the ALF source code
+* Preparing and running simulations
+* Postprocessing and displaying the data obtained during the simulation
+
+It introduces:
+
+* The Python module `py_alf`, exposing all the package's utility to Python.
+* A set of command line tools in the folder, that make it easy to leverage pyALF from a Unix shell.
+  They are automatically exposed to the shell when pyALF is installed via pip.
+  Their source code can be found in [py_alf/cli](py_alf/cli) and documentation
+  [here](https://gitpages.physik.uni-wuerzburg.de/ALF/pyALF/source/reference/cli.html).
+* Jupyter notebooks in the folder [Notebooks](Notebooks), serving as an easy introduction to QMC and ALF.
+* Python Scripts in the folder [Scripts](Scripts) that can be run to reproduce benchmark results for established models.
+
+The **documentation** can be found [here](https://gitpages.physik.uni-wuerzburg.de/ALF/pyALF).
+
+## Installation
+
+---
+**⚠️ NOTE** In previous versions of pyALF, the installation instructions asked the users to set the environment variable `PYTHONPATH`.
+This conflicts with the newer pip package, therefore you should remove definitions of this environment variable related to pyALF.
+
+---
+
+pyALF can be installed via the Python package installer [pip](https://pip.pypa.io/en/stable/).
+
+```bash
+pip install pyALF
+```
+
+For running ALF, you will additionaly need the [ALF prerequsites](https://github.com/ALF-QMC/ALF#prerequisites).
+
+Alternatively, one could use [this Docker image](https://hub.docker.com/r/alfcollaboration/jupyter-pyalf-full), which has ALF, pyALF and a Jupyter server pre-installed.
+
+### Development installation
+
+If you want to develop pyALF, you can clone the repository and install it in
+[development mode](https://setuptools.pypa.io/en/latest/userguide/development_mode.html),
+which allows you to edit the files while using them like an installed package.
+For this, it is highly recommended to use a dedicated Python environment using e.g.
+[Python venv](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/)
+or a
+[conda environment](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html).
+The following example shows how to install pyALF in development mode using venv.
+
+```bash
+git clone https://github.com/ALF-QMC/pyALF.git
+cd pyALF
+python -m venv .venv
+source .venv/bin/activate
+
+pip install --editable .
+```
+
+## Usage
+
+There are multiple ways to use pyALF, which roughly breaks down into three approaches:
+* Using Jupyter notebooks
+* Using the command line interface
+* Use the module `py_alf` in custom scripts
+
+### Jupyter notebooks
+
+A convenient way to use pyALF is through Jupyter notebooks. They [are run](https://jupyter.readthedocs.io/en/latest/running.html) through a Jupyter server started, e.g., from the command line:
+
+```bash
+jupyter-lab
+```
+
+or
+
+```bash
+jupyter-notebook
+```
+
+which opens the "notebook dashboard" in your default browser, from where one can open the sample notebooks in [Notebooks/](Notebooks) and create new notebooks.
+
+### Command line interface
+
+pyALF also delivers a set of command line scripts, to be use from a UNIX shell. For a full list of command line scripts see [here](https://gitpages.physik.uni-wuerzburg.de/ALF/pyALF/source/reference/cli.html).
+
+Try, e.g.
+
+```bash
+alf_run -h
+```
+
+The source code for the scripts can be found in the folder [py_alf/cli/](py_alf/cli).
+
+
+### Use module `py_alf` in custom scripts
+
+Finally, one can also use the module module `py_alf` in custom Python scripts, which is analogous to the usage in Jupyter notebooks minus some interactivity.
+
+## License
+
+The various works that make up the ALF project are placed under licenses that put
+a strong emphasis on the attribution of the original authors and the sharing of the contained knowledge.
+To that end we have placed the ALF source code under the GPL version 3 license (see license.GPL and license.additional)
+and took the liberty as per GPLv3 section 7 to include additional terms that deal with the attribution
+of the original authors(see license.additional).
+The Documentation of the ALF project by the ALF contributors is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License (see Documentation/license.CCBYSA)
+We mention that we link against parts of lapack which licensed under a BSD license(see license.BSD).

{pyalf-2.5.post55 → pyalf-2.6}/README.md

@@ -3,7 +3,7 @@
 
 ## pyALF
 
-A Python package building on top of [ALF](https://git.physik.uni-wuerzburg.de/ALF/ALF), meant to simplify the different steps of working with ALF, including:
+A Python package building on top of [ALF](https://github.com/ALF-QMC/ALF), meant to simplify the different steps of working with ALF, including:
 
 * Obtaining and compiling the ALF source code
 * Preparing and running simulations
@@ -35,7 +35,7 @@ pyALF can be installed via the Python package installer [pip](https://pip.pypa.i
 pip install pyALF
 ```
 
-For running ALF, you will additionaly need the [ALF prerequsites](https://git.physik.uni-wuerzburg.de/ALF/ALF#prerequisites).
+For running ALF, you will additionaly need the [ALF prerequsites](https://github.com/ALF-QMC/ALF#prerequisites).
 
 Alternatively, one could use [this Docker image](https://hub.docker.com/r/alfcollaboration/jupyter-pyalf-full), which has ALF, pyALF and a Jupyter server pre-installed.
 
@@ -51,7 +51,7 @@ or a
 The following example shows how to install pyALF in development mode using venv.
 
 ```bash
-git clone https://git.physik.uni-wuerzburg.de/ALF/pyALF.git
+git clone https://github.com/ALF-QMC/pyALF.git
 cd pyALF
 python -m venv .venv
 source .venv/bin/activate

pyalf-2.6/pyALF.egg-info/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: pyALF
+Version: 2.6
+Summary: Python interface for ALF, plus scripts and Jupyter notebooks.
+Author-email: ALF Collaboration <alf@physik.uni-wuerzburg.de>, Jonas Schwab <jonas.schwab@uni-wuerzburg.de>
+License-Expression: GPL-2.0-or-later
+Project-URL: Documentation, https://alf.physik.uni-wuerzburg.de/pyalf-doc/
+Project-URL: Repository, https://github.com/ALF-QMC/pyALF
+Project-URL: Issues, https://github.com/ALF-QMC/pyALF/issues
+Project-URL: ALF Homepage, https://alf.physik.uni-wuerzburg.de/
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: f90nml
+Requires-Dist: h5py
+Requires-Dist: ipympl
+Requires-Dist: ipywidgets
+Requires-Dist: matplotlib
+Requires-Dist: numba
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: scipy
+Provides-Extra: gui
+Requires-Dist: tkinter; extra == "gui"
+Provides-Extra: doc
+Requires-Dist: sphinxcontrib-svg2pdfconverter; extra == "doc"
+Requires-Dist: jupyter-book<2.0; extra == "doc"
+Requires-Dist: numpydoc; extra == "doc"
+Requires-Dist: sphinx-argparse; extra == "doc"
+Dynamic: license-file
+
+[![Documentation](https://img.shields.io/badge/-Documentation-blue)](https://gitpages.physik.uni-wuerzburg.de/ALF/pyALF)
+[<img src="https://img.shields.io/badge/Supported%20By-UNITARY%20FUND-brightgreen.svg?style=for-the-badge" alt="drawing" width="170"/>](https://unitary.fund)
+
+## pyALF
+
+A Python package building on top of [ALF](https://github.com/ALF-QMC/ALF), meant to simplify the different steps of working with ALF, including:
+
+* Obtaining and compiling the ALF source code
+* Preparing and running simulations
+* Postprocessing and displaying the data obtained during the simulation
+
+It introduces:
+
+* The Python module `py_alf`, exposing all the package's utility to Python.
+* A set of command line tools in the folder, that make it easy to leverage pyALF from a Unix shell.
+  They are automatically exposed to the shell when pyALF is installed via pip.
+  Their source code can be found in [py_alf/cli](py_alf/cli) and documentation
+  [here](https://gitpages.physik.uni-wuerzburg.de/ALF/pyALF/source/reference/cli.html).
+* Jupyter notebooks in the folder [Notebooks](Notebooks), serving as an easy introduction to QMC and ALF.
+* Python Scripts in the folder [Scripts](Scripts) that can be run to reproduce benchmark results for established models.
+
+The **documentation** can be found [here](https://gitpages.physik.uni-wuerzburg.de/ALF/pyALF).
+
+## Installation
+
+---
+**⚠️ NOTE** In previous versions of pyALF, the installation instructions asked the users to set the environment variable `PYTHONPATH`.
+This conflicts with the newer pip package, therefore you should remove definitions of this environment variable related to pyALF.
+
+---
+
+pyALF can be installed via the Python package installer [pip](https://pip.pypa.io/en/stable/).
+
+```bash
+pip install pyALF
+```
+
+For running ALF, you will additionaly need the [ALF prerequsites](https://github.com/ALF-QMC/ALF#prerequisites).
+
+Alternatively, one could use [this Docker image](https://hub.docker.com/r/alfcollaboration/jupyter-pyalf-full), which has ALF, pyALF and a Jupyter server pre-installed.
+
+### Development installation
+
+If you want to develop pyALF, you can clone the repository and install it in
+[development mode](https://setuptools.pypa.io/en/latest/userguide/development_mode.html),
+which allows you to edit the files while using them like an installed package.
+For this, it is highly recommended to use a dedicated Python environment using e.g.
+[Python venv](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/)
+or a
+[conda environment](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html).
+The following example shows how to install pyALF in development mode using venv.
+
+```bash
+git clone https://github.com/ALF-QMC/pyALF.git
+cd pyALF
+python -m venv .venv
+source .venv/bin/activate
+
+pip install --editable .
+```
+
+## Usage
+
+There are multiple ways to use pyALF, which roughly breaks down into three approaches:
+* Using Jupyter notebooks
+* Using the command line interface
+* Use the module `py_alf` in custom scripts
+
+### Jupyter notebooks
+
+A convenient way to use pyALF is through Jupyter notebooks. They [are run](https://jupyter.readthedocs.io/en/latest/running.html) through a Jupyter server started, e.g., from the command line:
+
+```bash
+jupyter-lab
+```
+
+or
+
+```bash
+jupyter-notebook
+```
+
+which opens the "notebook dashboard" in your default browser, from where one can open the sample notebooks in [Notebooks/](Notebooks) and create new notebooks.
+
+### Command line interface
+
+pyALF also delivers a set of command line scripts, to be use from a UNIX shell. For a full list of command line scripts see [here](https://gitpages.physik.uni-wuerzburg.de/ALF/pyALF/source/reference/cli.html).
+
+Try, e.g.
+
+```bash
+alf_run -h
+```
+
+The source code for the scripts can be found in the folder [py_alf/cli/](py_alf/cli).
+
+
+### Use module `py_alf` in custom scripts
+
+Finally, one can also use the module module `py_alf` in custom Python scripts, which is analogous to the usage in Jupyter notebooks minus some interactivity.
+
+## License
+
+The various works that make up the ALF project are placed under licenses that put
+a strong emphasis on the attribution of the original authors and the sharing of the contained knowledge.
+To that end we have placed the ALF source code under the GPL version 3 license (see license.GPL and license.additional)
+and took the liberty as per GPLv3 section 7 to include additional terms that deal with the attribution
+of the original authors(see license.additional).
+The Documentation of the ALF project by the ALF contributors is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License (see Documentation/license.CCBYSA)
+We mention that we link against parts of lapack which licensed under a BSD license(see license.BSD).

{pyalf-2.5.post55 → pyalf-2.6}/pyALF.egg-info/requires.txt

@@ -10,3 +10,9 @@ scipy
 
 [GUI]
 tkinter
+
+[doc]
+sphinxcontrib-svg2pdfconverter
+jupyter-book<2.0
+numpydoc
+sphinx-argparse

{pyalf-2.5.post55 → pyalf-2.6}/py_alf/alf_source.py

@@ -40,13 +40,13 @@ class ALF_source:
         to './ALF'.
     branch : str, optional
         If specified, this will be checked out by git.
-    url : str, default='https://git.physik.uni-wuerzburg.de/ALF/ALF.git'
+    url : str, default='https://github.com/ALF-QMC/ALF.git'
         Address from where to clone ALF if alf_dir does not exist.
 
     """
 
     def __init__(self, alf_dir=None, branch=None,
-                 url='https://git.physik.uni-wuerzburg.de/ALF/ALF.git'):
+                 url='https://github.com/ALF-QMC/ALF.git'):
         if alf_dir is None:
             alf_dir = os.getenv('ALF_DIR', './ALF')
         self.alf_dir = os.path.abspath(os.path.expanduser(alf_dir))

{pyalf-2.5.post55 → pyalf-2.6}/py_alf/check_common.py

@@ -39,7 +39,7 @@ def _get_bins(directory, names, custom_obs):
 
             dtype, shape = custom_obs_get_dtype_shape(obs_spec, bins_raw)
             del dtype
-            size = np.prod(shape)
+            size = 1 if not shape else np.prod(shape)
             bins = np.empty((N_bins, size))
 
             for i in range(N_bins):

{pyalf-2.5.post55 → pyalf-2.6}/py_alf/cli/alf_test_branch.py

@@ -70,7 +70,7 @@ def _analyze(sim_R, sim_T):
                 with contextlib.suppress(TypeError):
                     test_temp = np.allclose(dat_R, dat_T)
                 test = test and test_temp
-            f.write('{name}: {test}\n')
+            f.write(f'{name}: {test}\n')
             test_all = test_all and test
 
     return test_all

{pyalf-2.5.post55 → pyalf-2.6}/py_alf/cli/minimal_ALF_run.py

@@ -15,7 +15,7 @@ from py_alf import ALF_source, Simulation
 
 def _main():
     # Create an instance of ALF_source, downloading the ALF source code from
-    # https://git.physik.uni-wuerzburg.de/ALF/ALF, if ALF diretory does not exist.
+    # https://github.com/ALF-QMC/ALF, if ALF diretory does not exist.
     # Gets ALF diretory from environment variable $ALF_DIR, or defaults to "./ALF",
     # if not present.
     alf_src = ALF_source()

{pyalf-2.5.post55 → pyalf-2.6}/py_alf/simulation.py

@@ -466,7 +466,7 @@ def getenv(config, alf_dir='.'):
 def compile_alf(alf_dir=None,
                 branch=None,
                 config='GNU noMPI',
-                url='https://git.physik.uni-wuerzburg.de/ALF/ALF.git',
+                url='https://github.com/ALF-QMC/ALF.git',
                 verbosity=0
                 ):
     """Compile ALF. Clone a new repository if alf_dir does not exist.
@@ -482,7 +482,7 @@ def compile_alf(alf_dir=None,
         If specified, this will be checked out by git.
     config : str, default='GNU noMPI'
         Arguments for `configure.sh`.
-    url : str, default='https://git.physik.uni-wuerzburg.de/ALF/ALF.git'
+    url : str, default='https://github.com/ALF-QMC/ALF.git'
         Address from where to clone ALF if alf_dir not exists.
     verbosity : int, default=0
         0: Don't echo make reciepes.

{pyalf-2.5.post55 → pyalf-2.6}/pyproject.toml

@@ -17,12 +17,12 @@ authors = [
   { name="Jonas Schwab", email="jonas.schwab@uni-wuerzburg.de" },
 ]
 description = "Python interface for ALF, plus scripts and Jupyter notebooks."
-license = {file = "LICENSE"}
+license = "GPL-2.0-or-later"
+license-files = ['LICENSE']
 readme = "README.md"
 requires-python = ">=3.7"
 classifiers = [
     "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)",
     "Operating System :: OS Independent",
 ]
 dependencies = [
@@ -39,14 +39,20 @@ dependencies = [
 
 [project.optional-dependencies]
 GUI = ["tkinter"]
+doc = [
+  "sphinxcontrib-svg2pdfconverter",
+  "jupyter-book<2.0",
+  "numpydoc",
+  "sphinx-argparse",
+]
 
 [tool.setuptools.packages.find]
 include = ["py_alf", "py_alf.cli"]
 
 [project.urls]
-Documentation = "https://gitpages.physik.uni-wuerzburg.de/ALF/pyALF"
-Repository = "https://git.physik.uni-wuerzburg.de/ALF/pyALF"
-Issues = "https://git.physik.uni-wuerzburg.de/ALF/pyALF/-/issues"
+Documentation = "https://alf.physik.uni-wuerzburg.de/pyalf-doc/"
+Repository = "https://github.com/ALF-QMC/pyALF"
+Issues = "https://github.com/ALF-QMC/pyALF/issues"
 "ALF Homepage" = "https://alf.physik.uni-wuerzburg.de/"
 
 [project.scripts]