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.
- 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.
- 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:
- daily_energy(*, cache_path=None)[source]#
Fetch the published 200 daily operational energy estimates.
- 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 inattrs["rejected_files"]without repairing measured values. Gaps within returned sols stay missing; do not integrate across sleep periods to infer daily energy.
- 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.
- orbitalpv.mars.mars_declination(solar_longitude_deg)[source]#
Mars24 planetographic solar declination in degrees from season Ls.
- 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.jdfor leap-second-aware UTC conversion.
- 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_horizontaluses 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.componentsuses 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.
- 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.
- orbitalpv.mars.parse_insight_energy(content)[source]#
Read the native JHU Wh/sol table (operational estimates, not a wattmeter).
- 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.
- 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_whin frame attrs is array DC, before conversion/storage losses.