
starflattener (python edition)  Copyright (c) 2020-2025 by Kappa v.v.v

このソフトウェアはフリー(無償)ソフトです。星の写真を加工してキレイにします。

1.著作権
starflattenerのpythonコードとその実行形式および"readme.txt"ファイルの著作権は、
作者である"かっぱv.v.v"が所有しています。
これらの著作権を侵害する全ての行為を禁止します。starflattenerはフリー(無償)
ソフトウェアです。これを入手および使用するにあたって、作者に対して費用の支払いは
必要ありません。

2.配布および再配布
starflattenerはフリー(無償)ソフトウェアです。starflattenerの配布および再配布
(...以下、配布と同じ扱いとする)は、配布者の責任において実施してください。
配布の際には、starflattenerのpythonコードとその実行形式および"readme.txt"
ファイルに対して直接料金を設定することを禁止します。
ただし、ネットワーク接続料金など、配布設備にアクセスするために必要な費用については、
作者である"かっぱv.v.v"は一切関知しません。
なお、配布の際はウィルス混入を回避するために、可能な限りオリジナルのアーカイブファイル
にて配布するようにお願いします。ただし、配布者以外には物理的に書き込み不可能な
手段による配布の場合には、この限りではありません。

3.免責
作者である"かっぱv.v.v"は、pythonコードと実行形式および"readme.txt"ファイル
によって直接および間接的に生じる、如何なる責任および義務をも負いかねます。
これらの責任および義務は、上記ファイルを運用する者が負うこととします。しかしながら、
そのような事態が発生した場合は作者までご連絡だけして頂ければ幸いです。
お力にはなれませんが、今後の参考にさせて頂きたいと思います。

4.動作環境
starflattenerはWindows 11(64bit)上のpython 3にて開発/評価しています。
pythonコードから実行形式の生成にはpyinstallerを使用しています。実行形式は
python環境を展開後にpythonコードを実行するので、起動から実行まで数十秒間
かかることがあります。

実行形式はCPUのみを使用して動作しますが、pythonコード冒頭のコメントを操作
するとCUDAを使用して動作するようになります。
CUDA動作にはcupyを使用していて、別途インストールしたCUDA tool kitの版数
に対応したcupyモジュールのインストールがが必要です。
CUDA tool kitはPCに実装しているCUDA対応GPUの、各世代に対応した版数が
インストールされている必要があります。下記版数で開発・評価しています。
CUDA tool kit             11.8
cupy-cuda11x              13.3.0 
pythonコードはbatchファイルでラッピングして実行形式同様に使用することが可能
です。CUDA動作の状態でpyinstallerを使って実行形式に変換すると、実行ファイル
サイズが1GBを超えるので扱いにくいです。

5.starflattenerの機能
starflattener2はGUIモードとコマンドラインモードで実行できます。
コマンドライン引数をGUIに合わせて変更しました。

usage: starflattener [options] img1 [...imgN]
	指定した複数の画像ファイルをコンポジットします。
	オプションを指定せずに画像ファイルを指定すれば、GUIモードで起動します。

option:
        -out <tifjpg_file>  : 出力するtiff/jpeg/mpeg4いずれかのファイル名を指定します。
        -lighten          * : 比較明合成モードでコンポジットします。
        -average            : 加算平均モードでコンポジットします。
        -gauss <D>          : セルフフラット処理のgaussianフィルターの標準偏差を指定します。
        -bright <R> <G> <B> : 明るさをR/G/B別に調整します。
        -enhance <R>        : トーンカーブ調整の強さを調整します。
        -mix_org <R>        : 元画像と平均化する割合を指定します。
        -raw_bright <B>     : RAW現像時の明るさを指定します。(RAW入力時に有効)
        -align_size <S>     : アライメントBOXのサイズを指定します。
        -align_pos <X> <Y>  : 画像の(X,Y)座標付近でアライメントを取ります。
        -rotate <R>         : 角度R°で回転しながらコンポジットします。
        -dark <dark_file>   : ダークイメージファイル名を指定します。
        -dark_ratio <R>     : ダーク補正の強度を指定します。
        -flat <flat_file>   : 光学フラットイメージファイル名を指定します。
        -flat_ratio <R>     : 光学フラット補正の強度を指定します。
        -vsize <W> <H>      : 動画サイズを指定します。

・画像ファイルはワイルドカードを使って指定できます。
・画像ファイルフォーマットはraw/jpeg/tiff/fit(seestar)など一般的なものが使用できます。
・-outで出力画像ファイル名を指定します。tiff/jpeg/mpeg4のみに対応しています。
・カラーバランス・トーンカーブ調整、ダーク・フラット補正など、 天体写真の画像処理に便利な機能
 も付いています。
・mpeg4はコンポジットに使用した画像を使って1080x1080の動画ファイルを作成します。
 動画サイズは-vsizeオプションで変更できます。

6.作成者
 starflattenerについて、お気づきの点やご質問、ご感想などありましたら、
作者こと"かっぱv.v.v"までお知らせ頂けると幸いです。しかしながら当方の勝手な
都合により、お返事できない場合や、ご希望に添えない場合が多いと思いますが、
ご容赦願います。

	かっぱv.v.v : kappa.v.v.v@nifty.com

以上
