Difference between revisions of "Save"

From PyMOLWiki
Jump to navigation Jump to search
m
(Add COLLADA (.dae) to autodetected formats.)
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
===DESCRIPTION===
+
'''save''' writes selected atoms to a file.   
'''save''' writes selected atoms to a file.  The file format is
+
 
autodetected if the extesion is ".pdb", ".pse", ".mol", ".mmod", or
+
=Details=
".pkl"
+
* The file format is autodetected if the extension is .pdb, .pqr, .mol, .sdf, .pkl, .pkla, .mmd, .out, .dat, .mmod, .pmo, .pov, .png, .pse, .psw, .aln, .fasta, .obj, .mtl, .wrl, .idtf, .dae, or .mol2.
+
* If the file extension is ".pse" (PyMOL Session), the complete PyMOL state is always saved to the file (the selection and state parameters are thus ignored).
Note that if the file extension ends in ".pse" (PyMOL Session), the
+
* CLUSTALW formatted alignments can be written by PyMOL as well. Once you perform an alignment like the following,
complete PyMOL state is always saved to the file (the selection and
+
::<source lang="python">
state parameters are thus ignored).
+
align proteinA, proteinB, object=A_on_B
+
</source>
 +
::the alignment can be written using:
 +
::<source lang="python">
 +
save A_aligned_with_B.aln, A_on_B
 +
</source>
 +
 
 
===USAGE===
 
===USAGE===
 
<source lang="python">
 
<source lang="python">
 
save file [,(selection) [,state [,format]] ]
 
save file [,(selection) [,state [,format]] ]
 
</source>
 
</source>
 +
 +
=== EXAMPLES ===
 +
<source lang="python">
 +
# save only the alpha carbons
 +
save onlyCAs.pdb, n. CA
 +
 +
# save my MD trajectory file to disk
 +
save myTraj.pdb, myMDTrajectory, state=0
 +
 +
# save a PyMOL session
 +
save thisSession.pse
 +
</source>
 +
 
===PYMOL API===
 
===PYMOL API===
 
<source lang="python">
 
<source lang="python">
cmd.save(file, selection, state, format)
+
cmd.save(filename[, selection[, state[, format]]])
 
</source>
 
</source>
  
 
===NOTES===
 
===NOTES===
 
* When saving a session file, then "state" has no effect.
 
* When saving a session file, then "state" has no effect.
* When state = 0 (default), only the current state is written.
+
* Default is state = -1, which saves only the current state.
* When state = -1, then a multi-state output file is written (PDB only).
+
* When state = 0, all states in the file are written. If you have more than one state, this produces a multi-state PDB file.
  
* In versions 1.XX, a multi-state output file is written when state = 0 (which is not default)
 
 
===SEE ALSO===
 
===SEE ALSO===
  [[Cmd load]], [[Cmd get_model]]
+
[[Load]], [[Get Model]]
  
 
[[Category:Commands|Save]]
 
[[Category:Commands|Save]]
 
[[Category:States|Save]]
 
[[Category:States|Save]]
 +
[[Category:Input Output Module|Save]]

Latest revision as of 15:07, 3 October 2016

save writes selected atoms to a file.

Details

  • The file format is autodetected if the extension is .pdb, .pqr, .mol, .sdf, .pkl, .pkla, .mmd, .out, .dat, .mmod, .pmo, .pov, .png, .pse, .psw, .aln, .fasta, .obj, .mtl, .wrl, .idtf, .dae, or .mol2.
  • If the file extension is ".pse" (PyMOL Session), the complete PyMOL state is always saved to the file (the selection and state parameters are thus ignored).
  • CLUSTALW formatted alignments can be written by PyMOL as well. Once you perform an alignment like the following,
align proteinA, proteinB, object=A_on_B
the alignment can be written using:
save A_aligned_with_B.aln, A_on_B

USAGE

save file [,(selection) [,state [,format]] ]

EXAMPLES

# save only the alpha carbons
save onlyCAs.pdb, n. CA

# save my MD trajectory file to disk
save myTraj.pdb, myMDTrajectory, state=0

# save a PyMOL session
save thisSession.pse

PYMOL API

cmd.save(filename[, selection[, state[, format]]])

NOTES

  • When saving a session file, then "state" has no effect.
  • Default is state = -1, which saves only the current state.
  • When state = 0, all states in the file are written. If you have more than one state, this produces a multi-state PDB file.

SEE ALSO

Load, Get Model