shootpack は何をしますか?
パイプラインは ~/shootpack(gitリポジトリ)にあります。エントリポイント: shootpack <フォルダ> [--ceiling M] [--picks N] [--length S] [--log CURVE] [--latlon LAT,LON] [--plan]。新しい撮影は --plan で開始します(在庫確認、選別、編集計画を策定、エクスポートなし)。
デバイス
すべてのファイルのカメラは(EXIF Make/Model、ビデオエンコーダー/モデルタグ、サイドカー)で検出され、devices/<id>.json のプロファイルで読み取られます。不明なカメラは devices/generic.json を使用します。最初のログ行に検出結果が表示されます(devices: DJI Mavic 4 Pro (200 photos, 8 clips), Sony A1 II (...)) — 確認してください。
- DJI Mavic 4 Pro (
dji_mavic4pro):XMPドローンのジオメトリ → 太陽検出、フレーミングに基づく選別、天井フラグ、高度に基づくビデオ; SRTテレメトリ、LRFプロキシ。 - Sony A1 II (
sony_a1ii、EXIF Model ILCE-1M2):ARWブラケット(+ JPG/HEIFペア、カード間も含む)は露出補正値とドライブモードでグループ化; クリップXMLサイドカー(C0001M01.XML)は開始時間、フレームレート、ガンマと色域を提供; SUB/プロキシ。カメラジオメトリなし:自動太陽プロファイルなし(cull.jsonで手動で"sun"を設定)、選別は画像内容(ほぼ同一フレーム = 重複)で行われ、ショットはレンズ名で命名されます(24mm、70mm-portrait)。 - Fujifilm X-E4 (
fujifilm_xe4、EXIF Model X-E4、RAF、JPG、MP4):単一フレーム、RAF + JPGペア。JPGはレシピレンダリング(Classic Chromeなど;レシピはRAFのEXIFにあり、photo.recipe_tagsを参照); LightCraft自身のRAF現像は暗くフラットでこれを無視するため、エクスポート前にカメラJPEGに合わせた現像プロファイルをフィッティングします。同じDCIMフォルダ内のクリップ、サイドカーなし; フィルムシミュレーションクリップはRec.709(ルックのみ、テクニカルLUTなし)、F-Logは信号から検出されます。オフロード:shootpack offload <カード> --device XE4(ドロップフォルダDrops/XE4/)。現像:recipe_fit.py fit LUT.npz RAF=JPG,...を撮影自身のペア(RAFとJPGをキャプチャ時間でペアリング:番号は1つずれることがあります)に対して実行し、その後fuji_develop.py batch LUT.npz cull.json <DCIM dir> Deliverables/Photos(cull.jsonのキーはJPEG番号 -> {raf, jpg, name})。カメラの時計は現地時間になっている可能性があります(ある結婚式撮影では-06:00、現地時間=+8時間)。イベントクリップでライブ音声あり:clip_edit.py edits/<spec>.json Video/<name>_4K.mp4(音楽なし、Lカットオーディオ;安定化はmotion.pyが有効と証明しない限りオフ)。agent-docs/photos/fuji-recipe.md を参照。 - DJI Osmo 360 II (
dji_osmo360ii、.OSVはMP4エンコーダータグOsmo 360 IIで検出):2つの魚眼ストリームを持つため、クリップは分離され(ログは「N 360 clip(s) ... osmo360.py でレンダリング」と表示)、不動産編集には到達しません。osmo360.py CLIP.OSV Deliverables/Videoはグレーディングされたフラットリフレーム(キーフレーム移動)とグレーディングされた正距円筒360動画を書き出します。ステッチは未調整で水平は補正されていません。レンズはオーバーラップ部分でゲインマッチングされています。カラーモードは画像サークル内の信号から読み取られます(通常カラー vs D-Log M、両方の実クリップで確認済み)。D-Log Mは、DJIのOsmo 360 D-Log M LUTがluts/official/に配置されるまで、カメラ自身のプロキシに合わせた暫定LUT(luts/interim_dlogm_to_709_osmo360ii.cube)を使用します。--spec edits/osmo_car_v1.jsonは長いクリップのキーフレーム指定された抜粋をレンダリングします(車のテストでのドライバーのタイトで露出持ち上げられたクロップ)。フラットクロップの実ピクセル幅は18.6 x h_fov:タイトクロップの4Kはアップスケールされます(agent-docs/video/osmo360.md)。カメラは内部ストレージとSDカード(2ボリューム)を持ちます。オフロード:shootpack offload <カード>は自動的に見つけます(Drops/Osmo360/)。 - デュアルスロット記録:両方のカードに同一ファイルが検出され(名前+キャプチャ時間+サイズ、その後ハッシュ)、スロット1のコピーが使用されます;ログはスキップされた数を示します。
- GPSなし(カメラのみの撮影):セッションはローカルクロック時間で命名されます(朝 < 10:00、昼 < 15:00、午後 < 17:30、夕方)、グレードは名前に従います(昼/午後:昼のルック; それ以外:ゴールデン)。
--latlonを渡すと太陽に基づいて命名されます。Sonyショットにはジオメトリがないため、太陽ショットは自動太陽プロファイルを取得しません:cull.jsonで手動で"sun": {"G18": "A"}を設定します(自動現像は暗い太陽透過ガラスフレームをフラットに持ち上げます)。 - 新しいカメラ:最も近いプロファイルをコピーし、
detect.models、センサー/FOV、ブラケットルール、ログカーブを変更します。
手順
- 実行する。
shootpack "<フォルダ>" --ceiling <ユーザーのLAANC/空域天井、デフォルト120>をバックグラウンドで実行(写真約25秒/ブラケット、動画約4分)。結果は<フォルダ>/Deliverables/_shootpack/にキャッシュされます。 - 選別を視覚的に確認 —
Deliverables/_shootpack/<セッション>/all_stations.jpgと各Deliverables/Photos/<セッション>/Picks_contact_sheet.jpgを開きます。自動選別は内容を見られないため、以下を確認して修正します。- 家がフレーム端で切れている → リジェクトに移動
- 人物(多くの場合ハイビスのパイロット)がフレーム内 → 代替カットに移動、備考「PERSON-IN-FRAME」
- ほぼ重複 / 退屈な繰り返し → 代替カット; 強いショットが残っている場合 → ピック
- 天井を超えたショットはすでに代替カットにフラグ付けされています — それらに言及し、隠さない
<セッション>/cull.jsonを編集(キーG01…; 値は短い名前)、影響を受けた出力を削除し、--only photosで再実行します。 太陽ショットは自動検出され(太陽ジオメトリで太陽がフレーム内、かつ最も暗いブラケットでも白飛びしている)、太陽プロファイルで現像されます:A= 太陽が被写体(自動比-1.9ストップ)、C= 家が被写体(-0.6ストップ、家は明るいまま)。cull.jsonでショットごとに上書き:"sun": {"G21": "A", "G07": "off"}。 スター・バースト: ブラケットフレームに可視の太陽円盤の周りに鮮明な回折光線がある場合(各フレームの太陽を確認)、"starburst": {"G21": "0209"}(フレーム番号)を追加し、--only photos --redoで再実行します。雲の後ろの太陽には決して使用しないでください(その光線は太陽光線で、すでにマージに残ります)。太陽ショットでピンクのクリップ雲がないか確認します。
- ビデオを確認 —
Deliverables/Video/*_storyboard.jpg(3秒ごとに1フレーム)を開きます。離着陸、パイロット、暗すぎる、または反復的なショットを、Deliverables/_shootpack/edit.json(クリップ、開始、長さ、速度、露出ストップ)を編集して置き換え、--only videoで再実行します。クリップのプロキシ(DJI.LRF、SonySUB/)とDJI.SRT(rel_alt、position)を使用して、より良い瞬間を見つけます。カメラクリップにはテレメトリーがないため、離着陸トリミングと高度バンドは適用されません;24p/30pクリップはスローダウンされません(50p以上のみスローモーション可能)。 - グレーディング —
~/shootpack/luts/official/にDJIの公式LUTがある場合(Maginot:「DJI Mavic 4 Pro D-Log to Rec.709 V1.cube」)、すべてのショットはDJIのLUTをテクニカルベースとして、その上に当社のクリエイティブルックを重ねます:luts/looks/dlog_golden_*(ゴールデンアワー:暖かく、落ち着いた青、影を開放)またはdlog_midday_*(コントラスト/強度を増加)。luts/looks/make_looks.shがこれらを再構築します(build_look.py:_input.cube= 露出がログで適用された公式LUT、FilmCraftの入力スロット用;_look.cube= Rec.709→Rec.709、クリエイティブスロット用;_composed.cube= 両方、ffmpeg用)。露出の持ち上げは公式LUTの前に適用します(--pre-exposure、ログでストップ):DJIのLUTは自身のJPEGよりも暗く、その後で持ち上げると空が白飛びします(Maginot v5はそのために30-50%暗くなりました)。公式LUTがない場合は、カーブベースのwarm_print_v6/warm_print_midday_v2が使用されます。新しい公式LUTが映像のプロファイルと一致することを常に確認します(下記参照)。 - 音楽(トレーラー) — Epidemic SoundをユーザーのOAuthコネクタ経由で使用(APIキーは不可)。モンタージュカットにバー長が一致するインストゥルメンタル「ビルド」トラックを検索(75 BPM = 3.2秒バー)、各波形のエネルギーカーブを読み取ります:静かなイントロ、長いビルド、1つの大きなドロップが必要です。
DownloadRecording(WAV、FULL)をDeliverables/Music/に、その後music.analyze(wav, given_bpm):ドロップがダウンビートに着地することを確認します(グリッドのオン/オフビート位相はキック/ベースから、バー位相は最大の低域ジャンプから)。bar_chroma類似度 >= 0.9 のバーYからバーX+1へのジャンプX→Yを選択(同じコード、聞き取れるスプライスなし)。バーグリッド上で全フレーム単位でピクチャーをタイミング調整します(テンプレート:edits/make_trailer_v7.py):ダウンビートでカット、フィナーレはドロップ、エンドカードはリリース位置。trailer.pyはspec["music"]をすべての出力にマルチプレクスします;--music-onlyは再レンダリングなしで再編集と再マルチプレクスを行います;--size 1920x1080は5分のタイミングチェックを作成します(6Kレンダリング前にビートに対するカットを測定)。クライアントの好み(参考撮影、v8-v11):フル16:9、レターボックスなし("letterbox": null)、テキストカードなし、ディゾルブやブラックへのディップなし、ビートに合わせたハードカット、最後のショットで終了(音楽のテールの下に1秒の"end_fade"は問題ありません)。"stabilize"でショットをスムーズに:数値 = ガウスシグマ(秒単位、1-2)、{"poly": 2}= 均一な動き。レターボックスがない場合、すべての垂直方向の補正はズームを犠牲にするため、シグマは控えめに保ちます(参考撮影のフィナーレ:1.25 = 6.6% ズーム、2.0は12%);"reframe_y"はレターボックスがある場合のみ有効です。動きの最後に家をより多く残すには、ショットを遅くして動きの終了を早めます。レンダリング前後で手ブレを測定します(stabilize.trackでプレビュー);ドローンの停止と反転は緩和できるのみ(より重いシグマ + 0.85x)、除去はできません。 EpidemicのEditRecordingはrequiredRegionsAtOffsetsが設定されていると編集を返さず、制約なしの60秒編集ではドロップが完全に落ちたため(2026年10月)、トラックは自分たちでカットします。クライアント作業には商用Epidemicプランが必要です。確認してください。 - デリバリー — ピックのコンタクトシート、720pプレビュー(<30 MB)、ストーリーボードをSendUserFileで送信;
Deliverables/SUMMARY.mdから要約(カウント、フラグ、暫定事項)。再利用可能なコード変更はリポジトリにコミットします。
進捗表示
変更ごとに、before/afterを提供:review_site/<撮影>/progress/*/manifest.json を更新(grade / photos / detail / cut / music)し、progress_page.py で再構築(progress_music.py は音楽フィットチャートを描画);SendUserFileで電話フレンドリーなシートまたはスタック比較動画を送信します。
重要な事実
- RAWから常に現像(DJI DNG、Sony ARW);JPGはメタデータ/参照のみ。ARWのみのショットは、RAWから参照JPEGを抽出して
_shootpack/previews/に配置します。LightCraftはARWをSony自身のJPEGに合わせたルックでレンダリングします(ミュートなニュートラルフォールバックではない)が、Sonyレンズプロファイルはありません:歪曲/周辺減光は撮影時のまま。ARWのHDRマージは、カラーマトリックスやホワイトバランスなしのDNGを書き出します(緑がかる):パイプラインはカメラの較正を書き込みます(rawpyを介したLibRawのAdobe由来テーブルからのColorMatrix1、ショットからのAsShotNeutral)そしてそのファイルを現像するため、SonyブラケットのHDR_DNG/ファイルは任意のRAWエディタで正しい色で開きます。 - LightCraftは
*-HDR.dngをソースの隣に書き出します;パイプラインはそれらをDeliverables/HDR_DNG/に移動します。オリジナルは決して変更しません。 - DJI MP4は回転して保存されます(
rotation=-90);ffprobeはポートレート寸法を報告しますが、ランドスケープで再生されます。 - Sonyカード:スロットごとに
DCIM/+PRIVATE/ツリー全体をコピーします(FinderはMTPモードのカメラをマウントできません — カードリーダーまたはUSB Mass Storageを使用);M01.XMLサイドカーがない場合、クリップのガンマ/色域は信号のみにフォールバックします。 - SRT
DiffTime: 16ms= 59.94p → ハーフスピードコンフォームで29.97pにし、スムーズなオービットを実現。 - ログカーブはクリップごとに信号から決定:約10フレームの輝度コード値分布(p95 = 白の位置)をプロファイルの各カーブのバンドに対してチェックし、次にカメラのラベル(DJI SRT
color_md、Sony XMLCaptureGammaEquation)、次に--log。信頼順:明示的な--log、次に信号、次にラベル。すべての不一致はログとSUMMARY.mdでWARNINGとして表示 — レンダリング前に確認してください。D-Log vs D-Log M:日中ではD-Logは白を約0.55コード値に保ちます(空/太陽の超白はその上;Maginot p95 0.44-0.69);D-Log Mは白を0.8+近くに置きます。D-Log映像にD-Log M LUTを使用すると、白は約50%グレー(フラットでくすんだ)でレンダリングされます — MaginotはD-Logでした。暗すぎる(夜)またはバンド間=結論が出ない → ラベルが決定します。_shootpack/log/*.jsonに統計がキャッシュされます。 - デバイス/カーブ/色域ごとのLUTマッチング:
luts/official/の公式LUTは正規化されたファイル名トークンで検索(「D-Log M」はD-Log Mとしてカウント;Mavic 4 Pro LUTは他のDJI LUTより優先)。公式LUTなしのDJI:カーブ構築のウォームプリントグレード。Sony S-Log3:FilmCraftの内蔵builtin:slog3-sgamut3cine-to-rec709(または-sgamut3-、XMLのCaptureColorPrimariesから)、luts/builtin/にエクスポート;当社のD-Logルックはluts/looks/slog3_*_composed.cubeとしてその上に再構成され、プリエクスポージャーは18%グレーがDJIの入力LUTの位置に合うようにマッチングされます(混合DJI + Sony編集で一致)。S-Cinetone/Rec.709/HLGクリップはデコード不要:_look.cubeのみで十分。 - edit.jsonの露出は、クリップのカーブの1ストップあたりのコード値で持ち上げられます(
lift:D-Log 67、S-Log3 79)。 - LightCraft太陽ショット:
light.whitesを0に、light.highlightsを-60以下に保ちます;より強い回復やマゼンタの色合いは、クリップした雲を白以下に引きずり込み、ピンクにレンダリングします。 - 6Kレンダリング:
trailer.pyはセクションごとにレンダリングします(ハードカットとブラックへのディップで分割)— 14並列の6Kデコードは16GBメモリでメモリ不足になります。 - 空きディスク容量に注意:各HDR DNG ≈ 300 MB;パイプラインは空き5GB未満で停止します。