From d64fecd8f9ccf213379df880fe083bf2af854991 Mon Sep 17 00:00:00 2001 From: Ian Czekala Date: Thu, 28 Dec 2023 19:27:20 +0000 Subject: [PATCH] updated README with library scope for MPoL. --- README.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index ffc4ad7f..f3746e3e 100644 --- a/README.md +++ b/README.md @@ -4,11 +4,17 @@ [![gh-pages docs](https://github.com/MPoL-dev/MPoL/actions/workflows/gh_docs.yml/badge.svg)](https://mpol-dev.github.io/MPoL/) [![DOI](https://zenodo.org/badge/224543208.svg)](https://zenodo.org/badge/latestdoi/224543208) -A Million Points of Light are needed to synthesize image cubes from interferometers. -MPoL is a flexible Python package designed for Regularized Maximum Likelihood imaging. We focus on supporting spectral line and continuum observations from interferometers like the Atacama Large Millimeter/Submillimeter Array (ALMA) and the Karl G. Jansky Very Large Array (VLA). There is potential to extend the package to work on other Fourier reconstruction problems like sparse aperture masking and kernel phase interferometry. -Documentation and installation instructions: [https://mpol-dev.github.io/MPoL/](https://mpol-dev.github.io/MPoL/) +MPoL is a PyTorch *library* built for Regularized Maximum Likelihood (RML) imaging and Bayesian Inference with datasets from interferometers like the Atacama Large Millimeter/Submillimeter Array (ALMA) and the Karl G. Jansky Very Large Array (VLA). + +As a PyTorch *library*, MPoL is designed expecting that the user will write Python code that uses MPoL primitives as building blocks to solve their interferometric imaging workflow, much the same way the artificial intelligence community writes Python code that uses PyTorch layers to implement new neural network architectures. You find MPoL easiest to use if you adhere to PyTorch customs and idioms, e.g., for feed-forward neural networks, data storage, GPU acceleration, and train/test optimization loops. + +MPoL is *not* an imaging application nor a pipeline, though such programs could be built for specialized workflows using MPoL components. We are focused on providing a numerically correct and expressive set of core primitives such that the user can leverage the full power of the PyTorch (and Python) ecosystem to solve their research-grade imaging tasks. This is already a significant development and maintenance burden for our small research team, and so our immediate scope must necessarily be limited to this objective. + +Installation instructions, documentation, and examples at: [https://mpol-dev.github.io/MPoL/](https://mpol-dev.github.io/MPoL/) + + ## Citation @@ -57,4 +63,5 @@ and } --- -Copyright Ian Czekala and contributors 2019-23 +Copyright Ian Czekala and contributors 2019-24 +A Million Points of Light are needed to synthesize image cubes from interferometers. \ No newline at end of file