Metadata-Version: 2.4
Name: fetch-spatial
Version: 0.1.0
Summary: A regex-fueled parser that tries to let you input a single GEO Experiment accession number and get SpatialData objects for each of its Samples.
Author-email: Andrew Wight <support@biobench.ai>
License-Expression: Apache-2.0
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: polars>=1.41.2
Requires-Dist: spatialdata-io>=0.7.0
Requires-Dist: spatialdata>=0.7.3
Requires-Dist: tqdm>=4.68.3
Requires-Dist: typer>=0.26.7
Description-Content-Type: text/markdown

## Fetch-Spatial: A SpatialData builder from GEO Experiment entries

Fetch-Spatial is a helper package to try and make downloading and using spatial transcriptomics data from GEO less painful.

After installing it, you should be able to call `python -m fetch_spatial GSE123456 path/to/outdir` and get an organized folder with the raw
input data, one SpatialData.zarr object for each Sample in the Experiment, and a single Report.json file that tells you what pieces of the
SpatialData were and were not parse-able.

__Note: Currently, only Xenium data is supported, but we hope to add more formats soon__

This function returns SpatialData objects even if they are missing images, boundaries, or expression data, so make sure you check the Report.json
file to see what actually happened before trying to use the files. We do this because most of the time, if a file is "missing", it's because the
Sample had a strange naming convention that we couldn't anticipate, but you can probably figure out which file it is on your own. Then, you have
a somewhat-complete SpatialData object that you can just add whatever is missing to using the spatialdata_io package.

Note that spatial transcriptomics files are _very_ large sometimes, so make sure you have enough disk space to write everything. Additionally, this 
script writes many intermediate files to your /tmp directory (and then cleans them up); if your /tmp is not big enough, you can set SPATIAL_TMP 
as an environment variable to override where temporary files are written.
