empix 0.0.3__tar.gz → 0.0.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. empix-0.0.5/PKG-INFO +170 -0
  2. empix-0.0.5/README.md +127 -0
  3. {empix-0.0.3 → empix-0.0.5}/docs/INSTALL.rst +37 -27
  4. {empix-0.0.3 → empix-0.0.5}/docs/index.rst +19 -8
  5. empix-0.0.5/empix/version.py +34 -0
  6. empix-0.0.5/empix.egg-info/PKG-INFO +170 -0
  7. {empix-0.0.3 → empix-0.0.5}/empix.egg-info/SOURCES.txt +2 -0
  8. {empix-0.0.3 → empix-0.0.5}/empix.egg-info/requires.txt +2 -1
  9. {empix-0.0.3 → empix-0.0.5}/examples/basic_usage.ipynb +96 -328
  10. empix-0.0.5/examples/helpers_for_basic_usage.py +359 -0
  11. {empix-0.0.3 → empix-0.0.5}/pyproject.toml +3 -2
  12. empix-0.0.5/run_tests.sh +34 -0
  13. empix-0.0.3/PKG-INFO +0 -61
  14. empix-0.0.3/README.md +0 -20
  15. empix-0.0.3/empix/version.py +0 -16
  16. empix-0.0.3/empix.egg-info/PKG-INFO +0 -61
  17. {empix-0.0.3 → empix-0.0.5}/.coveragerc +0 -0
  18. {empix-0.0.3 → empix-0.0.5}/.github/workflows/measure_code_coverage.yml +0 -0
  19. {empix-0.0.3 → empix-0.0.5}/.github/workflows/publish_documentation_website.yml +0 -0
  20. {empix-0.0.3 → empix-0.0.5}/.github/workflows/publish_release_to_pypi.yml +0 -0
  21. {empix-0.0.3 → empix-0.0.5}/.github/workflows/test_library.yml +0 -0
  22. {empix-0.0.3 → empix-0.0.5}/.gitignore +0 -0
  23. {empix-0.0.3 → empix-0.0.5}/LICENSE +0 -0
  24. {empix-0.0.3 → empix-0.0.5}/docs/Makefile +0 -0
  25. {empix-0.0.3 → empix-0.0.5}/docs/_static/readthedocs_custom.css +0 -0
  26. {empix-0.0.3 → empix-0.0.5}/docs/_templates/custom_class_template.rst +0 -0
  27. {empix-0.0.3 → empix-0.0.5}/docs/_templates/custom_module_template.rst +0 -0
  28. {empix-0.0.3 → empix-0.0.5}/docs/_templates/versions.html +0 -0
  29. {empix-0.0.3 → empix-0.0.5}/docs/api.rst +0 -0
  30. {empix-0.0.3 → empix-0.0.5}/docs/build_docs.py +0 -0
  31. {empix-0.0.3 → empix-0.0.5}/docs/conf.py +0 -0
  32. {empix-0.0.3 → empix-0.0.5}/docs/examples.rst +0 -0
  33. {empix-0.0.3 → empix-0.0.5}/docs/license.rst +0 -0
  34. {empix-0.0.3 → empix-0.0.5}/docs/make.bat +0 -0
  35. {empix-0.0.3 → empix-0.0.5}/docs/private_members_to_publish_to_docs.rst +0 -0
  36. {empix-0.0.3 → empix-0.0.5}/empix/__init__.py +0 -0
  37. {empix-0.0.3 → empix-0.0.5}/empix.egg-info/dependency_links.txt +0 -0
  38. {empix-0.0.3 → empix-0.0.5}/empix.egg-info/top_level.txt +0 -0
  39. {empix-0.0.3 → empix-0.0.5}/setup.cfg +0 -0
  40. {empix-0.0.3 → empix-0.0.5}/setup.py +0 -0
  41. {empix-0.0.3 → empix-0.0.5}/tests/test_root.py +0 -0
  42. {empix-0.0.3 → empix-0.0.5}/tox.ini +0 -0
empix-0.0.5/PKG-INFO ADDED
@@ -0,0 +1,170 @@
1
+ Metadata-Version: 2.4
2
+ Name: empix
3
+ Version: 0.0.5
4
+ Summary: Contains tools for analyzing electron microscopy data that are not available in ``hyperspy``.
5
+ Author-email: Matthew Fitzpatrick <matthew.rc.fitzpatrick@gmail.com>
6
+ Project-URL: Homepage, https://mrfitzpa.github.io/empix
7
+ Project-URL: Repository, https://github.com/mrfitzpa/empix
8
+ Keywords: hyperspy,microscopy,cropping,downsampling,resampling,azimuthal integration,annular integration
9
+ Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
10
+ Classifier: Development Status :: 5 - Production/Stable
11
+ Classifier: Intended Audience :: Science/Research
12
+ Classifier: Programming Language :: Python
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.8
15
+ Classifier: Programming Language :: Python :: 3.9
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Operating System :: OS Independent
20
+ Classifier: Natural Language :: English
21
+ Requires-Python: >=3.8
22
+ Description-Content-Type: text/markdown
23
+ License-File: LICENSE
24
+ Requires-Dist: czekitout
25
+ Requires-Dist: fancytypes>=1.0.0
26
+ Requires-Dist: hyperspy
27
+ Requires-Dist: pyFAI
28
+ Requires-Dist: numba
29
+ Provides-Extra: tests
30
+ Requires-Dist: pytest-cov; extra == "tests"
31
+ Provides-Extra: examples
32
+ Requires-Dist: jupyter; extra == "examples"
33
+ Requires-Dist: ipympl; extra == "examples"
34
+ Provides-Extra: docs
35
+ Requires-Dist: sphinx<7; extra == "docs"
36
+ Requires-Dist: sphinx_rtd_theme; extra == "docs"
37
+ Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
38
+ Requires-Dist: numpydoc; extra == "docs"
39
+ Requires-Dist: docutils; extra == "docs"
40
+ Provides-Extra: all
41
+ Requires-Dist: empix[docs,examples,tests]; extra == "all"
42
+ Dynamic: license-file
43
+
44
+ # Electron Microscopy Pix (EMPix)
45
+
46
+ [![Test library](https://github.com/mrfitzpa/empix/actions/workflows/test_library.yml/badge.svg)](https://github.com/mrfitzpa/empix/actions/workflows/test_library.yml)
47
+ [![Code Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/mrfitzpa/b7ef7892a2b5cf21ba4b6163c324afbe/raw/empix_coverage_badge.json)](https://github.com/mrfitzpa/empix/actions/workflows/measure_code_coverage.yml)
48
+ [![Documentation](https://img.shields.io/badge/docs-read-brightgreen)](https://mrfitzpa.github.io/empix)
49
+ [![PyPi Version](https://img.shields.io/pypi/v/empix.svg)](https://pypi.org/project/empix)
50
+ [![Conda-Forge Version](https://img.shields.io/conda/vn/conda-forge/empix.svg)](https://anaconda.org/conda-forge/empix)
51
+ [![License](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
52
+
53
+ `empix` is a Python library that contains tools for analyzing electron
54
+ microscopy data that are not available in
55
+ [`hyperspy`](https://hyperspy.org/hyperspy-doc/current/index.html).
56
+
57
+ Visit the [`empix` website](https://mrfitzpa.github.io/empix) for a web version
58
+ of the installation instructions, the reference guide, and the examples archive.
59
+
60
+ The source code can be found in the [`empix` GitHub
61
+ repository](https://github.com/mrfitzpa/empix).
62
+
63
+
64
+
65
+ ## Table of contents
66
+
67
+ - [Instructions for installing and uninstalling
68
+ `empix`](#instructions-for-installing-and-uninstalling-empix)
69
+ - [Installing `empix`](#installing-empix)
70
+ - [Installing `empix` using
71
+ `pip`](#installing-empix-using-pip)
72
+ - [Installing `empix` using
73
+ `conda`](#installing-empix-using-conda)
74
+ - [Uninstalling `empix`](#uninstalling-empix)
75
+ - [Learning how to use `empix`](#learning-how-to-use-empix)
76
+
77
+
78
+
79
+ ## Instructions for installing and uninstalling `empix`
80
+
81
+
82
+
83
+ ### Installing `empix`
84
+
85
+ For all installation scenarios, first open up the appropriate command line
86
+ interface. On Unix-based systems, you could open e.g. a terminal. On Windows
87
+ systems you could open e.g. an Anaconda Prompt as an administrator.
88
+
89
+
90
+
91
+ #### Installing `empix` using `pip`
92
+
93
+ Before installing `empix`, make sure that you have activated the (virtual)
94
+ environment in which you intend to install said package. After which, simply
95
+ change into the root of the repository, and run the following command:
96
+
97
+ pip install empix
98
+
99
+ The above command will install the latest stable version of `empix`.
100
+
101
+ To install the latest development version from the main branch of the [empix
102
+ GitHub repository](https://github.com/mrfitzpa/empix), one must first clone the
103
+ repository by running the following command:
104
+
105
+ git clone https://github.com/mrfitzpa/empix.git
106
+
107
+ Next, change into the root of the cloned repository, and then run the following
108
+ command:
109
+
110
+ pip install .
111
+
112
+ Note that you must include the period as well. The above command executes a
113
+ standard installation of `empix`.
114
+
115
+ Optionally, for additional features in `empix`, one can install additional
116
+ dependencies upon installing `empix`. To install a subset of additional
117
+ dependencies (along with the standard installation), run the following command
118
+ from the root of the repository:
119
+
120
+ pip install .[<selector>]
121
+
122
+ where `<selector>` can be one of the following:
123
+
124
+ * `tests`: to install the dependencies necessary for running unit tests;
125
+ * `examples`: to install the dependencies necessary for executing files stored
126
+ in `<root>/examples`, where `<root>` is the root of the repository;
127
+ * `docs`: to install the dependencies necessary for documentation generation;
128
+ * `all`: to install all of the above optional dependencies.
129
+
130
+ Alternatively, one can run:
131
+
132
+ pip install empix[<selector>]
133
+
134
+ elsewhere in order to install the latest stable version of `empix`, along with
135
+ the subset of additional dependencies specified by `<selector>`.
136
+
137
+
138
+
139
+ #### Installing `empix` using `conda`
140
+
141
+ To install `empix` using the `conda` package manager, run the following command:
142
+
143
+ conda install -c conda-forge empix
144
+
145
+ The above command will install the latest stable version of `empix`.
146
+
147
+
148
+
149
+ ### Uninstalling `empix`
150
+
151
+ If `empix` was installed using `pip`, then to uninstall, run the following
152
+ command from the root of the repository:
153
+
154
+ pip uninstall empix
155
+
156
+ If `empix` was installed using `conda`, then to uninstall, run the
157
+ following command from the root of the repository:
158
+
159
+ conda remove empix
160
+
161
+
162
+
163
+ ## Learning how to use `empix`
164
+
165
+ For those new to the `empix` library, it is recommended that they take a look at
166
+ the [Examples](https://mrfitzpa.github.io/empix/examples.html) page, which
167
+ contain code examples that show how one can use the `empix` library. While going
168
+ through the examples, readers can consult the [empix reference
169
+ guide](https://mrfitzpa.github.io/empix/_autosummary/empix.html) to understand
170
+ what each line of code is doing.
empix-0.0.5/README.md ADDED
@@ -0,0 +1,127 @@
1
+ # Electron Microscopy Pix (EMPix)
2
+
3
+ [![Test library](https://github.com/mrfitzpa/empix/actions/workflows/test_library.yml/badge.svg)](https://github.com/mrfitzpa/empix/actions/workflows/test_library.yml)
4
+ [![Code Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/mrfitzpa/b7ef7892a2b5cf21ba4b6163c324afbe/raw/empix_coverage_badge.json)](https://github.com/mrfitzpa/empix/actions/workflows/measure_code_coverage.yml)
5
+ [![Documentation](https://img.shields.io/badge/docs-read-brightgreen)](https://mrfitzpa.github.io/empix)
6
+ [![PyPi Version](https://img.shields.io/pypi/v/empix.svg)](https://pypi.org/project/empix)
7
+ [![Conda-Forge Version](https://img.shields.io/conda/vn/conda-forge/empix.svg)](https://anaconda.org/conda-forge/empix)
8
+ [![License](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
9
+
10
+ `empix` is a Python library that contains tools for analyzing electron
11
+ microscopy data that are not available in
12
+ [`hyperspy`](https://hyperspy.org/hyperspy-doc/current/index.html).
13
+
14
+ Visit the [`empix` website](https://mrfitzpa.github.io/empix) for a web version
15
+ of the installation instructions, the reference guide, and the examples archive.
16
+
17
+ The source code can be found in the [`empix` GitHub
18
+ repository](https://github.com/mrfitzpa/empix).
19
+
20
+
21
+
22
+ ## Table of contents
23
+
24
+ - [Instructions for installing and uninstalling
25
+ `empix`](#instructions-for-installing-and-uninstalling-empix)
26
+ - [Installing `empix`](#installing-empix)
27
+ - [Installing `empix` using
28
+ `pip`](#installing-empix-using-pip)
29
+ - [Installing `empix` using
30
+ `conda`](#installing-empix-using-conda)
31
+ - [Uninstalling `empix`](#uninstalling-empix)
32
+ - [Learning how to use `empix`](#learning-how-to-use-empix)
33
+
34
+
35
+
36
+ ## Instructions for installing and uninstalling `empix`
37
+
38
+
39
+
40
+ ### Installing `empix`
41
+
42
+ For all installation scenarios, first open up the appropriate command line
43
+ interface. On Unix-based systems, you could open e.g. a terminal. On Windows
44
+ systems you could open e.g. an Anaconda Prompt as an administrator.
45
+
46
+
47
+
48
+ #### Installing `empix` using `pip`
49
+
50
+ Before installing `empix`, make sure that you have activated the (virtual)
51
+ environment in which you intend to install said package. After which, simply
52
+ change into the root of the repository, and run the following command:
53
+
54
+ pip install empix
55
+
56
+ The above command will install the latest stable version of `empix`.
57
+
58
+ To install the latest development version from the main branch of the [empix
59
+ GitHub repository](https://github.com/mrfitzpa/empix), one must first clone the
60
+ repository by running the following command:
61
+
62
+ git clone https://github.com/mrfitzpa/empix.git
63
+
64
+ Next, change into the root of the cloned repository, and then run the following
65
+ command:
66
+
67
+ pip install .
68
+
69
+ Note that you must include the period as well. The above command executes a
70
+ standard installation of `empix`.
71
+
72
+ Optionally, for additional features in `empix`, one can install additional
73
+ dependencies upon installing `empix`. To install a subset of additional
74
+ dependencies (along with the standard installation), run the following command
75
+ from the root of the repository:
76
+
77
+ pip install .[<selector>]
78
+
79
+ where `<selector>` can be one of the following:
80
+
81
+ * `tests`: to install the dependencies necessary for running unit tests;
82
+ * `examples`: to install the dependencies necessary for executing files stored
83
+ in `<root>/examples`, where `<root>` is the root of the repository;
84
+ * `docs`: to install the dependencies necessary for documentation generation;
85
+ * `all`: to install all of the above optional dependencies.
86
+
87
+ Alternatively, one can run:
88
+
89
+ pip install empix[<selector>]
90
+
91
+ elsewhere in order to install the latest stable version of `empix`, along with
92
+ the subset of additional dependencies specified by `<selector>`.
93
+
94
+
95
+
96
+ #### Installing `empix` using `conda`
97
+
98
+ To install `empix` using the `conda` package manager, run the following command:
99
+
100
+ conda install -c conda-forge empix
101
+
102
+ The above command will install the latest stable version of `empix`.
103
+
104
+
105
+
106
+ ### Uninstalling `empix`
107
+
108
+ If `empix` was installed using `pip`, then to uninstall, run the following
109
+ command from the root of the repository:
110
+
111
+ pip uninstall empix
112
+
113
+ If `empix` was installed using `conda`, then to uninstall, run the
114
+ following command from the root of the repository:
115
+
116
+ conda remove empix
117
+
118
+
119
+
120
+ ## Learning how to use `empix`
121
+
122
+ For those new to the `empix` library, it is recommended that they take a look at
123
+ the [Examples](https://mrfitzpa.github.io/empix/examples.html) page, which
124
+ contain code examples that show how one can use the `empix` library. While going
125
+ through the examples, readers can consult the [empix reference
126
+ guide](https://mrfitzpa.github.io/empix/_autosummary/empix.html) to understand
127
+ what each line of code is doing.
@@ -1,28 +1,28 @@
1
1
  .. _installation_instructions_sec:
2
2
 
3
- Installation instructions
4
- =========================
5
-
6
- Installing empix
7
- ----------------
3
+ Instructions for installing and uninstalling ``empix``
4
+ ======================================================
8
5
 
9
6
  For all installation scenarios, first open up the appropriate command line
10
- interface. On Unix-based systems, you would open a terminal. On Windows systems
11
- you would open an Anaconda Prompt as an administrator.
7
+ interface. On Unix-based systems, you could open e.g. a terminal. On Windows
8
+ systems you could open e.g. an Anaconda Prompt as an administrator.
12
9
 
13
- Installing empix using pip
14
- ~~~~~~~~~~~~~~~~~~~~~~~~~~
15
10
 
16
- The easiest way to install ``empix`` using ``pip`` is to run the following
17
- command::
11
+
12
+ Installing ``empix`` using ``pip``
13
+ ----------------------------------
14
+
15
+ Before installing ``empix``, make sure that you have activated the (virtual)
16
+ environment in which you intend to install said package. After which, simply
17
+ change into the root of the repository, and run the following command::
18
18
 
19
19
  pip install empix
20
20
 
21
21
  The above command will install the latest stable version of ``empix``.
22
22
 
23
- To install the latest development version from the main branch of the
24
- `empix GitHub repository <https://github.com/mrfitzpa/empix>`_,
25
- one must first clone the repository by running the following command::
23
+ To install the latest development version from the main branch of the `empix
24
+ GitHub repository <https://github.com/mrfitzpa/empix>`_, one must first clone
25
+ the repository by running the following command::
26
26
 
27
27
  git clone https://github.com/mrfitzpa/empix.git
28
28
 
@@ -44,31 +44,41 @@ from the root of the repository::
44
44
  where ``<selector>`` can be one of the following:
45
45
 
46
46
  * ``tests``: to install the dependencies necessary for running unit tests;
47
- * ``examples``: to install the dependencies necessary for running the jupyter
48
- notebooks stored in ``<root>/examples``, where ``<root>`` is the root of the
49
- repository;
47
+ * ``examples``: to install the dependencies necessary for executing files stored
48
+ in ``<root>/examples``, where ``<root>`` is the root of the repository;
50
49
  * ``docs``: to install the dependencies necessary for documentation generation;
51
50
  * ``all``: to install all of the above optional dependencies.
52
51
 
53
- Installing empix using conda
54
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
52
+ Alternatively, one can run::
55
53
 
56
- To install ``empix`` using the ``conda`` package manager, run the following
57
- command::
54
+ pip install empix[<selector>]
55
+
56
+ elsewhere in order to install the latest stable version of ``empix``, along with
57
+ the subset of additional dependencies specified by ``<selector>``.
58
+
59
+
60
+
61
+ Installing ``empix`` using ``conda``
62
+ ------------------------------------
63
+
64
+ To install ``empix`` using the ``conda`` package manager, run the
65
+ following command::
58
66
 
59
67
  conda install -c conda-forge empix
60
68
 
61
69
  The above command will install the latest stable version of ``empix``.
62
70
 
63
- Uninstalling empix
64
- ------------------
65
71
 
66
- If ``empix`` was installed using ``pip``, then to uninstall, run the following
67
- command from the root of the repository::
72
+
73
+ Uninstalling ``empix``
74
+ ----------------------
75
+
76
+ If ``empix`` was installed using ``pip``, then to uninstall, run the
77
+ following command from the root of the repository::
68
78
 
69
79
  pip uninstall empix
70
80
 
71
- If ``empix`` was installed using ``conda``, then to uninstall, run the following
72
- command from the root of the repository::
81
+ If ``empix`` was installed using ``conda``, then to uninstall, run the
82
+ following command from the root of the repository::
73
83
 
74
84
  conda remove empix
@@ -1,19 +1,25 @@
1
- empix
2
- =====
1
+ Electron Microscopy Pix (EMPix)
2
+ ===============================
3
3
 
4
4
  ``empix`` is a Python library that contains tools for analyzing electron
5
- microscopy data that are not available in hyperspy_.
5
+ microscopy data that are not available in `hyperspy
6
+ <https://hyperspy.org/hyperspy-doc/current/index.html>`_.
6
7
 
7
- .. _hyperspy: https://hyperspy.org/hyperspy-doc/current/index.html
8
+ The source code can be found in the `empix GitHub repository
9
+ <https://github.com/mrfitzpa/empix>`_.
8
10
 
9
- Setting up empix
10
- ----------------
11
+
12
+
13
+ Instructions for installing and uninstalling ``empix``
14
+ ------------------------------------------------------
11
15
 
12
16
  For instructions on installing the ``empix`` library, see the
13
17
  :ref:`installation_instructions_sec` page.
14
18
 
15
- Learning how to use empix
16
- -------------------------
19
+
20
+
21
+ Learning how to use ``empix``
22
+ -----------------------------
17
23
 
18
24
  For those new to the ``empix`` library, it is recommended that they take a look
19
25
  at the :ref:`examples_sec` page, which contain code examples that show how one
@@ -21,8 +27,11 @@ can use the ``empix`` library. While going through the examples, readers can
21
27
  consult the :ref:`reference_guide_sec` to understand what each line of code is
22
28
  doing.
23
29
 
30
+
31
+
24
32
  Contents
25
33
  --------
34
+
26
35
  .. toctree::
27
36
  :maxdepth: 6
28
37
  :numbered:
@@ -33,6 +42,8 @@ Contents
33
42
  examples
34
43
  license
35
44
 
45
+
46
+
36
47
  Indices and tables
37
48
  ==================
38
49
 
@@ -0,0 +1,34 @@
1
+ # file generated by setuptools-scm
2
+ # don't change, don't track in version control
3
+
4
+ __all__ = [
5
+ "__version__",
6
+ "__version_tuple__",
7
+ "version",
8
+ "version_tuple",
9
+ "__commit_id__",
10
+ "commit_id",
11
+ ]
12
+
13
+ TYPE_CHECKING = False
14
+ if TYPE_CHECKING:
15
+ from typing import Tuple
16
+ from typing import Union
17
+
18
+ VERSION_TUPLE = Tuple[Union[int, str], ...]
19
+ COMMIT_ID = Union[str, None]
20
+ else:
21
+ VERSION_TUPLE = object
22
+ COMMIT_ID = object
23
+
24
+ version: str
25
+ __version__: str
26
+ __version_tuple__: VERSION_TUPLE
27
+ version_tuple: VERSION_TUPLE
28
+ commit_id: COMMIT_ID
29
+ __commit_id__: COMMIT_ID
30
+
31
+ __version__ = version = '0.0.5'
32
+ __version_tuple__ = version_tuple = (0, 0, 5)
33
+
34
+ __commit_id__ = commit_id = 'g1e6933cb8'
@@ -0,0 +1,170 @@
1
+ Metadata-Version: 2.4
2
+ Name: empix
3
+ Version: 0.0.5
4
+ Summary: Contains tools for analyzing electron microscopy data that are not available in ``hyperspy``.
5
+ Author-email: Matthew Fitzpatrick <matthew.rc.fitzpatrick@gmail.com>
6
+ Project-URL: Homepage, https://mrfitzpa.github.io/empix
7
+ Project-URL: Repository, https://github.com/mrfitzpa/empix
8
+ Keywords: hyperspy,microscopy,cropping,downsampling,resampling,azimuthal integration,annular integration
9
+ Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
10
+ Classifier: Development Status :: 5 - Production/Stable
11
+ Classifier: Intended Audience :: Science/Research
12
+ Classifier: Programming Language :: Python
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.8
15
+ Classifier: Programming Language :: Python :: 3.9
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Operating System :: OS Independent
20
+ Classifier: Natural Language :: English
21
+ Requires-Python: >=3.8
22
+ Description-Content-Type: text/markdown
23
+ License-File: LICENSE
24
+ Requires-Dist: czekitout
25
+ Requires-Dist: fancytypes>=1.0.0
26
+ Requires-Dist: hyperspy
27
+ Requires-Dist: pyFAI
28
+ Requires-Dist: numba
29
+ Provides-Extra: tests
30
+ Requires-Dist: pytest-cov; extra == "tests"
31
+ Provides-Extra: examples
32
+ Requires-Dist: jupyter; extra == "examples"
33
+ Requires-Dist: ipympl; extra == "examples"
34
+ Provides-Extra: docs
35
+ Requires-Dist: sphinx<7; extra == "docs"
36
+ Requires-Dist: sphinx_rtd_theme; extra == "docs"
37
+ Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
38
+ Requires-Dist: numpydoc; extra == "docs"
39
+ Requires-Dist: docutils; extra == "docs"
40
+ Provides-Extra: all
41
+ Requires-Dist: empix[docs,examples,tests]; extra == "all"
42
+ Dynamic: license-file
43
+
44
+ # Electron Microscopy Pix (EMPix)
45
+
46
+ [![Test library](https://github.com/mrfitzpa/empix/actions/workflows/test_library.yml/badge.svg)](https://github.com/mrfitzpa/empix/actions/workflows/test_library.yml)
47
+ [![Code Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/mrfitzpa/b7ef7892a2b5cf21ba4b6163c324afbe/raw/empix_coverage_badge.json)](https://github.com/mrfitzpa/empix/actions/workflows/measure_code_coverage.yml)
48
+ [![Documentation](https://img.shields.io/badge/docs-read-brightgreen)](https://mrfitzpa.github.io/empix)
49
+ [![PyPi Version](https://img.shields.io/pypi/v/empix.svg)](https://pypi.org/project/empix)
50
+ [![Conda-Forge Version](https://img.shields.io/conda/vn/conda-forge/empix.svg)](https://anaconda.org/conda-forge/empix)
51
+ [![License](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
52
+
53
+ `empix` is a Python library that contains tools for analyzing electron
54
+ microscopy data that are not available in
55
+ [`hyperspy`](https://hyperspy.org/hyperspy-doc/current/index.html).
56
+
57
+ Visit the [`empix` website](https://mrfitzpa.github.io/empix) for a web version
58
+ of the installation instructions, the reference guide, and the examples archive.
59
+
60
+ The source code can be found in the [`empix` GitHub
61
+ repository](https://github.com/mrfitzpa/empix).
62
+
63
+
64
+
65
+ ## Table of contents
66
+
67
+ - [Instructions for installing and uninstalling
68
+ `empix`](#instructions-for-installing-and-uninstalling-empix)
69
+ - [Installing `empix`](#installing-empix)
70
+ - [Installing `empix` using
71
+ `pip`](#installing-empix-using-pip)
72
+ - [Installing `empix` using
73
+ `conda`](#installing-empix-using-conda)
74
+ - [Uninstalling `empix`](#uninstalling-empix)
75
+ - [Learning how to use `empix`](#learning-how-to-use-empix)
76
+
77
+
78
+
79
+ ## Instructions for installing and uninstalling `empix`
80
+
81
+
82
+
83
+ ### Installing `empix`
84
+
85
+ For all installation scenarios, first open up the appropriate command line
86
+ interface. On Unix-based systems, you could open e.g. a terminal. On Windows
87
+ systems you could open e.g. an Anaconda Prompt as an administrator.
88
+
89
+
90
+
91
+ #### Installing `empix` using `pip`
92
+
93
+ Before installing `empix`, make sure that you have activated the (virtual)
94
+ environment in which you intend to install said package. After which, simply
95
+ change into the root of the repository, and run the following command:
96
+
97
+ pip install empix
98
+
99
+ The above command will install the latest stable version of `empix`.
100
+
101
+ To install the latest development version from the main branch of the [empix
102
+ GitHub repository](https://github.com/mrfitzpa/empix), one must first clone the
103
+ repository by running the following command:
104
+
105
+ git clone https://github.com/mrfitzpa/empix.git
106
+
107
+ Next, change into the root of the cloned repository, and then run the following
108
+ command:
109
+
110
+ pip install .
111
+
112
+ Note that you must include the period as well. The above command executes a
113
+ standard installation of `empix`.
114
+
115
+ Optionally, for additional features in `empix`, one can install additional
116
+ dependencies upon installing `empix`. To install a subset of additional
117
+ dependencies (along with the standard installation), run the following command
118
+ from the root of the repository:
119
+
120
+ pip install .[<selector>]
121
+
122
+ where `<selector>` can be one of the following:
123
+
124
+ * `tests`: to install the dependencies necessary for running unit tests;
125
+ * `examples`: to install the dependencies necessary for executing files stored
126
+ in `<root>/examples`, where `<root>` is the root of the repository;
127
+ * `docs`: to install the dependencies necessary for documentation generation;
128
+ * `all`: to install all of the above optional dependencies.
129
+
130
+ Alternatively, one can run:
131
+
132
+ pip install empix[<selector>]
133
+
134
+ elsewhere in order to install the latest stable version of `empix`, along with
135
+ the subset of additional dependencies specified by `<selector>`.
136
+
137
+
138
+
139
+ #### Installing `empix` using `conda`
140
+
141
+ To install `empix` using the `conda` package manager, run the following command:
142
+
143
+ conda install -c conda-forge empix
144
+
145
+ The above command will install the latest stable version of `empix`.
146
+
147
+
148
+
149
+ ### Uninstalling `empix`
150
+
151
+ If `empix` was installed using `pip`, then to uninstall, run the following
152
+ command from the root of the repository:
153
+
154
+ pip uninstall empix
155
+
156
+ If `empix` was installed using `conda`, then to uninstall, run the
157
+ following command from the root of the repository:
158
+
159
+ conda remove empix
160
+
161
+
162
+
163
+ ## Learning how to use `empix`
164
+
165
+ For those new to the `empix` library, it is recommended that they take a look at
166
+ the [Examples](https://mrfitzpa.github.io/empix/examples.html) page, which
167
+ contain code examples that show how one can use the `empix` library. While going
168
+ through the examples, readers can consult the [empix reference
169
+ guide](https://mrfitzpa.github.io/empix/_autosummary/empix.html) to understand
170
+ what each line of code is doing.
@@ -3,6 +3,7 @@
3
3
  LICENSE
4
4
  README.md
5
5
  pyproject.toml
6
+ run_tests.sh
6
7
  setup.py
7
8
  tox.ini
8
9
  .github/workflows/measure_code_coverage.yml
@@ -31,4 +32,5 @@ empix.egg-info/dependency_links.txt
31
32
  empix.egg-info/requires.txt
32
33
  empix.egg-info/top_level.txt
33
34
  examples/basic_usage.ipynb
35
+ examples/helpers_for_basic_usage.py
34
36
  tests/test_root.py
@@ -1,7 +1,8 @@
1
1
  czekitout
2
2
  fancytypes>=1.0.0
3
- hyperspy[all]
3
+ hyperspy
4
4
  pyFAI
5
+ numba
5
6
 
6
7
  [all]
7
8
  empix[docs,examples,tests]