lowtran

LOWTRAN atmospheric absorption extinction, scatter and irradiance model--in Python and Matlab

https://github.com/space-physics/lowtran

Science Score: 49.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.2%) to scientific vocabulary

Keywords

atmosphere atmospheric-modelling f2py fortran geoscience lowtran matlab matlab-python-interface python
Last synced: 6 months ago · JSON representation

Repository

LOWTRAN atmospheric absorption extinction, scatter and irradiance model--in Python and Matlab

Basic Info
  • Host: GitHub
  • Owner: space-physics
  • License: mit
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 3.17 MB
Statistics
  • Stars: 110
  • Watchers: 10
  • Forks: 43
  • Open Issues: 6
  • Releases: 10
Topics
atmosphere atmospheric-modelling f2py fortran geoscience lowtran matlab matlab-python-interface python
Created almost 11 years ago · Last pushed about 1 year ago
Metadata Files
Readme License

README.md

Lowtran in Python

Zenodo DOI Actions Status PyPi Download stats

LOWTRAN7 atmospheric absorption extinction model. Updated to be platform independent and easily accessible from Python and Matlab.

The main LOWTRAN program is accessible from Python by using direct memory transfers instead of the cumbersome and error-prone process of writing/reading text files. xarray.Dataset high-performance, simple N-D array data is passed out, with appropriate metadata.

Gallery

See below for how to make these examples.

Lowtran7 absorption

Install

Lowtran requires a Fortran compiler and CMake. We use f2py (part of numpy) to seamlessly use Fortran libraries from Python by special compilation of the Fortran library with auto-generated shim code. For Python 3.12, make sure to install setuptools using pip, i.e., pip install setuptools and make sure meson is available on the system.

If a Fortran compiler is not already installed, install Gfortran:

  • Linux: apt install gfortran
  • Mac: brew install gcc
  • Windows: Windows Subsystem for Linux

Install Python Lowtran code

sh pip install -e .

Examples

In these examples, optionally write to HDF5 with the -o option.

We present Python examples of:

  • ground-to-space transmittance: TransmittanceGround2Space.py

Lowtran Transmission * sun-to-observer scattered radiance (why the sky is blue): ScatterRadiance.py

Lowtran Scatter Radiance * sun-to-observer irradiance: SolarIrradiance.py

Lowtran Solar Irradiance * observer-to-observer solar single-scattering solar radiance (up-going) with custom Pressure, Temperature and partial pressure for 12 species: UserDataHorizontalRadiance.py Lowtran Solar Irradiance * observer-to-observer transmittance with custom Pressure, Temperature and partial pressure for 12 species: UserDataHorizontalTransmittance.py * observer-to-observer transmittance: HorizontalTransmittance.py

Lowtran Horizontal Path transmittance

Matlab

Matlab users can seamlessly access Python modules, as demonstrated in RunLowtran.m.

Here's what's you'll need:

  1. Setup Python ↔ Matlab interface.
  2. Install Lowtran in Python as at the top of this Readme.
  3. From Matlab, verify everything is working by:

matlab runtests('lowtran')

Notes

LOWTRAN7 User manual Refer to this to understand what parameters are set to default. Currently I don't have any aerosols enabled for example, though it's possible to add them into the code.

Right now a lot of configuration features aren't implemented, please request those you want.

Reference

  • Original 1994 Lowtran7 Code
  • LOWFIL program in reference/lowtran7.10.f was not connected as we had previously implemented a filter function directly in Python.
  • LOWSCAN spectral sampling (scanning) program in reference/lowtran7.13.f was not connected as we had no need for coarser spectral resolution.

Owner

  • Name: Space Physics
  • Login: space-physics
  • Kind: organization
  • Location: 1 au

Space Physics modeling and analysis

GitHub Events

Total
  • Issues event: 2
  • Watch event: 10
  • Fork event: 1
Last Year
  • Issues event: 2
  • Watch event: 10
  • Fork event: 1

Committers

Last synced: 6 months ago

All Time
  • Total Commits: 380
  • Total Committers: 4
  • Avg Commits per committer: 95.0
  • Development Distribution Score (DDS): 0.021
Past Year
  • Commits: 1
  • Committers: 1
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
scivision s****n@u****m 372
scivision s****n@n****m 4
Michael Hirsch, Ph.D 1****n@u****m 3
Jonas Krimmer 3****r@u****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 25
  • Total pull requests: 2
  • Average time to close issues: over 1 year
  • Average time to close pull requests: 5 days
  • Total issue authors: 20
  • Total pull request authors: 2
  • Average comments per issue: 1.16
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 0
  • Average time to close issues: 40 minutes
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • aeropung (3)
  • OctagonHex (3)
  • aschneid42 (2)
  • chrismolli (1)
  • SmithPeng (1)
  • drhirsch (1)
  • Caxec (1)
  • bpdavis86 (1)
  • justapythonuser (1)
  • brian-rose (1)
  • jimparker96313 (1)
  • shoste120 (1)
  • SanaShaukat (1)
  • thirtyUp (1)
  • jimustafa (1)
Pull Request Authors
  • WhiteChimney (1)
  • jkrimmer (1)
Top Labels
Issue Labels
enhancement (3) question (2)
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 425 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 19
  • Total maintainers: 1
pypi.org: lowtran

Model of Earth atmosphere absorption and transmission vs. wavelength and location.

  • Versions: 19
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 425 Last month
  • Docker Downloads: 0
Rankings
Docker downloads count: 4.2%
Dependent packages count: 10.0%
Average: 15.1%
Dependent repos count: 21.7%
Downloads: 24.5%
Maintainers (1)
Last synced: 6 months ago

Dependencies

.github/workflows/ci.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • msys2/setup-msys2 v2 composite
pyproject.toml pypi
  • numpy *
  • python-dateutil *
  • xarray *