Metadata-Version: 2.4
Name: neloura
Version: 0.1.44
Summary: A local web viewer and analysis app for astronomical FITS images.
Author: Neloura Developers
Project-URL: Homepage, https://github.com/hamidnpc/Neloura
Project-URL: Source, https://github.com/hamidnpc/Neloura
Project-URL: Issues, https://github.com/hamidnpc/Neloura/issues
Keywords: astronomy,fits,astropy,visualization,jupyter
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Astronomy
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi
Requires-Dist: python-multipart
Requires-Dist: astropy
Requires-Dist: regions
Requires-Dist: reproject
Requires-Dist: spectral-cube
Requires-Dist: matplotlib
Requires-Dist: Pillow
Requires-Dist: scikit-image
Requires-Dist: numpy
Requires-Dist: aiohttp
Requires-Dist: photutils
Requires-Dist: psutil
Requires-Dist: httpx
Requires-Dist: requests
Requires-Dist: certifi
Requires-Dist: websockets
Requires-Dist: wsproto
Requires-Dist: uvicorn[standard]
Requires-Dist: astrodendro
Requires-Dist: astroquery
Requires-Dist: scipy
Provides-Extra: notebook
Requires-Dist: ipython; extra == "notebook"
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"

# Neloura

Neloura is a local web application for opening, visualizing, and analyzing
astronomical FITS images.

This package can be run from the command line:

```bash
neloura serve
neloura open path/to/image.fits
```

It can also be used inside Jupyter:

```python
import neloura

neloura.open_fits("path/to/image.fits")
```

In Jupyter, `open_fits()` starts a local Neloura server and displays the full
app in an iframe below the notebook cell. Outside Jupyter, it opens the app in a
browser tab.

On JupyterHub-style remote notebook servers, Neloura automatically uses the
notebook server proxy when `JUPYTERHUB_SERVICE_PREFIX` (or `NB_PREFIX`) is
available, so the same calls work from a browser connected to a remote kernel:

```python
import neloura

neloura.open_app()
neloura.open_fits("path/on/server/image.fits")
```

If `/proxy/<port>/` returns **404** in the browser, the hub image does not have
[`jupyter-server-proxy`](https://github.com/jupyterhub/jupyter-server-proxy)
enabled. Neloura cannot embed in an iframe until that is installed, or you use
SSH port forwarding from your laptop to reach `http://127.0.0.1:<port>/`.

## Development Install

From the repository root:

```bash
python -m pip install -e ".[notebook]"
neloura serve
```

On shared notebook servers where the system Python is not writable, install into
the user environment:

```bash
python -m pip install --user -U neloura
```

## Build

```bash
python -m pip install -U build twine
python -m build
twine check dist/*
```
