9.2.5. Jmol selections

Write MDAnalysis.core.groups.AtomGroup selection to a str file that defines a Jmol selection. To be used in Jmol like this:

script macro.spt
select ~selection

The selection is named mdanalysis001.TODO

class MDAnalysis.selections.jmol.SelectionWriter(filename, mode='w', numterms=None, preamble=None, **kwargs)[source]

Set up for writing to filename.

Parameters:
  • filename – output file
  • mode – create a new file (“w”), or append (“a”) to existing file [“w”]
  • numterms – number of individual index numbers per line for output formats that write multiple entries in one line. If set to 0 or False then no special formatting is done [8]
  • preamble – string that is written as a comment at the top of the file []
  • kwargs – use as defaults for write()
close()

Close the file

New in version 0.16.0.

comment(s)

Return string s interpolated into the comment format string.

If no SelectionWriterBase.commentfmt is defined (None) then the empty string is returned because presumably there is no way to enter comments into the file.

A newline is appended to non-empty strings.

write(selection, number=None, name=None, frame=None, mode=None)

Write selection to the output file.

Parameters:
  • selection – a MDAnalysis.core.groups.AtomGroup
  • number – selection will be named “mdanalysis<number>” (None auto increments between writes; useful when appending) [None]
  • name – selection will be named name (instead of numbered) [None]
  • frame – write selection of this frame (or the current one if None [None]
write_preamble()

Write a header, depending on the file format.

class MDAnalysis.selections.jmol.SelectionWriter(filename, mode='w', numterms=None, preamble=None, **kwargs)[source]

Set up for writing to filename.

Parameters:
  • filename – output file
  • mode – create a new file (“w”), or append (“a”) to existing file [“w”]
  • numterms – number of individual index numbers per line for output formats that write multiple entries in one line. If set to 0 or False then no special formatting is done [8]
  • preamble – string that is written as a comment at the top of the file []
  • kwargs – use as defaults for write()
close()

Close the file

New in version 0.16.0.

comment(s)

Return string s interpolated into the comment format string.

If no SelectionWriterBase.commentfmt is defined (None) then the empty string is returned because presumably there is no way to enter comments into the file.

A newline is appended to non-empty strings.

write(selection, number=None, name=None, frame=None, mode=None)

Write selection to the output file.

Parameters:
  • selection – a MDAnalysis.core.groups.AtomGroup
  • number – selection will be named “mdanalysis<number>” (None auto increments between writes; useful when appending) [None]
  • name – selection will be named name (instead of numbered) [None]
  • frame – write selection of this frame (or the current one if None [None]
write_preamble()

Write a header, depending on the file format.