Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
molecule(6)		      XScreenSaver manual		   molecule(6)

NAME
       molecule	- draws	3D molecular structures

SYNOPSIS
       molecule	 [--display  host:display.screen]  [--window] [--root] [--win-
       dow-id number]  [--visual  visual]  [--delay  microseconds]  [--wander]
       [--no-wander]  [--spin axes] [--no-spin]	[--timeout seconds] [--labels]
       [--no-labels] [--titles]	[--no-titles] [--atoms]	[--no-atoms] [--bonds]
       [--no-bonds] [--shells]	[--no-shells]  [--molecule  file-or-directory]
       [--verbose] [--wireframe] [--fps]

DESCRIPTION
       The  molecule  program draws several different representations of mole-
       cules.  Some common molecules are built in, and it can read  PDB	 (Pro-
       tein Data Base) files as	input.

OPTIONS
       molecule	accepts	the following options:

       --window
	       Draw on a newly-created window.	This is	the default.

       --root  Draw on the root	window.

       --window-id number
	       Draw on the specified window.

       --install
	       Install a private colormap for the window.

       --visual	visual
	       Specify	which  visual  to use.	Legal values are the name of a
	       visual class, or	the id number (decimal or hex) of  a  specific
	       visual.

       --fps   Display the current frame rate, CPU load, and polygon count.

       --verbose
	       Print debugging info on stderr about files being	loaded,	etc.

       --wander
	       Move the	molecules around the screen.

       --no-wander
	       Keep the	molecule centered on the screen.  This is the default.

       --spin  Which  axes around which	the molecule should spin.  The default
	       is "XYZ", meaning rotate	it freely in space.  "--spin Z"	 would
	       rotate the molecule in the plane	of the screen while not	rotat-
	       ing it into or out of the screen; etc.

       --no-spin
	       Don't spin it at	all: the same as --spin	"".

       --labels
	       Draw  labels  on	 the  atoms (or	the spot where the atoms would
	       be.)  This is the default.

       --no-labels
	       Do not draw labels on the atoms.

       --titles
	       Print the name of the molecule and its chemical formula at  the
	       top of the screen.

       --no-titles
	       Do not print the	molecule name.

       --atoms Represent  the  atoms  as  shaded spheres of appropriate	sizes.
	       This is the default.

       --no-atoms
	       Do not draw spheres for the atoms: only draw bond lines.

       --bonds Represent the atomic bonds as solid tubes of appropriate	thick-
	       nesses.	This is	the default.

       --no-bonds
	       Do not draw the bonds: instead, make the	spheres	for the	 atoms
	       be  larger,  for	 a "space-filling" representation of the mole-
	       cule.

       --shells
	       Draw transparent	electron shells	around the atoms.   This  only
	       works if	bonds are also being drawn.

       --no-shells
	       Do not draw electron shells.  This is the default.

       --shell-alpha
	       When  drawing  shells,  how  transparent	to make	them.  Default
	       0.4.

       --wireframe
	       Draw a wireframe	rendition of the molecule: this	 will  consist
	       only of single-pixel lines for the bonds, and text labels where
	       the atoms go.  This will	be very	fast.

       --timeout seconds
	       When  using  the	 built-in  data	 set, change to	a new molecule
	       every this-many seconds.	 Default is 20 seconds.

       --molecule file-or-directory
	       Instead of using	the built-in  molecules,  read	one  from  the
	       given  file.  This file must be in PDB (Protein Data Base) for-
	       mat.  (Note that	it's not uncommon for  PDB  files  to  contain
	       only  the  atoms,  with	no  (or	 little) information about the
	       atomic bonds.)

	       This can	also be	a directory, in	which case, all	 of  the  .pdb
	       files in	that directory will be loaded.	A new one will be dis-
	       played  at  random  every few seconds (as per the --timeout op-
	       tion.)

       When the	molecule is too	large (bigger than  about  30  angstroms  from
       side to side), the --label option will be automatically turned off, be-
       cause  otherwise,  the  labels would overlap and	completely obscure the
       display.

       When the	molecule is around 150 angstroms from side to side,  wireframe
       mode will be turned on (because otherwise it would be too slow.)

ENVIRONMENT
       DISPLAY to get the default host and display number.

       XENVIRONMENT
	       to  get	the  name of a resource	file that overrides the	global
	       resources stored	in the RESOURCE_MANAGER	property.

       XSCREENSAVER_WINDOW
	       The window ID to	use with --root.

SEE ALSO
       X(1), xscreensaver(1)

       Documentation on	the PDB	file format:

       https://web.archive.org/web/20070108054535/https%3A//www.ww-
       pdb.org/docs.html
       https://web.archive.org/web/19990819134547/https%3A//www.rcsb.org/pdb/docs/for-
       mat/pdbguide2.2/guide2.2_frame.html

       A good source of	PDB files:
       https://www.umass.edu/microbio/rasmol/whereget.htm

COPYRIGHT
       Copyright (C) 2001-2005 by Jamie	Zawinski.  Permission  to  use,	 copy,
       modify,	distribute,  and  sell this software and its documentation for
       any purpose is hereby granted without  fee,  provided  that  the	 above
       copyright  notice appear	in all copies and that both that copyright no-
       tice and	this permission	notice appear in supporting documentation.  No
       representations are made	about the suitability of this software for any
       purpose.	 It is provided	"as is"	without	express	or implied warranty.

AUTHOR
       Jamie Zawinski <jwz@jwz.org>

X Version 11		      6.09 (07-Jun-2024)		   molecule(6)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=molecule&sektion=6&manpath=FreeBSD+Ports+14.3.quarterly>

home | help