cpp-arena 2.9__py3-none-win_amd64.whl

cpp_arena-2.9.data/purelib/cpp_arena/__init__.py

@@ -0,0 +1,54 @@
+"""Launch the existing desktop application from a writable user directory."""
+import argparse
+from importlib.metadata import version
+import os
+from pathlib import Path
+import struct
+import subprocess
+import sys
+import tempfile
+import zipfile
+
+
+def application_directory():
+    """Keep the original app's source-relative data paths out of site-packages."""
+    release = version("cpp-arena")
+    root = Path(os.environ["CPP_ARENA_HOME"]) if "CPP_ARENA_HOME" in os.environ else (
+        Path(os.environ["LOCALAPPDATA"]) / "CPP Arena")
+    destination = root.resolve() / release
+    if not destination.exists():
+        root.mkdir(parents=True, exist_ok=True)
+        with tempfile.TemporaryDirectory(prefix=".install-", dir=root) as temporary:
+            staged = Path(temporary) / release
+            with zipfile.ZipFile(Path(__file__).with_name("application.zip")) as archive:
+                archive.extractall(staged)
+            # Publish the whole application together, so an interrupted extraction
+            # cannot leave an apparently installed but incomplete application.
+            staged.rename(destination)
+    return destination
+
+
+def _launch(history=False):
+    parser = argparse.ArgumentParser(description=(
+        "CPP Arena offline experiment viewer" if history else
+        "CPP Arena UAV coverage path planning desktop application"))
+    parser.add_argument("--version", action="version", version=version("cpp-arena"))
+    if history:
+        parser.add_argument("experiment", nargs="?", help="Experiment folder or archive")
+    arguments = parser.parse_args()
+    if sys.platform != "win32" or struct.calcsize("P") != 8:
+        parser.error("CPP Arena currently requires 64-bit Python on Windows x64")
+    directory = application_directory()
+    entry = directory / ("HistoryViewer/viewer.py" if history else "main.py")
+    command = [sys.executable, str(entry)]
+    if history and arguments.experiment:
+        command.append(str(Path(arguments.experiment).resolve()))
+    return subprocess.call(command, cwd=directory)
+
+
+def main():
+    return _launch()
+
+
+def history_main():
+    return _launch(history=True)

cpp_arena-2.9.data/purelib/cpp_arena/__main__.py

@@ -0,0 +1,3 @@
+from . import main
+
+raise SystemExit(main())

cpp_arena-2.9.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: cpp-arena
+Version: 2.9
+Summary: Desktop comparison platform for UAV coverage path planning algorithms
+License-Expression: GPL-3.0-or-later
+Project-URL: Repository, https://github.com/lyujayne/CPPArena
+Project-URL: Issues, https://github.com/lyujayne/CPPArena/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: third_party/CGAL-LICENSE.txt
+License-File: third_party/LICENSE.GPL
+License-File: third_party/LICENSE.LGPL
+License-File: third_party/LICENSE_1_0.txt
+Requires-Dist: PySide6>=6.5
+Requires-Dist: shapely>=2.0
+Requires-Dist: pyproj>=3.0
+Requires-Dist: numpy>=1.24
+Requires-Dist: scipy>=1.11
+Requires-Dist: pandas>=1.5
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: lxml>=4.9
+Requires-Dist: requests>=2.20
+Requires-Dist: Pillow>=9
+Dynamic: license-file
+
+# CPP Arena
+
+CPP Arena is a desktop comparison platform for UAV coverage path planning.
+It provides polygon import, nine decomposition methods, seven route planners,
+experiment comparisons, waypoint export, and an offline experiment viewer.
+
+## Install and launch
+
+Requires **Windows x64 and 64-bit Python 3.10 or newer**. The bundled CGAL
+partition backend is a Windows x64 native library.
+
+```powershell
+python -m pip install cpp-arena
+cpp-arena
+```
+
+You can also launch the application with `python -m cpp_arena`.
+To open the independent offline experiment viewer:
+
+```powershell
+cpp-arena-history
+cpp-arena-history "D:\experiments\my-experiment"
+```
+
+On first launch, the packaged application is extracted to
+`%LOCALAPPDATA%\CPP Arena\2.9`. Settings, datasets, projects, pictures, and
+experiment records are saved inside that writable directory. Existing local
+experiments are not included in the distribution; import them with the viewer.
+Set `CPP_ARENA_HOME` before launch to use a different parent directory. Each
+release keeps its own application and data directory; uninstalling the Python
+package leaves those files in place.
+
+## Scope
+
+The application compares decomposition and planning implementations with
+explicit implementation budgets and assumptions. Algorithm alignment notes are
+included in the packaged `PAPER_ALIGNMENT.md` and `UPGRADE_v2.9.md`. Results
+are research outputs; exported waypoints do not include camera trigger commands.
+
+The source distribution contains the application Python sources in
+`cpp_arena/application.zip`, plus the native wrapper source, build instructions,
+and third-party notices. Extract the ZIP to inspect or run the original source.
+CGAL and Boost header download URLs and hashes are in
+`algorithms/native/README.md` inside that archive.
+
+## License and source
+
+CPP Arena is distributed under **GPL-3.0-or-later**. The bundled CGAL and Boost
+components retain their own notices and license texts. See `LICENSE`, `NOTICE`,
+and `third_party` in the distribution.
+
+[Source repository](https://github.com/lyujayne/CPPArena)

cpp_arena-2.9.dist-info/RECORD

@@ -0,0 +1,14 @@
+cpp_arena-2.9.data/purelib/cpp_arena/__init__.py,sha256=AeNEpcB7-yeaChrO7tR-LYPtrYmEJab7eZobwzjctmw,2138
+cpp_arena-2.9.data/purelib/cpp_arena/__main__.py,sha256=BHLi_-4Bx1gsZn-z6x7wECPn1YTxdc74y0deRea9FzY,45
+cpp_arena-2.9.data/purelib/cpp_arena/application.zip,sha256=JuvkIDQgX-r36U9qEqhoJ6XUROw3BSaHfeCFC2D6bck,927136
+cpp_arena-2.9.dist-info/licenses/LICENSE,sha256=QWITIDR54nAVwy2eizD4Cih5YqRnUEQbIiNwbN05IRY,35155
+cpp_arena-2.9.dist-info/licenses/NOTICE,sha256=J-5534H6eJkBtSBqDEqRceiVq-uV0ciXIGItXOhWNM0,1145
+cpp_arena-2.9.dist-info/licenses/third_party/CGAL-LICENSE.txt,sha256=_T3_RkmIeZwh9lOXoxTrSOroKIpprFEpZ7Fh55uS2J4,1981
+cpp_arena-2.9.dist-info/licenses/third_party/LICENSE.GPL,sha256=QWITIDR54nAVwy2eizD4Cih5YqRnUEQbIiNwbN05IRY,35155
+cpp_arena-2.9.dist-info/licenses/third_party/LICENSE.LGPL,sha256=N0pD9iWhuHf28TcZ0bq0yoeR7eYE2j4AnDztofb4VIk,7656
+cpp_arena-2.9.dist-info/licenses/third_party/LICENSE_1_0.txt,sha256=yb_3VziSIZPmf6cm-iJVNYcNKqEFn5FFLEEXNihK1WY,1338
+cpp_arena-2.9.dist-info/METADATA,sha256=hWbrTyYXDJNpxtgRYrrUvTy2nvGoSAAGq_vQIZCRR1I,3310
+cpp_arena-2.9.dist-info/WHEEL,sha256=BlXG8Qkq_mCTKpY-toCToAQAmGPE73xawTOhla8_4pE,98
+cpp_arena-2.9.dist-info/entry_points.txt,sha256=o0qQu6zKBJ9WgiJj1ihtme21V-ueqUz_IJgaWlSBtTU,88
+cpp_arena-2.9.dist-info/top_level.txt,sha256=6oi3ZbIfUinUUQB4lQC2T-s0XNE6fl3YQ26F5o71jP0,10
+cpp_arena-2.9.dist-info/RECORD,,

cpp_arena-2.9.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64
+

cpp_arena-2.9.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+cpp-arena = cpp_arena:main
+cpp-arena-history = cpp_arena:history_main