macでインフォマティクス

macでインフォマティクス

HTS (NGS) 関連のインフォマティクス情報についてまとめています。

ターミナル上でPDB構造を表示するProteinView

2026/08/15 追記

 

ProteinViewは、PDBやmmCIF形式の立体構造をターミナル上で確認するためのオープンソースの分子構造ビューアである。タンパク質だけでなくDNA、RNAおよび小分子を読み込むことができ、Braille、HD、Kitty/Sixelを使ったFullHD表示に対応している。GUIを起動せず、SSH先の端末で構造を素早く確認したい場合や、構造解析の途中でPDBファイルを簡易チェックしたい場合に利用できる。PNGスナップショットの出力やRCSB PDBからの構造取得にも対応している。

 

(SSHで作業中に、タンパク質構造を確認するたびに専用ビューアを開くのが煩わしかったため、ターミナル内で完結するProteinViewを作った)

 

インストール

macで環境を作成してテストした(Rust 1.90.0、OpenSSL 3.5.7、pkg-configを入れてビルドした)。

依存

  • Rust 1.85以上

Github

mamba create -y -n proteinview-rust -c conda-forge rust=1.90 openssl=3.5.7 pkg-config
conda activate proteinview-rust
git clone https://github.com/001TMF/ProteinView.git
cd ProteinView
export OPENSSL_DIR="$CONDA_PREFIX"
export PKG_CONFIG_PATH="$CONDA_PREFIX/lib/pkgconfig"
cargo build --release --features fetch

> ./target/release/proteinview --help

TUI protein structure viewer

 

Usage: proteinview [OPTIONS] [FILE]

 

Arguments:

  [FILE]  Path to PDB, mmCIF, or XYZ file

 

Options:

      --hd

          Use HD rendering (HalfBlock over SSH, FullHD locally)

      --fullhd

          Force full pixel graphics (Sixel/Kitty/iTerm2) regardless of SSH

      --render <MODE>

          Render mode: braille, halfblock (or hd), fullhd (or pixel)

      --color <COLOR>

          Color scheme: structure, element, chain, plddt, bfactor, rainbow [default: structure]

      --residue-color <SELECTOR=RRGGBB>

          Override one exact polymer residue color: CHAIN:RES[ICODE]=RRGGBB

      --mode <MODE>

          Visualization mode: cartoon, backbone, wireframe [default: cartoon]

      --fetch <FETCH>

          Fetch structure from RCSB PDB by ID

      --panel-server

          Run the persistent headless panel server over NDJSON stdin/stdout

      --output <PNG>

          PNG path atomically replaced by the panel server

      --panel-width <PX>

          Initial panel framebuffer width in pixels [default: 960]

      --panel-height <PX>

          Initial panel framebuffer height in pixels [default: 540]

      --snapshot <PNG>

          Render one FullHD pixel frame to a PNG and exit without starting the TUI

      --snapshot-width <PX>

          Snapshot width in pixels [default: 1920]

      --snapshot-height <PX>

          Snapshot height in pixels [default: 1080]

      --snapshot-interface-chain <CHAIN>

          Highlight the interface for this focus-chain ID in a snapshot

      --snapshot-interactions

          Overlay classified interface interaction lines in a snapshot

      --snapshot-hide-ligands

          Hide ligands and ions in a snapshot

      --log <LOG>

          Write debug log to file (e.g. --log debug.log)

      --threads <THREADS>

          Number of render threads (default: 4) [default: 4]

  -h, --help

          Print help

  -V, --version

          Print version

 

テストラン

ローカルのPDBファイルを読み込んで対話的に表示する。

# PDBファイルを表示
cd ProteinView/ ./target/release/proteinview examples/1UBQ.pdb

表示された。キーボードのhとlでY軸回転、jとkでX軸回転、+と-で拡大縮小できる。

 

拡大して回転させた。

 

 

cでカラースキームを変更できる。

 

vで表示形式を切り替える。

qで終了する。

 

PNGスナップショットとしても出力できる。

./target/release/proteinview examples/1UBQ.pdb \
 --snapshot 1UBQ.png --snapshot-width 800 --snapshot-height 600

#解像度を上げて保存
./target/release/proteinview --fetch 1AON \
--snapshot groEL.png --snapshot-width 1920 --snapshot-height 1080 \
--mode cartoon --color chain

 

PDBから構造をfetchして可視化することもできる。

./target/release/proteinview --fetch 1UBQ

 

追記

滑らかな表示にするには、FullHDで実行する。

./target/release/proteinview --fetch 1UBQ --fullhd --mode cartoon

WSLのubuntuでテストした。--fullhd でも滑らかにならない場合は、ターミナル側に原因がある可能性がある。VS Code内蔵ターミナルやtmuxを使わず、直接起動する。

 

その他

  • AlphaFoldの構造ではpLDDTによる信頼度の色分けもできる。

コメント

SSH接続した計算機上で構造ファイルを確認したい場合に向いていると思います。試してみてください。

引用

https://github.com/001TMF/ProteinView

 

関連