Subio PlatformのFASTQ処理で問題が発生した場合の対処方法

Subio Platformでは、fastpによるFASTQファイルの前処理と、 KallistoまたはHISAT2–StringTieによる発現量の推定を行えます。 処理中にエラーが発生した場合は、まず実行ログを確認し、 どの段階で問題が起きたのかを調べてください。

1. run.logを確認する

FASTQファイルが保存されているフォルダー内には、 処理のための一時フォルダーが生成されます。 その中にあるrun.logには、 パイプラインの実行状況やエラーに関する情報が記録されています。 run.log.gzとしてgzip圧縮されている場合は、 解凍してから内容を確認してください。

エラーの原因が分からない場合は、 run.logをChatGPTなどのAIに読み込ませて、 原因や対処方法を相談することもできます。 OS、使用しているパイプライン、ツールのバージョンなども伝えると、 問題の特定に役立ちます。 ただし、AIが提案する対処方法が正しいとは限りません。 特に、ファイルの削除や実行環境の初期化を伴う操作は、 内容と影響を確認してから実行してください。

2. 実行環境とファイルパスを確認する

fastp、Kallisto、HISAT2、StringTieの実行ファイル、 リファレンスデータ、FASTQファイルの保存場所を確認してください。 ファイルパスに半角スペース、日本語、特殊な記号などが含まれている場合は、 それらを含まないフォルダーに移動して実行してみてください。

3. ディスク容量とメモリを確認する

FASTQファイルの処理には、入力ファイルや出力ファイルの保存に加えて、 一時ファイルを作成するためのディスク容量が必要です。 特にHISAT2–StringTieによる処理では、 中間ファイルによって大量のディスク容量を消費する場合があります。

必要な容量は、FASTQファイルのサイズ、サンプル数、 使用するパイプラインなどによって異なります。 処理中にディスクの空き容量やメモリの使用状況を確認してください。

また、自動バックアップやクラウド同期、 ウイルス対策ソフトなどが処理中のファイルにアクセスし、 問題を起こす場合も考えられます。 ログからファイルへのアクセスに関する問題が疑われる場合は、 これらのプログラムの影響も確認してください。

4. fastpの前処理設定を確認する

fastpは一般的なアダプター配列を自動的に検出できますが、 ライブラリー調製に使用したキットによっては、 アダプター配列を正しく認識できない場合があります。

この場合は、使用したアダプター配列を確認し、 fastpのオプションで明示的に指定してください。 例えば、次のように設定できます。

--adapter_sequence=AGATCGGAAGAGCACACGTCTGAACTCCAGTCA

また、アダプター除去後のリードに不要な配列が残っている場合は、 length filterやトリミングの設定を調整する必要があるかもしれません。

ただし、リード長を強制的に揃えたり、 フィルタリング条件を厳しくしたりすると、 解析に利用できるリードが減少します。 処理が正常に終了することだけでなく、 得られるデータが解析目的に適しているかどうかも確認してください。

fastpのオプションについては、 fastpの公式ドキュメント を参照してください。