Grid-Free Deconvolution Directly From Visibilities
Project description
Spotless - Radio Interferometry Imaging Algorithm
This is a point-source deconvolution algorithm (part of the CLEAN family) that works without gridding. [http://www.iram.fr/IRAMFR/GILDAS/doc/html/map-html/node37.html]
This is essentially a grid-free version of the Cotton-Schwab algorithm with a different convergence an optimization steps. [Relaxing the isoplanatism assumption in self-calibration; applications to low-frequency radio interferometry]
It does not require W-projection and handles non-coplanar antennas without difficulty. It also works on all-sky images just fine.
How does Spotless work
The CLEAN algorithm is essentially deconvolution by repeated subtraction. I think this is silly, hence spotless. Spotless works by building up a model of the field of view in terms of point sources using model-fitting in visibility space.
Spotless deconvolutes the measured visibilities $V(u,v,w)$ into a sum of $N$ point-source visibilities $V_P(\theta, \phi)$ where $\theta$ and $\phi$ are the co-ordinates of the point source: i.e.,
$$ V(u,v,w) = \sum_{i=0}^{N} A_i V_P(\theta_i, \phi_i) + V_r(u,v,w) $$
where the $A_i$ are the brightness of each point source, and $V_r$ are the residual visibilities.
Spotless has two algorithms for doing this. The first, like CLEAN, is sequential location of point sources:
\begin{eqnarray*}
V(u,v,w) & = & A_0 V_P(\theta_0, \phi_0) + V_1(u,v,w) \\
V_1(u,v,w) & = & A_1 V_P(\theta_1, \phi_1) + V_2(u,v,w) \\
... \\
V_N(u,v,w) & = & A_N V_P(\theta_N, \phi_N) + V_{N+1}(u,v,w)
\end{eqnarray*}
At each step the new point source is located using a minimizer from the residuals at that step:
\begin{eqnarray*}
P_i & = & \min_{A, \theta, \phi} E(V_0) \\
& = & \min_{A, \theta, \phi} E(V - A V_P(\theta, \phi))
\end{eqnarray*}
where $E(V)$ is the total energy in the visibilities. So we find the point source that minimizes the remaining energy.
The nice thing is that the energy can be calculated directly from the visibilities, and so no gridding is required at all, either in image space or in visibility space.
This is possible because the integral of the fourier transform (F.T.) of the visibilities can be calculated directly from the visibilities without the F.T. This is Parseval's Theorem, for the DFT it becomes
\sum_{n=0}^{N-1} \left| x_n \right|^2 = \frac{1}{N} \sum_{k=0}^{N-1} \left| X_k \right|^2
Thus as the visibilities are the F.T of the sky brightness, the sum of the absolute value of the visibilities is proportional to the energy in the 'image'
E(V) \propto \sum_{k=0}^{N-1} v_i v_i^\star
MultiSpotless
Multispotless (--multimodel command line option) uses a better (but slower) sequential location. It builds up a multiple-point-source model as the algorithm progresses.
Termination Criterion
Both spotless variants terminate when the power in the residual stops decreasing.
Results
| Dirty Image | Spotless Image |
|---|---|
For more information see the TART Github repository
Install Instructions
tart_tools is available from standard python package repositories. Try:
pip install spotless
Running it on live data
spotless --api https://tart.elec.ac.nz/signal --display --show-sources
gridless --api https://tart.elec.ac.nz/signal --display --show-sources
TODO
- Add Gaussian Source Model
- Make explicit the antenna model (gain as a function of angular coordinates). We are assuming it is hemispherical here.
- Prove the relationship between power in the image and visibilty amplitudes. This might only work when the image tends towards a random one. But this is OK since as we remove the sources the residual becomes more and more random.
- Run an MCMC on the multimodel option to estimate uncertainty in the model. Then use this uncertainty as a stopping criterion (when new model components no longer have certain amplitude or position)
Author
- Tim Molteno (tim@elec.ac.nz)
Development work
If you are developing this package, install uv and then:
make sync
This installs all dependencies (including dev tools like flake8) in a virtual environment.
To run tests: make test
To lint: make lint
Changes
See CHANGES.md.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file spotless-0.7.2.tar.gz.
File metadata
- Download URL: spotless-0.7.2.tar.gz
- Upload date:
- Size: 4.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8d30cc63f8cfd404d193fbe094162c003bd9545ee72088ef8dfc8189053043af
|
|
| MD5 |
f5a46f039152f461d327a8f24c3d9757
|
|
| BLAKE2b-256 |
fb776cea4223065c03ab3797d74ed783bca8c71bfdcd4b5d24263e73bbc743e0
|
Provenance
The following attestation bundles were made for spotless-0.7.2.tar.gz:
Publisher:
package.yaml on tmolteno/spotless
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
spotless-0.7.2.tar.gz -
Subject digest:
8d30cc63f8cfd404d193fbe094162c003bd9545ee72088ef8dfc8189053043af - Sigstore transparency entry: 1860008568
- Sigstore integration time:
-
Permalink:
tmolteno/spotless@9502e372331124d9e67e5fdadb418e51e29acda2 -
Branch / Tag:
refs/tags/v0.7.2 - Owner: https://github.com/tmolteno
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
package.yaml@9502e372331124d9e67e5fdadb418e51e29acda2 -
Trigger Event:
push
-
Statement type:
File details
Details for the file spotless-0.7.2-py3-none-any.whl.
File metadata
- Download URL: spotless-0.7.2-py3-none-any.whl
- Upload date:
- Size: 34.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f7d62c82af7c1ced4db99607a1ad823043a09cc2c905996a77fcc27cb26eb27e
|
|
| MD5 |
a788c19621d0d611310710fab88919d7
|
|
| BLAKE2b-256 |
23b501c0d2764abe9676433706d672fd6b4de5a7439deb7e0f6e989ac128938f
|
Provenance
The following attestation bundles were made for spotless-0.7.2-py3-none-any.whl:
Publisher:
package.yaml on tmolteno/spotless
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
spotless-0.7.2-py3-none-any.whl -
Subject digest:
f7d62c82af7c1ced4db99607a1ad823043a09cc2c905996a77fcc27cb26eb27e - Sigstore transparency entry: 1860008663
- Sigstore integration time:
-
Permalink:
tmolteno/spotless@9502e372331124d9e67e5fdadb418e51e29acda2 -
Branch / Tag:
refs/tags/v0.7.2 - Owner: https://github.com/tmolteno
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
package.yaml@9502e372331124d9e67e5fdadb418e51e29acda2 -
Trigger Event:
push
-
Statement type: