Skip to main content

Constraints from Macro-Induced Lightning

Welcome to macro_lightning, the code-base for a paper on constraining macroscopic dark matter models with observations of lightning on Earth and Jupiter. If you are looking for the paper, the peer-reviewed journal article will be linked here and the arXiv preprint here. Alternatively, the source code for the paper is included as a sub-module in the folder “docs/papers_and_presentations/paper”.

Macroscopic dark matter (macros) is a broad class of alternative candidates to particle dark matter. These candidates would transfer energy to matter primarily through elastic scattering. A sufficiently large macro passing through the atmosphere would produce a straight channel of ionized plasma. If the cross-section of the macro is \sigma_x \gtrapprox 6 \times 10^{-9} \rm{cm}^2, then under atmospheric conditions conducive to lightning (eg. a thunderstorm) the plasma channel would be sufficient to seed a lightning strike with a single leader.

This is entirely unlike ordinary bolt lightning in which a long sequence of hundreds or thousands of few-meter-long leaders are strung together. This macro-induced lightning would be extremely straight, and thus highly distinctive. Neither wind shear nor magnetohydrodynamic instabilities would markedly spoil its straightness. The only photographically documented case of a straight lightning bolt is probably not straight enough to have been macro-induced.

For any discussion or derivations, see the paper. For code documentation, see ReadTheDocs. This is the raw code.

DOI PyPI Build Status Coverage astropy

Notebooks

Folder contains Mathematica notebooks to compute event rates for macro-induced lightning, as well as the constraints in mass and cross-section, both for lightning events on Earth and on Jupiter. There is also a notebook to compute the fraction of the Maxwell distribution of DM particles with velocities high enough to produce straight lightning bolts (ie. traveling faster than a lightning leader would ordinarily propagate).

Further notebooks can be found in “docs/examples”

Papers and Presentations

Look in “docs/papers_and_presentations”

CODE

The code is included in the macro_lightning folder.

References

Many of the sources cited in the paper are downloaded and included here.

How to contribute

GitHub milestones GitHub issues GitHub last commit (branch)

We welcome contributions from anyone via pull requests on GitHub. If you don’t feel comfortable modifying or adding functionality, we also welcome feature requests and bug reports as GitHub issues.

The development process follows that of the astropy-package-template from Astropy’s release procedure.

Attribution

DOI License

Copyright 2020 - Nathaniel Starkman, Jagjit Sidhu, Harrison Winch, Glenn Starkan, and contributors.

macro_lightning is free software made available under the BSD-3 License. For details see the LICENSE file.

If you make use of this code, please consider citing the Zenodo DOI as a software citation

@software{macro_lightning:zenodo,
  author       = {Nathaniel Starkman and Jagjit Sidhu and Harrison Winch and Glenn Starkman},
  title        = "Constraints from Macro-Induced Lightning",
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.3911476},
  url          = {https://zenodo.org/badge/latestdoi/275470390}
}

Metadata

Release files for macro-lightning 1.1

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

Source distribution (sdist)

Source distribution for macro-lightning 1.1
File Size Uploaded
macro_lightning-1.1.tar.gz 56.6 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for macro-lightning 1.1
File Interpreter ABI Platform
macro_lightning-1.1-py3-none-any.whl Python 3 none any Details

Total release size: 56.6 MB

Release files / macro_lightning-1.1.tar.gz

Download URL macro_lightning-1.1.tar.gz
Size 56.6 MB
Tags Source
SHA-256 checksum
How to use checksums
2dae76715bd896e80176a4686ad77ee0da389e0f23bbf7d7ec66c9e8e1ed8438
BLAKE2b-256 checksum
How to use checksums
e7ff495c1d958bf6413cf4380daff8fba071199143d6f6513b4a705bdc7493e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.1

Release files / macro_lightning-1.1-py3-none-any.whl

Download URL macro_lightning-1.1-py3-none-any.whl
Size 39.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1f59c017ee762740ac46192e69df257cca11d54b87c873d5f8f0c18885653d71
BLAKE2b-256 checksum
How to use checksums
31f0ffe81d6bf4576379122f1d1281193ffd96266a134b5bfdf4b453d9f83c2a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.9.1

Release history Release notifications | RSS feed

This release

1.1 This release

2 release files

1.0

1 release file

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