TLSANL (CCP4: Supported Program)
NAMEtlsanl - analysis of TLS tensors and derived anisotropic U factors
SYNOPSIStlsanl xyzin input.brk tlsin input.tls xyzout output.brk [ axes output.in ]
[Keyworded input] RESTRAIN or REFMAC.
TLSINAn ASCII file containing details of the TLS groups and the values of the corresponding T, L and S tensors. See the RESTRAIN documentation for details of the file format. In addition to the records described there, the file may contain a line "REFMAC" denoting that the file has been output from the refinement program REFMAC, which has a different order of tensor elements.
XYZINInput coordinates in PDB format. ANISOU records are ignored. ATOM records may contain the full B factor (as output by RESTRAIN) or only the residual B factor (which doesn't include the contribution from the TLS parameters, as output by REFMAC). The program interprets the B factors according to the keyword BRESID.
XYZOUTOutput coordinates and anisotropic tensors in PDB format. The ATOM records may contain the full B factor, the residual B factor, or the TLS-component of the B factor according to the keyword ISOOUT. The ANISOU records contain the full anisotropic displacement parameters, irrespective of the ISOOUT keyword.
AXESOutput file containing the axes for translation, libration, screw-rotation, reduced translation and non-intersecting screw-rotation. The file is in a suitable format for including in a MOLSCRIPT .in file. See AXES keyword below.
Available keywords are:
Each axis is written as a pair of coordinates (in the coordinate system of the input PDB file) representing the beginning and the end of the axis. For the intersecting axes, the intersection is at the centre of reaction of the TLS group. The length of each axis is proportional to the magnitude of the corresponding motion. The proportionality factor can be adjusted by the argument < scale >, which defaults to 10.
The values of the T and S tensors held in TLSIN thus depend on the origin chosen for their calculation. The Centre of Reaction, however, is independent of the original origin, and hence so are quantities calculated with respect to the Centre of Reaction.
The rigid body motion can also be described as 3 screw motions about 3 non-intersecting axes parallel to the libration axes, together with a reduced translation tensor (see Schomaker and Trueblood (1968)). The program gives the absolute position of these screw axes and the pitch of the screw motion along them, followed by the reduced translation tensor.RESTRAIN, defaults can be accepted, although the ANISO keyword might be useful:
tlsanl XYZIN foo_in.pdb TLSIN foo_in.tls XYZOUT foo_out.pdb <<eof ANISO END eofFor files generated by REFMAC, the BRESID keyword will be needed:
tlsanl XYZIN foo_in.pdb TLSIN foo_in.tls XYZOUT foo_out.pdb <<eof BRESID END eof
SEE ALSOrestrain, refmac
AUTHORSHuub Driessen, David Moss, Ian Tickle et al., Birkbeck College.
Contact: Ian Tickle (firstname.lastname@example.org), Martyn Winn (email@example.com)