Skip to content

Phases 5 & 7: FilterPhase - Refactor to Polars #499

@mattsan-dev

Description

@mattsan-dev

Overview
The FilterPhase step now produces data using Polars LazyFrames, but the ConcatFieldPhase step still uses the legacy implementation and cannot process this new output. To keep the pipeline consistent and efficient, the FilterPhase phase must be updated to use the Polars version. This will keep existing behaviour while modernising the underlying process.

Tech Approach

  • Update digital_land/phase/FilterPhase.py so it delegates to the Polars FilterPhase implementation.
  • Implement the full FilterPhase logic inside digital_land/phase_polars/transform/FilterPhase.py.
  • Convert existing FilterPhase rules into Polars lazy transformations.
  • Ensure the FilterPhase phase accepts the LazyFrame produced by the new FilterPhase step.
  • Keep the same public interface so no downstream code needs changing.

Acceptance Criteria/Tests

  • FilterPhase phase accepts the FilterPhase phase LazyFrame without errors.
  • Legacy FilterPhase behaviour is reproduced using Polars.
  • Outputs match the legacy FilterPhase phase (apart from expected improvements).
  • No Pandas or row‑based Python operations are used.
  • Add test cases
  • Refactored code complies with project formatting and style standards (black/flake8/pep)

Resourcing & Dependencies
Depends on ConcatFieldPhase, no external teams.

Metadata

Metadata

Labels

No labels
No labels

Type

Projects

Status

In Review / QA 🔎

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions