生値をレポートオブジェクトに突っ込む

nbtk commented 1 year ago

目的

ビットフィールドから抽出した生値をレポートオブジェクトに追加してほしいというご要望を頂戴した
もっともなご意見なので実装する
できる限りライブラリをフォークすることなく、ハンドラ内でやりたいことが完結できるようにしたい
方針
対象は文字列で保持していたデータ datetimeやintなどで保持しているデータは対象外。
生値を保持するために追加するメンバ変数の接尾辞は *_raw *_code, *_no と迷ったが、既存のメンバ変数に存在するため *_raw とした。また、例えばseismic_intensityやmagnitudeの生値をそのまま表示するために用いるべきではないことを暗示するためにも *_raw とした。既存の *_no のいくつかについても *_raw に直したくなるところだが、互換性が失われるので保留。
互換性を保つためデータ構造は変更しないただし、タイポ修正のためレポートオブジェクトのメンバ変数occurrence_time_of_eathquakeがoccurrence_time_of_earthquakeに変更される。使っている場合は置換してほしい。（ごめんなさい！）影響を受ける災害クラスはQzssDcReportJmaEarthquakeEarlyWarning、QzssDcReportJmaHypocenterならびにQzssDcReportJmaSeismicIntensity。
v0.8.xでリリース予定
例示

緊急地震速報(EEW)のレポートオブジェクトの例

{'assumptive': False,
'depth_of_hypocenter': '10km',
'depth_of_hypocenter_raw': 10,
'disaster_category': '緊急地震速報',
'disaster_category_en': 'Earthquake Early Warning',
'disaster_category_no': 1,
'eew_forecast_regions': ['島根',
                      '岡山',
                      '広島',
                      '山口',
                      '香川',
                      '愛媛',
                      '高知',
                      '福岡',
                      '佐賀',
                      '長崎',
                      '熊本',
                      '大分',
                      '宮崎',
                      '鹿児島',
                      '中国',
                      '四国',
                      '九州'],
'eew_forecast_regions_raw': [37,
                          38,
                          39,
                          40,
                          42,
                          43,
                          44,
                          45,
                          46,
                          47,
                          48,
                          49,
                          50,
                          51,
                          66,
                          67,
                          68],
'information_type': '発表',
'information_type_en': 'Issue',
'information_type_no': 0,
'magnitude': '7.2',
'magnitude_raw': 72,
'message': b'\x9a\xaf\x89\x9c\x80\x00\x03$\x00\x009\x00\x05H\xc5\xe2'
        b'\xc0\x00\x00\x00\x03\xdf\xf8\x00\x1c\x00\x00\x12\xfeK\x0f\xc0',
'message_header': '$QZQSM',
'message_type': 'DC Report (JMA)',
'nmea': '$QZQSM,58,9AAF899C80000324000039000548C5E2C000000003DFF8001C000012FE4B0FC*7F',
'notifications_on_disaster_prevention': ['強い揺れに警戒してください。'],
'notifications_on_disaster_prevention_raw': [201],
'occurrence_time_of_earthquake': datetime.datetime(2023, 3, 7, 4, 0),
'preamble': 'B',
'raw': b'\xaf\x89\x9c\x80\x00\x03$\x00\x009\x00\x05H\xc5\xe2\xc0'
    b'\x00\x00\x00\x03\xdf\xf8\x00\x1c\x00\x00\x10',
'report_classification': '訓練/試験',
'report_classification_en': 'Training/Test',
'report_classification_no': 7,
'report_time': datetime.datetime(2023, 3, 7, 4, 0),
'satellite_id': 58,
'satellite_prn': 186,
'seismic_epicenter': '日向灘',
'seismic_epicenter_raw': 791,
'seismic_intensity_lower_limit': '震度6弱',
'seismic_intensity_lower_limit_raw': 8,
'seismic_intensity_upper_limit': '〜程度以上',
'seismic_intensity_upper_limit_raw': 11,
'sentence': '$QZQSM,58,9AAF899C80000324000039000548C5E2C000000003DFF8001C000012FE4B0FC*7F',
'timestamp': datetime.datetime(2023, 6, 28, 17, 20, 2, 202197),
'version': 1}

nbtk commented 1 year ago

修正をコミットした。動作確認する。 https://github.com/nbtk/azarashi/commit/b8a95be1e488c551e696583721db12d6ba4332a4

nbtk commented 11 months ago

v0.8.0としてリリース。

nbtk / azarashi

生値をレポートオブジェクトに突っ込む #7

目的

方針

例示