Implement local fixed-frame Trajectory

[jtodev]

Summary

Implements the fixed-frame trajectory starting point for scene synthesis, using the Acoular implementation as a guide, and structures it so future motion/reference-frame work can build on it more cleanly.

Changes

• add abstract scene_synthesis.trajectory.Trajectory
• add concrete scene_synthesis.trajectory.FixedTrajectory
• switch Source.trajectory to the local abstract Trajectory type
• export Trajectory and FixedTrajectory from scene_synthesis
• update trajectory test cases to use scene_synthesis.FixedTrajectory
• add support for interval, location(), traj(), and shift_by_offset()
• add validation for invalid spline inputs
• add unit tests and doctests for the new trajectory implementation

Issue linkage

• Closes Trajectory implementation with fixed frame of reference #7
• Related to Trajectory with FOROT #5

[github-actions]

Output of diff-cover 🔍

-------------
Diff Coverage
Diff: origin/main...HEAD, staged and unstaged changes
-------------
src/scene_synthesis/__init__.py (100%)
src/scene_synthesis/sources.py (100%)
src/scene_synthesis/trajectory.py (85.4%): Missing lines 19,23,64-65,169-170,172
-------------
Total:   52 lines
Missing: 7 lines
Coverage: 86%
-------------

[Copilot]

Pull request overview

Implements a local fixed-frame Trajectory abstraction for scene_synthesis, replacing direct usage of acoular.Trajectory and adding initial unit tests to validate core trajectory behaviors.

Changes:

• Added scene_synthesis.trajectory.Trajectory backed by a SciPy spline fit and exposed it from scene_synthesis.__init__.
• Switched Source.trajectory typing/imports to use the local Trajectory.
• Updated trajectory test cases and added new unit tests for interval, location(), and traj().

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
tests/test_trajectory.py	Adds direct unit tests for Trajectory.interval, Trajectory.location, and Trajectory.traj.
tests/cases_trajectory.py	Updates trajectory case fixtures to build scene_synthesis.Trajectory instances instead of acoular.Trajectory.
src/scene_synthesis/trajectory.py	Introduces the new fixed-frame Trajectory implementation using splprep/splev.
src/scene_synthesis/sources.py	Updates Source to depend on the local Trajectory type and refreshes docs/imports accordingly.
src/scene_synthesis/init.py	Re-exports Trajectory at the package top-level.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Comments suppressed due to low confidence (1)

tests/cases_trajectory.py:15

• The class docstring says these are cases for FixedTrajectory objects, but case_none returns [None]. Consider adjusting the docstring to reflect that cases may include None (or remove case_none if only trajectories are intended), to keep the documentation consistent with the actual returned values.

class Trajectories:
    """Test cases for all :class:`scene_synthesis.trajectory.FixedTrajectory` objects.

    New trajectories should be added here.
    """

    def case_none(self):
        """No trajectory test case."""
        return [None]

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.