Skip to main content

SLDTk is a commandline program for fast and robust modelling and correction of limb darkening in solar images.

Getting Started

Prerequisites

SLDTk is written for Python 3. The following packages are required:

  • numpy>=1

  • opencv-python>=3

  • matplotlib>=2

Note that in addition to opencv-python, the underlying OpenCV library must be installed. There are currently plans to include an optional dependency on scikit-image for systems without OpenCV.

Installation

SLDTk can be installed using pip:

$ sudo pip install sldtk

Usage

$ sldtk -i IMAGE [optional arguments]

The program takes a range of optional arguments for everything from detection threshold to output directory. A complete list can be seen by calling

$ sldtk -h

Features

For now, the codebase provides the best source of information on SLDTk’s features and implementation specific details, as auto-generation of documentation has not yet been set up.

Input Formats

Currently only images in the jpg and png formats are supported.

Detection

The position and size of the solar disk is automatically determined using computer vision. The disk is subsequently unwrapped and cleaned of outliers (e.g. sunspots and facula) before an average intensity profile is generated.

Modelling

A pluggable modelling system allows user specified models (e.g. a 2nd degree polynomial) to be fitted to the intensity profile of the solar disk, and the results to be plotted together with the original profile for visual analysis. Reference models with known coefficients can also be overlaid on the produced graph.

Correction

Using a fitted model, the solar disk is flat-field corrected to a user selectable bias point. The result can further be fed back into the pipeline to assess its flatness, with a linear model fitted and plotted together with the corrected intensity profile.

Contributing

Do you have an idea for how to make SLDTk better? Have you found a bug? Head over to the issue tracker to open a new issue or contribute to an existing discussion.

If you are interested in contributing to the codebase, fork SLDTk on GitHub to get started. You can install the project in development mode by using $ sudo pip install -e . from the cloned project root.

Have you found a solution to an existing issue or added a new feature? Pull requests are always welcome.

License

SLDTk is released under the MIT open source license. Please see LICENSE.txt for details.

Acknowledgments

The Solar Limb Darkening Toolkit began as an experimental physics project together with Matt Wingham and Sam Heron at Aberystwyth University in the fall of 2017. It is written and maintained by Ariel Ladegaard.

Metadata

Release files for sldtk 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sldtk 0.1.0
File Size Uploaded Provenance Actions
sldtk-0.1.0.tar.gz 12.6 kB Without provenance Details for sldtk-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sldtk 0.1.0
File Interpreter ABI Platform Actions
sldtk-0.1.0-py3-none-any.whl Python 3 none any Details for sldtk-0.1.0-py3-none-any.whl

Total release size: 30.6 kB

Release files / sldtk-0.1.0.tar.gz

Download URL sldtk-0.1.0.tar.gz
Size 12.6 kB
Tags Source
SHA-256 checksum
How to use checksums
2adf7ab3dfbe4fda3bd74da1a65f1b4e7b520c00411cf1450b8902f42ca58f29
BLAKE2b-256 checksum
How to use checksums
64b774c607a464afa3fc12f3555f9dd19a776a1ad8a653c873ecf8b05b521f97
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / sldtk-0.1.0-py3-none-any.whl

Download URL sldtk-0.1.0-py3-none-any.whl
Size 18.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
bda9c676338ffc930076f7237189dac4d5ca04d3f2c4e61e6eaddb098d9fead7
BLAKE2b-256 checksum
How to use checksums
e7b02779ef65c411c5abde604b3fc16f503f72045a065b7d36923b84d60bc54e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for sldtk 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page