https://github.com/christinahedges/sparse3d
Tools to work with astronomy data in a sparse way
https://github.com/christinahedges/sparse3d
Last synced: 3 months ago
JSON representation
Tools to work with astronomy data in a sparse way
- Host: GitHub
- URL: https://github.com/christinahedges/sparse3d
- Owner: christinahedges
- Created: 2024-11-04T16:49:09.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-02-27T22:58:29.000Z (4 months ago)
- Last Synced: 2025-02-28T07:21:53.278Z (4 months ago)
- Language: Python
- Size: 7.63 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: docs/README.md
Awesome Lists containing this project
README
[](https://christinahedges.github.io/sparse3d/)
# `sparse3d`
This package contains implimentations of a class for working with data that looks like a **single large sparse image** containing small regions of **dense data**. Really, this is designed for working with astronomical images.
## What is `sparse3D`?
We often have large images in astronomy that might look like the sketch below. In this sketch we have a large, sparse image with 4 dense regions; A, B, C, and D. In astronomy we have this situation often, where we have small images of point like stars spread over large images.
```
+-------------------------------------+
| |
| +-----+ +-----+ |
| | | | | |
| | A | | B | |
| | | | | |
| +-----+ +-----+ |
| |
| +-----+ |
| | | |
| +-----+ | C | |
| | | | | |
| | D | +-----+ |
| | | |
| +-----+ * |
| |
+-------------------------------------+
```
We may wish to calculate a model for star brightness in each of these regions. In this case, we likely do not care about the value of the model outside these regions, e.g. at the point in the image indicated by `*`. However, our model may still be based on where we are within this larger image.
Because of this, it is efficient for us to take this image and cast it into a sparse representation using [`scipy`'s](https://scipy.org/) `sparse` library.
Unfortunately `sparse` does not easily enable us to do this, as it only allows 2D arrays.
This small repository implements a way that we can hold the data corresponding to each of the sub images inside of a sparse array, by "unwrapping" the indices for the sub images and insetting them in the larger, sparse image.
## Installation
You can install with pip using
```
pip install sparse3d --upgrade
```
or you can clone this repo and install using
```
cd sparse3d/
pip install poetry --upgrade
poetry install .
```