transChecker ユーザーマニュアル

インストール

1. MSS データフイル用チェックツールから transChecker.tar.gz を取得

2. tar.gz ファイルを gunzip コマンドで解凍

$ gunzip transChecker.tar.gz

3. tar ファイルを tar コマンドで展開

$ tar xvf transChecker.tar

4. ディレクトリが生成される

下記の要領で、ディレクトリの中身を見ると以下のようになっています。

$ cd transChecker
$ ls -FC
jar/      license.txt   transChecker.sh*

jar/	java のクラスライブラリ格納ディレクトリ(改変不可)
license.txt	使用許諾(改変不可)
transChecker.sh	実行シェルスクリプト

5. ファイルの編集

transChecker.sh を実行する前にファイルの中身を、インストールしたコンピュータの環境にあわせるために変更する必要があります。vi などのエディタで編集して下さい。

#!/bin/sh

# Installed directory
TRANS_DIR=./

# Set maximum Java heap size
HEAP_SIZE=128m

# Execution Command
# Don't change.
java -Xmx$HEAP_SIZE -jar $TRANS_DIR/jar/transChecker.jar -Cclean $@

RETVAL=$?

exit $RETVAL
#EOF

[TRANS_DIR 変数]

transChecker ディレクトリのある場所をフルパスで入力して下さい。

例) TRANS_DIR=/home/mass/transChecker

[HEAP_SIZE 変数]

transChecker が使用できる最大メモリ量を指定してください。

例) HEAP_SIZE=128m

6.PATH を指定する

PATH に transChecker.sh が設置してあるディレクトリを指定して下さい。

実行

任意のディレクトリで下記の通りに、コマンドを実行して下さい。

$ transChecker.sh[space]-x[アノテーションファイル名][space]-s[塩基配列ファイル名][space]
-e[実行結果保存用ファイル名][space]-o[アミノ酸配列ファイル名][space]-t[塩基配列とアミノ酸配列のアラインメントのファイル名]

例

$ transChecker.sh -xsample.ann -ssample.fasta -eerrmsg.txt -orsl.fasta -taln.txt

ファイル名は絶対パス・相対パスのどちらでも指定できます。
macOS: ファイル名とフォルダ名について
配列ファイル、アノテーションファイルのファイル名またはフォルダ名にマルチバイト文字が含まれていますと 一部のバージョンの macOS では正常に動作しない場合がありますので、ファイル名とフォルダ名にマルチバイト文字を混在させないように ご注意ください。

-x[アノテーションファイル名]

このオプションは必須です。指定されていない場合、本ツールは終了します。 アノテーションファイル はタブ区切りのテキストファイルです。 書式の詳細に関しては、登録ファイル形式：アノテーションファイル をご参照下さい。 また、transChecker 実行前に Parser によるチェックでエラーがないことをご確認ください。

-s[塩基配列ファイル名]

このオプションは必須です。指定されていない場合、本ツールは終了します。 塩基配列ファイル は fasta 形式のテキストファイルです。 書式の詳細に関しては、登録ファイル形式：配列ファイル をご参照下さい。 また、transChecker 実行前に Parser によるチェックでエラーがないことをご確認ください。

-e[実行結果保存用ファイル名]

アミノ酸配列への翻訳過程で生じたエラーメッセージを出力するファイルの名称を指定します。 このオプションが指定されていない場合は、エラーメッセージは、stdout で出力されます。 エラーメッセージが出力された場合は、適宜、対処をお願いいたします。 出力フォーマットとエラーメッセージの意味は transChecker エラーメッセージ一覧 をご参照ください。

-o[アミノ酸配列ファイル名]

翻訳結果のアミノ酸配列を出力するファイルの名称を指定します。 このオプションが指定されていない場合、アミノ酸配列は出力されません。 出力フォーマットは FASTA-like format をご参照ください。

-t[塩基配列とアミノ酸配列のアラインメントのファイル名]

翻訳結果を塩基配列とアミノ酸配列のアラインメントとして出力するファイルの名称を指定します。 このオプションが指定されていない場合、アラインメントは出力されません。 出力フォーマットは 塩基配列とのアラインメント をご参照ください。

>[Entry name].[Serial Number][space][CDS feature location]
[翻訳結果アミノ酸配列 (60 文字/行)]
//

>entry1.1 89..406
MLARISELTKIGTTIFIVAIDQVAEPNSWGSSQLVLLAKIAGALKAIPPNPVCTSRHRQA
ASVSPFRSAIVGTLLQLEAIKNLLTVSVDTIQQNGVLFIFVALLR
//
>entry1.2 684..1325
MSIGILGTKLGMTQIFDESGKAVPVTVIQAGPCPITQIKTVATDGYNAIQIGFLEVREKQ
LSKPELGHLSKAGAPPLRHLLEYRVPSTDGLELGQALTADRFEAGQKVDVQGHTIGRGFT
GYQKRHGFARGPMSHGSKNHRLPGSTGAGTTPGRVYPGKRMAGRSGNDKTTIRGLTVVRV
DADRNLLLVKGSVPGKPGALLNITPATVVGQQA
//

>[Entry name].[Serial Number][space][CDS feature location]
/codon_start=[codon_start の値; 指定なしの場合 1]
/transl_table=[transl_table の値; 指定なしの場合 1]
[塩基番号][塩基配列 (60 文字/行)]
[アミノ酸番号][翻訳結果アミノ酸配列 (20 文字/行)]
[空行]
:
//

ENT01.1 <1..179
/codon_start=3
/transl_table=1
         1 tgtacccactcaattttgtaaccccgggtatcatgctcccaggtgcattgatgttggatt
         1   Y  P  L  N  F  V  T  P  G  I  M  L  P  G  A  L  M  L  D  F

        61 tcacgatgtatctgacgcgtaactggctggtgaccgcattggttggaggtggattctttg
        21   T  M  Y  L  T  R  N  W  L  V  T  A  L  V  G  G  G  F  F  G

       121 gtctgctgttttacccaggtaactggccaatctttggcccgacccatctgccaatctaa
        41   L  L  F  Y  P  G  N  W  P  I  F  G  P  T  H  L  P  I  
//
>ENT02.1 101..280
/codon_start=1
/transl_table=1
         1 atgtacccactcaattttgtaaccccgggtatcatgctcccaggtgcattgatgttggat
         1 M  Y  P  L  N  F  V  T  P  G  I  M  L  P  G  A  L  M  L  D

        61 ttcacgatgtatctgacgcgtaactggctggtgaccgcattggttggaggtggattcttt
        21 F  T  M  Y  L  T  R  N  W  L  V  T  A  L  V  G  G  G  F  F

       121 ggtctgctgttttacccaggtaactggccaatctttggcccgacccatctgccaatctaa
        41 G  L  L  F  Y  P  G  N  W  P  I  F  G  P  T  H  L  P  I  
//