magpy-gui 0.1.4__py3-none-any.whl

magpy/__init__.py

@@ -0,0 +1,16 @@
+"""
+MagPy - A modern Python bioacoustics analysis application.
+
+MagPy provides tools for viewing, analyzing, and annotating sound files
+with a focus on bioacoustics research.
+
+Package Structure:
+    - core: Core analysis modules (audio, spectrogram, measurements, selection)
+    - widgets: PyQt6 widgets (waveform, spectrogram, annotation_table, playback)
+    - screens: Multi-screen workspace views
+    - controllers: Bridge between GUI and bioamla core
+    - workers: QThread workers for long-running operations
+"""
+
+__version__ = "0.1.2"
+__author__ = "John McMeen"

magpy/__main__.py

@@ -0,0 +1,5 @@
+"""Entry point for running magpy as a module: python -m magpy"""
+from magpy.app import main
+
+if __name__ == "__main__":
+    main()

magpy/app.py

@@ -0,0 +1,49 @@
+"""
+Main application entry point for MagPy GUI.
+"""
+
+import sys
+from typing import Optional
+
+from PyQt6.QtWidgets import QApplication
+from PyQt6.QtCore import Qt
+
+from magpy.main_window import MainWindow
+
+
+def main(filepath: Optional[str] = None) -> int:
+    """
+    Launch the MagPy application.
+
+    Args:
+        filepath: Optional audio file to open on startup.
+
+    Returns:
+        Application exit code.
+    """
+    # Enable high DPI support
+    QApplication.setHighDpiScaleFactorRoundingPolicy(
+        Qt.HighDpiScaleFactorRoundingPolicy.PassThrough
+    )
+
+    app = QApplication(sys.argv)
+    app.setApplicationName("MagPy")
+    app.setOrganizationName("MagPy")
+    app.setOrganizationDomain("bioamla.org")
+
+    # Create main window
+    window = MainWindow()
+
+    # Open file if provided
+    if filepath:
+        window.load_file(filepath)
+    elif len(sys.argv) > 1:
+        window.load_file(sys.argv[1])
+
+    window.show()
+
+    return app.exec()
+
+
+if __name__ == "__main__":
+    sys.exit(main())

magpy/cli.py

@@ -0,0 +1,140 @@
+"""
+Command-line interface for MagPy.
+"""
+
+import argparse
+import sys
+from pathlib import Path
+
+from . import __version__
+
+
+def main() -> int:
+    """Main CLI entry point."""
+    parser = argparse.ArgumentParser(
+        prog="magpy",
+        description="MagPy Bioacoustics",
+    )
+
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
+
+    parser.add_argument(
+        "file",
+        nargs="?",
+        help="Audio file to open",
+    )
+
+    parser.add_argument(
+        "--gui",
+        action="store_true",
+        default=True,
+        help="Launch GUI (default)",
+    )
+
+    parser.add_argument(
+        "--headless",
+        action="store_true",
+        help="Run in headless mode for batch processing",
+    )
+
+    parser.add_argument(
+        "--compute-spectrogram",
+        metavar="OUTPUT",
+        help="Compute spectrogram and save as image",
+    )
+
+    parser.add_argument(
+        "--measure",
+        metavar="SELECTION_TABLE",
+        help="Compute measurements for selections in the given table",
+    )
+
+    args = parser.parse_args()
+
+    if args.headless:
+        return run_headless(args)
+    else:
+        from .app import main as gui_main
+
+        return gui_main(args.file)
+
+
+def run_headless(args) -> int:
+    """Run in headless mode for batch processing."""
+    if args.file is None:
+        print("Error: No input file specified", file=sys.stderr)
+        return 1
+
+    filepath = Path(args.file)
+    if not filepath.exists():
+        print(f"Error: File not found: {filepath}", file=sys.stderr)
+        return 1
+
+    from .core import AudioFile, SpectrogramGenerator, SelectionTable, MeasurementCalculator
+    from .core.measurements import SelectionBounds
+
+    print(f"Loading: {filepath}")
+    audio = AudioFile(filepath)
+    print(f"  Duration: {audio.duration:.2f}s")
+    print(f"  Channels: {audio.num_channels}")
+    print(f"  Sample rate: {audio.sample_rate} Hz")
+
+    if args.compute_spectrogram:
+        print(f"Computing spectrogram...")
+        generator = SpectrogramGenerator()
+        result = generator.compute(audio.data, audio.sample_rate)
+
+        import matplotlib.pyplot as plt
+
+        plt.figure(figsize=(12, 6))
+        plt.imshow(
+            result.spectrogram,
+            aspect="auto",
+            origin="lower",
+            extent=[0, result.duration, 0, result.frequencies[-1]],
+            cmap="viridis",
+        )
+        plt.colorbar(label="Power (dB)")
+        plt.xlabel("Time (s)")
+        plt.ylabel("Frequency (Hz)")
+        plt.title(f"Spectrogram: {filepath.name}")
+        plt.savefig(args.compute_spectrogram, dpi=150, bbox_inches="tight")
+        print(f"Saved spectrogram to: {args.compute_spectrogram}")
+
+    if args.measure:
+        selection_path = Path(args.measure)
+        if not selection_path.exists():
+            print(f"Error: Selection table not found: {selection_path}", file=sys.stderr)
+            return 1
+
+        print(f"Loading selection table: {selection_path}")
+        table = SelectionTable.load(selection_path)
+        print(f"  Found {len(table)} selections")
+
+        calc = MeasurementCalculator()
+
+        for i, selection in enumerate(table):
+            bounds = SelectionBounds(
+                start_time=selection.begin_time,
+                end_time=selection.end_time,
+                low_freq=selection.low_freq,
+                high_freq=selection.high_freq,
+            )
+            result = calc.compute_all(audio.data, audio.sample_rate, bounds)
+            selection.measurements = result.to_dict()
+            print(f"  Measured selection {i + 1}: {selection.duration:.3f}s")
+
+        # Save updated table
+        output_path = selection_path.with_stem(selection_path.stem + "_measured")
+        table.save(output_path)
+        print(f"Saved measurements to: {output_path}")
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

magpy/controllers/__init__.py

@@ -0,0 +1,8 @@
+"""MagPy controllers - bridge between GUI and bioamla core."""
+
+from .audio_controller import AudioController, AudioMetadata
+
+__all__ = [
+    "AudioController",
+    "AudioMetadata",
+]