Mars surface models and data#

Mars surface PV, mission data and reproducible daily screening models.

class orbitalpv.mars.InSightOpacityConnector(*, timeout_s=30.0, user_agent='space-pv-analytics/0.2')[source]#

PDS camera-derived 600-nm optical depth, with sigma and fit uncertainty.

This is the product linked by the PDS Atmospheres InSight opacity landing page. Its URL is in the review tree; no final-archive status is inferred. The pinned MD5 is from the version 1.0 PDS4 XML label.

Parameters:
optical_depth(*, cache_path=None)[source]#

Download the native table; no averaging, gap filling or extrapolation.

Parameters:

cache_path (str | Path | None)

Return type:

DataFrame

class orbitalpv.mars.InSightSolarConnector(*, timeout_s=30.0, user_agent='space-pv-analytics/0.2')[source]#

JHU Dataverse v1.0 of DOI 10.7281/T1EPKRKR, CC BY 4.0.

All five native current archives through end of mission are supported. Files are pinned to observed Dataverse IDs and publisher checksums. No authentication is needed. A source revision fails closed until reviewed.

Parameters:
API = 'https://archive.data.jhu.edu/api'#
ARCHIVES: ClassVar[dict[str, tuple[int, str]]] = {'0000-0099': (16255, '3cef99b875e09740142ad985b5591b33'), '0100-0199': (16254, '59b2fc4332a8793ebc2512cbf85c3688'), '0200-0499': (16258, '1fe55b20da36f4a3f2005dbebc4e430e'), '0500-0688': (16259, 'b865d40cfcf4bbe12d6f023572cccc45'), '0689-EOM': (16257, 'fc7f44c0df495d0b4ac9566508351147')}#
catalogue()[source]#

Inspect current publisher metadata; downloads remain version-pinned.

Return type:

dict

daily_energy(*, cache_path=None)[source]#

Fetch the published 200 daily operational energy estimates.

Parameters:

cache_path (str | Path | None)

Return type:

DataFrame

currents(*, archive='0000-0099', sols=None, invalid_files='raise', cache_path=None)[source]#

Fetch an archive and parse selected sols, without extracting files.

Missing requested sols raise an error. Some native files contain byte corruption. By default a malformed file fails the request; explicit invalid_files="report" skips whole malformed files and lists each one in attrs["rejected_files"] without repairing measured values. Gaps within returned sols stay missing; do not integrate across sleep periods to infer daily energy.

Parameters:
Return type:

DataFrame

orbitalpv.mars.dust_retention(sols, *, loss_per_sol)[source]#

Return (1-loss_per_sol)**sols; no cleaning events are assumed.

Lorenz et al. (2020), doi:10.1029/2019EA000992, used 0.0028/sol for early InSight. It is a mission-specific scenario, not a global default. For cleaning events or measured histories, pass a dust-factor time series directly to mars_surface_power.

Parameters:
Return type:

ndarray

orbitalpv.mars.mars_declination(solar_longitude_deg)[source]#

Mars24 planetographic solar declination in degrees from season Ls.

Parameters:

solar_longitude_deg (float | ndarray)

Return type:

ndarray

orbitalpv.mars.mars_solar_parameters(julian_date_tt)[source]#

Return solar longitude, declination and Sun distance for TT Julian dates.

Angles are degrees; declination is planetographic as in Mars24. This is an analytic seasonal approximation, not a SPICE ephemeris. Use Astropy’s Time(..., scale='utc').tt.jd for leap-second-aware UTC conversion.

Parameters:

julian_date_tt (float | ndarray)

Return type:

dict[str, ndarray]

orbitalpv.mars.mars_surface_power(local_true_solar_time_h, *, latitude_deg, declination_deg, sun_distance_au, optical_depth, reference, cell_temperature_c, array_dust_factor=1.0, spectral_factor=1.0, atmosphere='lorenz_horizontal', tilt_deg=0.0, azimuth_deg=180.0, diffuse_horizontal_w_m2=None, ground_albedo=0.0, solar_constant_w_m2=1361.0)[source]#

Calculate DC power at specified Mars local true solar times.

lorenz_horizontal uses E0*cos(zenith)/(1+0.3*tau). The attenuation was published for normal-incidence cell response (Lorenz 2020, section 3); extending it over the day is an explicitly approximate horizontal-array model. Its output is an effective irradiance proxy, not measured broadband GHI. No tilted-array or diffuse separation is claimed in that mode.

components uses Beer-Lambert direct beam, plane-parallel airmass, caller-supplied DHI and isotropic sky/ground transposition. DHI is required (explicit zero gives a direct-only calculation). Optical depth must be appropriate to the desired effective band; a 600-nm value is not a full spectral atmosphere. Flat terrain, no refraction/twilight/self-shadowing. Azimuth is clockwise from north. Temperatures are cell, not air, values.

Parameters:
Return type:

DataFrame

orbitalpv.mars.parse_insight_currents(content)[source]#

Read a native Lorenz ASCII file; preserve gaps and both DBR currents.

UTC is the header timestamp plus elapsed SI seconds. The archive’s LMST and LTST strings are preserved; only LTST is additionally converted to Mars clock hours. DBR string currents are not total array output power.

Parameters:

content (bytes)

Return type:

DataFrame

orbitalpv.mars.parse_insight_energy(content)[source]#

Read the native JHU Wh/sol table (operational estimates, not a wattmeter).

Parameters:

content (bytes)

Return type:

DataFrame

orbitalpv.mars.parse_insight_opacity(content)[source]#

Read the PDS nsyt_tau v1.0 seven-field CSV, retaining uncertainties.

Schema verified against nsyt_tau.xml. Sol is fractional true solar time; opacity is at 600 nm. Never silently convert it to broadband tau. The provider currently links a review-directory product: retain that status.

Parameters:

content (bytes)

Return type:

DataFrame

orbitalpv.mars.simulate_mars_sol(*, julian_date_tt, latitude_deg, reference, optical_depth, cell_temperature_c, array_dust_factor=1.0, spectral_factor=1.0, atmosphere='lorenz_horizontal', tilt_deg=0.0, azimuth_deg=180.0, diffuse_horizontal_w_m2=None, ground_albedo=0.0, samples=289)[source]#

Simulate a full sol and integrate DC energy in Earth watt-hours.

Freeze seasonal geometry at the supplied representative TT date. Sample LTST 0..24 including both endpoints; elapsed SI seconds span one mean sol (88775.244 s). This neglects small within-sol seasonal/EOT changes. If supplying temperature or DHI vectors, their length must equal samples. energy_wh in frame attrs is array DC, before conversion/storage losses.

Parameters:
Return type:

DataFrame