solar-apparent-time Python Package

The solar-apparent-time Python package translates Python datetime between solar apparent time and Coordinate Universal Time (UTC).

Gregory H. Halverson (they/them)
[email protected]
NASA Jet Propulsion Laboratory 329G

Installation

This package is available on PyPi as a pip package called solar-apparent-time with dashes.

Usage

Importing

Import this package as solar_apparent_time with under-scores.

import solar_apparent_time

UTC_to_solar(time_UTC: datetime, lon: float) -> datetime

Converts Coordinated Universal Time (UTC) to solar apparent time at given longitude for single time.

Parameters:

• time_UTC (datetime): The UTC time.
• lon (float): The longitude in degrees.

Returns:

• datetime: The solar time at the given longitude.

solar_to_UTC(time_solar: datetime, lon: float) -> datetime

Converts solar apparent time to Coordinated Universal Time (UTC) at given longitude for single time.

Parameters:

• time_solar (datetime): The solar time.
• lon (float): The longitude in degrees.

Returns:

• datetime: The UTC time at the given longitude.

UTC_offset_hours_for_area(geometry: rasters.RasterGeometry) -> rasters.Raster

Calculates the UTC offset in hours for an area defined by a RasterGeometry object from the rasters package.

Parameters:

• geometry (rasters.RasterGeometry): The raster geometry.

Returns:

• rasters.Raster: The UTC offset in hours.

solar_day_of_year_for_area(time_UTC: datetime, geometry: rasters.RasterGeometry) -> rasters.Raster

Calculates the day of the year for a given UTC time and an area defined by a RasterGeometry object from the rasters package.

Parameters:

• time_UTC (datetime): The UTC time.
• geometry (rasters.RasterGeometry): The raster geometry.

Returns:

• rasters.Raster: The day of the year.

solar_hour_of_day_for_area(time_UTC: datetime, geometry: rasters.RasterGeometry) -> rasters.Raster

Calculates the hour of the day for a given UTC time and an area defined by a RasterGeometry object from the rasters package.

Parameters:

• time_UTC (datetime): The UTC time.
• geometry (rasters.RasterGeometry): The raster geometry.

Returns:

• rasters.Raster: The hour of the day.