####################################################
#  HADES-SA CODEC2 Audio Creator(SAAC) ver.1.0
#  Windows Console Program written in Python3
#  Released on April 12, 2026
#  (c) 2026- JA3TDW/Fumio Asai All Rights Reserved
####################################################

1.HADES-SA CODEC2 Audio Creator(SAAC)とは
　SAACはオーブン衛星データーベースSatNOGS DBに蓄積された
HADES-SAのCODEC2音声フレームデータ(CSV)から音声ファイル
(WAV)を作成するためのプログラムです。
　WAVを作成するための標準的な方法はAMSAT-SAのWebサイト
からダウンロードした以下の2つのソフト
1)UZ7HO Soundmodem(Windows) for HADES-SA-SpinnyONE
2)AMSAT-EA HADES-SA SpinnyONE CODEC2 utilities
を使用します。SAACを使うとSoundmodem(とKISSGENESIS)
が不要になり、これらが生成するバイナリファイル(BIN)
はSAACがCSVから生成します。SAACはutilitiesを呼び出し
WAVを作成して終了時にBINを含む各種の中間ファイルを
削除します。

2.動作環境
　Winmdows 11 Home 64bit日本語版で動作を確認しています。
 Python3の実行環境は必要ありません。

3.インストール
1)SAACは下記の外部プログラムを必要とします。Webサイト
　からダウンロードして同じフォルダ(例えばc:\sa_codec2)
　に解凍して下さい。
*AMSAT-EA HADES-SA SpinnyONE CODEC2 utilities
 https://www.amsat-ea.org/proyectos/
*HADES-SA_SpinnyONE/byte_version/に含まれる
 unified-bytes-decoder-hades-sa-windows-x86.exe
 https://github.com/AMSAT-EA/HADES-SA_SpinnyONE
3)SAACの実行プログラム(saac.exe)を上記のフォルダにコピー
　して下さい。

4.使用方法
1)SatNOGSからHADES-SAのCSVをダウンロードします。下記の理由
　によりLast week版をお勧めします。
2)saac.exeを実行してCSVのファイル名入力すると処理が始まり
　処理が成功するとsaac_output.csvとhades_sa.wavがそれぞれ
　作成されます。saac_output.csvはCSVから抽出されたCODEC2
　フレームデータファイル、hades_sa.wavはCODEC2音声ファイル
　です。CSVからWAVを作成するために生成された中間ファイルは
　すべて削除されます。
*複数の局がアップロードしたフレームデータや複数の日時に
　アップロードされたフレームデータがCSVに含まれていると
　正常な音声ファイルが作成されません。そのためSampleの
　satnogs_input.csvのようにCSVには特定の局が特定の日時
　にアップロードしたフレームデータのみが含まれるように
　事前に編集しておくことをお勧めします。
* Sampleのsaac_output.csvのようにパケット番号が重複する
　フレームデータがなければ音声ファイルは正常ですが、重複
　あれば不正常です。
*この問題はCODEC2フレームデータに誤り検出や誤り訂正用の
　データが含まれていないことと、SSDVの画像番号のような
　音声識別データが含まれていないことが原因で発生すると
　推測しています。

*リリースノート
1)2026/4/12:ver.1.0を公開
