Skip to content

A Julia package to view macromolecular structures in the REPL, in a Jupyter notebook/JupyterLab or in Pluto

License

Notifications You must be signed in to change notification settings

jgreener64/Bio3DView.jl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bio3DView.jl

Build status codecov

Bio3DView.jl provides a viewer for molecular structures in Julia. It is a wrapper round the excellent 3Dmol.js package [1]. When used from the REPL or a file, the viewer shows in a popup using Blink.jl. When used from IJulia running in Jupyter or VS Code, or from Pluto.jl, the viewer shows in the output cell. You can also use Bio3DView.jl to generate standalone HTML, e.g. for use in a web page.

[1] Nicholas Rego and David Koes, 3Dmol.js: molecular visualization with WebGL, Bioinformatics (2015) 31(8): 1322-1324 - link

Contributions and bug reports are welcome.

Installation

Julia 1.0 or later is required, with Julia 1.9 or later required to get the latest version. Install Bio3DView from the package mode of the Julia REPL (press ]):

add Bio3DView

Bio3DView uses package extensions to minimise dependencies so you will also need to install either Blink, IJulia or Pluto to make this package useful, though you can generate HTML without them. If you are using Blink, you will need to run using Blink before the Bio3DView functions work. To view structural objects from BioStructures.jl you will need to run using BioStructures.

Usage

See the tutorial notebook.

Related software

See also BioMakie.jl and ProtPlot.jl.

Citation

If you use Bio3DView, please cite the BioStructures paper where it is mentioned:

  • Greener JG, Selvaraj J and Ward BJ. BioStructures.jl: read, write and manipulate macromolecular structures in Julia, Bioinformatics 36(14):4206-4207 (2020) - link - PDF