Adds fine filtering on read_hipscat

[camposandro]

Adds fine filtering to the read_hipscat operation. Previously, when provided with a search_filter, the catalog was loaded with the pixels within the specified spatial region but we did not filter their data. This behavior created confusion with the users so we decided to apply the full search. We still do it in two steps, first figuring out which subset of files we should read from disk, creating the Dask DataFrame with the partitions, and then performing filtering on each of them. Closes #308.

[github-actions]

Before [e0d3fe4]	After [bae9e05]	Ratio	Benchmark (Parameter)
6.74±0.1ms	6.83±0.2ms	1.01	benchmarks.time_box_filter_on_partition
484±1ms	483±4ms	1	benchmarks.time_create_midsize_catalog
51.1±0.6ms	51.1±0.6ms	1	benchmarks.time_kdtree_crossmatch
16.1±0.5ms	16.1±0.4ms	1	benchmarks.time_polygon_search
3.23±0s	3.21±0.02s	0.99	benchmarks.time_create_large_catalog

Click here to view all benchmarks.

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[codecov]

Codecov Report

Attention: Patch coverage is 87.09677% with 4 lines in your changes missing coverage. Please review.

Project coverage is 98.33%. Comparing base (e0d3fe4) to head (8c69f00).
Report is 86 commits behind head on main.

Files with missing lines	Patch %	Lines
src/lsdb/core/search/abstract_search.py	66.66%	1 Missing ⚠️
src/lsdb/core/search/index_search.py	0.00%	1 Missing ⚠️
src/lsdb/core/search/order_search.py	0.00%	1 Missing ⚠️
src/lsdb/core/search/pixel_search.py	50.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #350      +/-   ##
==========================================
+ Coverage   98.32%   98.33%   +0.01%     
==========================================
  Files          43       43              
  Lines        1430     1440      +10     
==========================================
+ Hits         1406     1416      +10     
  Misses         24       24              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.