sem2surface 0.2.0__tar.gz → 0.2.1__tar.gz

{sem2surface-0.2.0/src/sem2surface.egg-info → sem2surface-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sem2surface
-Version: 0.2.0
+Version: 0.2.1
 Summary: 3D surface reconstruction from multi-detector SEM/BSE images
 Author: Vladislav A. Yastrebov
 License-Expression: BSD-3-Clause
@@ -39,6 +39,9 @@ Dynamic: license-file
 
 # sem2surface
 
+[![PyPI version](https://img.shields.io/pypi/v/sem2surface.svg)](https://pypi.org/project/sem2surface/)
+[![License: BSD 3-Clause](https://img.shields.io/pypi/l/sem2surface.svg)](https://github.com/vyastreb/sem2surface/blob/master/LICENSE)
+
 `sem2surface` reconstructs a three-dimensional surface from three to five
 multi-detector SEM/BSE images. It extracts two normalized principal images,
 identifies their orientation with a Radon transform, and integrates the resulting
@@ -54,78 +57,49 @@ calibration procedure.
 
 ## Installation
 
-Python 3.10 or newer is required. An isolated virtual environment is strongly
-recommended so the application does not conflict with system Python packages.
-
-### Linux and macOS
-
-Create an environment and install a released version:
+Python 3.10 or newer is required. Install `sem2surface` from PyPI with:
 
 ```bash
-python3 -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-python -m pip install sem2surface
-sem2surface-gui
+pip install sem2surface
 ```
 
-Until a release is uploaded to PyPI, run the final installation command from
-this source checkout instead:
+If several Python installations are present, use the interpreter explicitly:
 
 ```bash
-python -m pip install .
+python3 -m pip install sem2surface  # Linux or macOS
 ```
 
-On Linux, Tkinter may be packaged separately. For example, Ubuntu and Debian
-users can install it with their system package manager as `python3-tk` before
-creating the environment.
-
 ### Windows
 
 Install Python 3.10 or newer from
 [python.org](https://www.python.org/downloads/windows/). Keep the standard
-`pip`, Tcl/Tk, and Python Launcher components enabled. Then open PowerShell in
-the folder where you want the environment and run:
+`pip`, Tcl/Tk, and Python Launcher components enabled. Then open PowerShell or
+Command Prompt and run:
 
 ```powershell
-py -3 -m venv .venv
-.\.venv\Scripts\Activate.ps1
-python -m pip install --upgrade pip
-python -m pip install sem2surface
+py -m pip install sem2surface
 sem2surface-gui
 ```
 
-If PowerShell blocks the activation script, allow it only for the current
-PowerShell process and retry activation:
+If Windows cannot find the installed launcher, start the GUI through Python:
 
 ```powershell
-Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
-.\.venv\Scripts\Activate.ps1
-```
-
-In Command Prompt, activate the same environment with:
-
-```bat
-.venv\Scripts\activate.bat
+py -m sem2surface_gui
 ```
 
-Activation is optional. The GUI can always be launched directly:
-
-```powershell
-.\.venv\Scripts\sem2surface-gui.exe
-```
+On Linux, Tkinter may be packaged separately. For example, Ubuntu and Debian
+users can install `python3-tk` with their system package manager.
 
-Before the PyPI release, install either from a source checkout with
-`python -m pip install .` or from the provided wheel:
+A virtual environment is optional. It is useful when the system Python is
+externally managed, installation permissions are restricted, or other packages
+have conflicting dependencies:
 
-```powershell
-python -m pip install "C:\path\to\sem2surface-0.2.0-py3-none-any.whl"
+```bash
+python3 -m venv .venv
+source .venv/bin/activate  # Windows PowerShell: .\.venv\Scripts\Activate.ps1
+python -m pip install sem2surface
 ```
 
-Use `deactivate` to leave the environment on any platform. Do not copy a
-virtual environment between computers or move it after creation; create a new
-one and reinstall the package instead.
-
 VTK export is optional because VTK is a large dependency:
 
 ```bash
@@ -266,7 +240,7 @@ For a first trial, create a separate account and API token on
 version:
 
 ```bash
-python -m twine upload --repository testpypi dist/sem2surface-0.2.0*
+python -m twine upload --repository testpypi dist/sem2surface-0.2.1*
 ```
 
 When prompted, use `__token__` as the username and the complete TestPyPI token,
@@ -274,7 +248,7 @@ including its `pypi-` prefix, as the password. Test the uploaded wheel in a new
 environment without resolving dependencies from TestPyPI:
 
 ```bash
-python -m pip install --index-url https://test.pypi.org/simple/ --no-deps sem2surface==0.2.0
+python -m pip install --index-url https://test.pypi.org/simple/ --no-deps sem2surface==0.2.1
 sem2surface --version
 ```
 
@@ -282,7 +256,7 @@ For the real release, create a PyPI account and API token at
 [pypi.org](https://pypi.org/), then run:
 
 ```bash
-python -m twine upload dist/sem2surface-0.2.0*
+python -m twine upload dist/sem2surface-0.2.1*
 ```
 
 PyPI and TestPyPI use separate accounts and tokens. Never commit a token or put

{sem2surface-0.2.0 → sem2surface-0.2.1}/README.md

@@ -1,5 +1,8 @@
 # sem2surface
 
+[![PyPI version](https://img.shields.io/pypi/v/sem2surface.svg)](https://pypi.org/project/sem2surface/)
+[![License: BSD 3-Clause](https://img.shields.io/pypi/l/sem2surface.svg)](https://github.com/vyastreb/sem2surface/blob/master/LICENSE)
+
 `sem2surface` reconstructs a three-dimensional surface from three to five
 multi-detector SEM/BSE images. It extracts two normalized principal images,
 identifies their orientation with a Radon transform, and integrates the resulting
@@ -15,78 +18,49 @@ calibration procedure.
 
 ## Installation
 
-Python 3.10 or newer is required. An isolated virtual environment is strongly
-recommended so the application does not conflict with system Python packages.
-
-### Linux and macOS
-
-Create an environment and install a released version:
+Python 3.10 or newer is required. Install `sem2surface` from PyPI with:
 
 ```bash
-python3 -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-python -m pip install sem2surface
-sem2surface-gui
+pip install sem2surface
 ```
 
-Until a release is uploaded to PyPI, run the final installation command from
-this source checkout instead:
+If several Python installations are present, use the interpreter explicitly:
 
 ```bash
-python -m pip install .
+python3 -m pip install sem2surface  # Linux or macOS
 ```
 
-On Linux, Tkinter may be packaged separately. For example, Ubuntu and Debian
-users can install it with their system package manager as `python3-tk` before
-creating the environment.
-
 ### Windows
 
 Install Python 3.10 or newer from
 [python.org](https://www.python.org/downloads/windows/). Keep the standard
-`pip`, Tcl/Tk, and Python Launcher components enabled. Then open PowerShell in
-the folder where you want the environment and run:
+`pip`, Tcl/Tk, and Python Launcher components enabled. Then open PowerShell or
+Command Prompt and run:
 
 ```powershell
-py -3 -m venv .venv
-.\.venv\Scripts\Activate.ps1
-python -m pip install --upgrade pip
-python -m pip install sem2surface
+py -m pip install sem2surface
 sem2surface-gui
 ```
 
-If PowerShell blocks the activation script, allow it only for the current
-PowerShell process and retry activation:
+If Windows cannot find the installed launcher, start the GUI through Python:
 
 ```powershell
-Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
-.\.venv\Scripts\Activate.ps1
-```
-
-In Command Prompt, activate the same environment with:
-
-```bat
-.venv\Scripts\activate.bat
+py -m sem2surface_gui
 ```
 
-Activation is optional. The GUI can always be launched directly:
-
-```powershell
-.\.venv\Scripts\sem2surface-gui.exe
-```
+On Linux, Tkinter may be packaged separately. For example, Ubuntu and Debian
+users can install `python3-tk` with their system package manager.
 
-Before the PyPI release, install either from a source checkout with
-`python -m pip install .` or from the provided wheel:
+A virtual environment is optional. It is useful when the system Python is
+externally managed, installation permissions are restricted, or other packages
+have conflicting dependencies:
 
-```powershell
-python -m pip install "C:\path\to\sem2surface-0.2.0-py3-none-any.whl"
+```bash
+python3 -m venv .venv
+source .venv/bin/activate  # Windows PowerShell: .\.venv\Scripts\Activate.ps1
+python -m pip install sem2surface
 ```
 
-Use `deactivate` to leave the environment on any platform. Do not copy a
-virtual environment between computers or move it after creation; create a new
-one and reinstall the package instead.
-
 VTK export is optional because VTK is a large dependency:
 
 ```bash
@@ -227,7 +201,7 @@ For a first trial, create a separate account and API token on
 version:
 
 ```bash
-python -m twine upload --repository testpypi dist/sem2surface-0.2.0*
+python -m twine upload --repository testpypi dist/sem2surface-0.2.1*
 ```
 
 When prompted, use `__token__` as the username and the complete TestPyPI token,
@@ -235,7 +209,7 @@ including its `pypi-` prefix, as the password. Test the uploaded wheel in a new
 environment without resolving dependencies from TestPyPI:
 
 ```bash
-python -m pip install --index-url https://test.pypi.org/simple/ --no-deps sem2surface==0.2.0
+python -m pip install --index-url https://test.pypi.org/simple/ --no-deps sem2surface==0.2.1
 sem2surface --version
 ```
 
@@ -243,7 +217,7 @@ For the real release, create a PyPI account and API token at
 [pypi.org](https://pypi.org/), then run:
 
 ```bash
-python -m twine upload dist/sem2surface-0.2.0*
+python -m twine upload dist/sem2surface-0.2.1*
 ```
 
 PyPI and TestPyPI use separate accounts and tokens. Never commit a token or put

{sem2surface-0.2.0 → sem2surface-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sem2surface"
-version = "0.2.0"
+version = "0.2.1"
 description = "3D surface reconstruction from multi-detector SEM/BSE images"
 readme = "README.md"
 requires-python = ">=3.10"

{sem2surface-0.2.0 → sem2surface-0.2.1/src/sem2surface.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sem2surface
-Version: 0.2.0
+Version: 0.2.1
 Summary: 3D surface reconstruction from multi-detector SEM/BSE images
 Author: Vladislav A. Yastrebov
 License-Expression: BSD-3-Clause
@@ -39,6 +39,9 @@ Dynamic: license-file
 
 # sem2surface
 
+[![PyPI version](https://img.shields.io/pypi/v/sem2surface.svg)](https://pypi.org/project/sem2surface/)
+[![License: BSD 3-Clause](https://img.shields.io/pypi/l/sem2surface.svg)](https://github.com/vyastreb/sem2surface/blob/master/LICENSE)
+
 `sem2surface` reconstructs a three-dimensional surface from three to five
 multi-detector SEM/BSE images. It extracts two normalized principal images,
 identifies their orientation with a Radon transform, and integrates the resulting
@@ -54,78 +57,49 @@ calibration procedure.
 
 ## Installation
 
-Python 3.10 or newer is required. An isolated virtual environment is strongly
-recommended so the application does not conflict with system Python packages.
-
-### Linux and macOS
-
-Create an environment and install a released version:
+Python 3.10 or newer is required. Install `sem2surface` from PyPI with:
 
 ```bash
-python3 -m venv .venv
-source .venv/bin/activate
-python -m pip install --upgrade pip
-python -m pip install sem2surface
-sem2surface-gui
+pip install sem2surface
 ```
 
-Until a release is uploaded to PyPI, run the final installation command from
-this source checkout instead:
+If several Python installations are present, use the interpreter explicitly:
 
 ```bash
-python -m pip install .
+python3 -m pip install sem2surface  # Linux or macOS
 ```
 
-On Linux, Tkinter may be packaged separately. For example, Ubuntu and Debian
-users can install it with their system package manager as `python3-tk` before
-creating the environment.
-
 ### Windows
 
 Install Python 3.10 or newer from
 [python.org](https://www.python.org/downloads/windows/). Keep the standard
-`pip`, Tcl/Tk, and Python Launcher components enabled. Then open PowerShell in
-the folder where you want the environment and run:
+`pip`, Tcl/Tk, and Python Launcher components enabled. Then open PowerShell or
+Command Prompt and run:
 
 ```powershell
-py -3 -m venv .venv
-.\.venv\Scripts\Activate.ps1
-python -m pip install --upgrade pip
-python -m pip install sem2surface
+py -m pip install sem2surface
 sem2surface-gui
 ```
 
-If PowerShell blocks the activation script, allow it only for the current
-PowerShell process and retry activation:
+If Windows cannot find the installed launcher, start the GUI through Python:
 
 ```powershell
-Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
-.\.venv\Scripts\Activate.ps1
-```
-
-In Command Prompt, activate the same environment with:
-
-```bat
-.venv\Scripts\activate.bat
+py -m sem2surface_gui
 ```
 
-Activation is optional. The GUI can always be launched directly:
-
-```powershell
-.\.venv\Scripts\sem2surface-gui.exe
-```
+On Linux, Tkinter may be packaged separately. For example, Ubuntu and Debian
+users can install `python3-tk` with their system package manager.
 
-Before the PyPI release, install either from a source checkout with
-`python -m pip install .` or from the provided wheel:
+A virtual environment is optional. It is useful when the system Python is
+externally managed, installation permissions are restricted, or other packages
+have conflicting dependencies:
 
-```powershell
-python -m pip install "C:\path\to\sem2surface-0.2.0-py3-none-any.whl"
+```bash
+python3 -m venv .venv
+source .venv/bin/activate  # Windows PowerShell: .\.venv\Scripts\Activate.ps1
+python -m pip install sem2surface
 ```
 
-Use `deactivate` to leave the environment on any platform. Do not copy a
-virtual environment between computers or move it after creation; create a new
-one and reinstall the package instead.
-
 VTK export is optional because VTK is a large dependency:
 
 ```bash
@@ -266,7 +240,7 @@ For a first trial, create a separate account and API token on
 version:
 
 ```bash
-python -m twine upload --repository testpypi dist/sem2surface-0.2.0*
+python -m twine upload --repository testpypi dist/sem2surface-0.2.1*
 ```
 
 When prompted, use `__token__` as the username and the complete TestPyPI token,
@@ -274,7 +248,7 @@ including its `pypi-` prefix, as the password. Test the uploaded wheel in a new
 environment without resolving dependencies from TestPyPI:
 
 ```bash
-python -m pip install --index-url https://test.pypi.org/simple/ --no-deps sem2surface==0.2.0
+python -m pip install --index-url https://test.pypi.org/simple/ --no-deps sem2surface==0.2.1
 sem2surface --version
 ```
 
@@ -282,7 +256,7 @@ For the real release, create a PyPI account and API token at
 [pypi.org](https://pypi.org/), then run:
 
 ```bash
-python -m twine upload dist/sem2surface-0.2.0*
+python -m twine upload dist/sem2surface-0.2.1*
 ```
 
 PyPI and TestPyPI use separate accounts and tokens. Never commit a token or put

{sem2surface-0.2.0 → sem2surface-0.2.1}/src/sem2surface.py

@@ -23,7 +23,7 @@ from scipy.ndimage import gaussian_filter
 from skimage.transform import radon
 
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"
 DEFAULT_PIXEL_SIZE = 1e-6
 _PIXEL_WIDTH_TAGS = ("PixelWidth=", "Image Pixel Size =")
 

{sem2surface-0.2.0 → sem2surface-0.2.1}/src/sem2surface_cli.py

@@ -11,7 +11,7 @@ from typing import Sequence
 try:
     VERSION = version("sem2surface")
 except PackageNotFoundError:  # Running directly from an unpacked source tree.
-    VERSION = "0.2.0"
+    VERSION = "0.2.1"
 
 
 def build_parser() -> argparse.ArgumentParser:

{sem2surface-0.2.0 → sem2surface-0.2.1}/tests/test_cli.py

@@ -8,7 +8,7 @@ def test_cli_exposes_version(capsys):
     with pytest.raises(SystemExit) as raised:
         parser.parse_args(["--version"])
     assert raised.value.code == 0
-    assert "0.2.0" in capsys.readouterr().out
+    assert "0.2.1" in capsys.readouterr().out
 
 
 def test_cli_requires_three_images(capsys):