#!/usr/bin/env python
# -*- coding: utf-8 -*-
# Copyright (c) 2022 Satpy developers
#
# This file is part of satpy.
#
# satpy is free software: you can redistribute it and/or modify it under the
# terms of the GNU General Public License as published by the Free Software
# Foundation, either version 3 of the License, or (at your option) any later
# version.
#
# satpy is distributed in the hope that it will be useful, but WITHOUT ANY
# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
# A PARTICULAR PURPOSE. See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along with
# satpy. If not, see <http://www.gnu.org/licenses/>.
"""Geostationary High-speed Imager reader for the Level_1 HDF format.
This instrument is aboard the Fengyun-4B satellite. No document is available to describe this
format is available, but it's broadly similar to the co-flying AGRI instrument.
"""
import logging
from pyproj import Proj
from satpy.readers._geos_area import get_area_definition
from satpy.readers.fy4_base import FY4Base
logger = logging.getLogger(__name__)
[docs]
class HDF_GHI_L1(FY4Base):
"""GHI l1 file handler."""
def __init__(self, filename, filename_info, filetype_info):
"""Init filehandler."""
super(HDF_GHI_L1, self).__init__(filename, filename_info, filetype_info)
self.sensor = "GHI"
[docs]
def get_dataset(self, dataset_id, ds_info):
"""Load a dataset."""
ds_name = dataset_id["name"]
logger.debug("Reading in get_dataset %s.", ds_name)
file_key = ds_info.get("file_key", ds_name)
if self.CHANS_ID in file_key:
file_key = f"Data/{file_key}"
elif self.SUN_ID in file_key or self.SAT_ID in file_key:
file_key = f"Navigation/{file_key}"
data = self.get(file_key)
if data.ndim >= 2:
data = data.rename({data.dims[-2]: "y", data.dims[-1]: "x"})
data = self.calibrate(data, ds_info, ds_name, file_key)
self.adjust_attrs(data, ds_info)
return data
[docs]
def adjust_attrs(self, data, ds_info):
"""Adjust the attrs of the data."""
satname = self.PLATFORM_NAMES.get(self["/attr/Satellite Name"], self["/attr/Satellite Name"])
data.attrs.update({"platform_name": satname,
"sensor": self["/attr/Sensor Identification Code"].lower(),
"orbital_parameters": {
"satellite_nominal_latitude": self["/attr/NOMSubSatLat"].item(),
"satellite_nominal_longitude": self["/attr/NOMSubSatLon"].item(),
"satellite_nominal_altitude": self["/attr/NOMSatHeight"].item()}})
data.attrs.update(ds_info)
# remove attributes that could be confusing later
data.attrs.pop("FillValue", None)
data.attrs.pop("Intercept", None)
data.attrs.pop("Slope", None)
[docs]
def get_area_def(self, key):
"""Get the area definition."""
# Coordination Group for Meteorological Satellites LRIT/HRIT Global Specification
# https://www.cgms-info.org/documents/cgms-lrit-hrit-global-specification-(v2-8-of-30-oct-2013).pdf
res = key["resolution"]
pdict = {}
c_lats = self.file_content["/attr/Corner-Point Latitudes"]
c_lons = self.file_content["/attr/Corner-Point Longitudes"]
p1 = (c_lons[0], c_lats[0])
p2 = (c_lons[1], c_lats[1])
p3 = (c_lons[2], c_lats[2])
p4 = (c_lons[3], c_lats[3])
pdict["a"] = self.file_content["/attr/Semi_major_axis"] * 1E3 # equator radius (m)
pdict["b"] = self.file_content["/attr/Semi_minor_axis"] * 1E3 # equator radius (m)
pdict["h"] = self.file_content["/attr/NOMSatHeight"] * 1E3 # the altitude of satellite (m)
pdict["h"] = pdict["h"] - pdict["a"]
pdict["ssp_lon"] = float(self.file_content["/attr/NOMSubSatLon"])
pdict["nlines"] = float(self.file_content["/attr/RegLength"])
pdict["ncols"] = float(self.file_content["/attr/RegWidth"])
pdict["scandir"] = "S2N"
pdict["a_desc"] = "FY-4 {} area".format(self.filename_info["observation_type"])
pdict["a_name"] = f'{self.filename_info["observation_type"]}_{res}m'
pdict["p_id"] = f"FY-4, {res}m"
proj_dict = {"a": pdict["a"],
"b": pdict["b"],
"lon_0": pdict["ssp_lon"],
"h": pdict["h"],
"proj": "geos",
"units": "m",
"sweep": "y"}
p = Proj(proj_dict)
o1 = (p(p1[0], p1[1])) # Upper left
o2 = (p(p2[0], p2[1])) # Upper right
o3 = (p(p3[0], p3[1])) # Lower left
o4 = (p(p4[0], p4[1])) # Lower right
deller = res / 2.
area = get_area_definition(pdict, (o3[0] - deller, o4[1] - deller, o2[0], o1[1]))
return area