Endonuclease PvuII (1PVI) DNA - GATTACAGATTACA
CAP - Catabolite gene Activating Protein (1BER)
DNA - GATTACAGATTACAGATTACA Endonuclease PvuII bound to palindromic DNA recognition site CAGCTG (1PVI) DNA - GATTACAGATTACAGATTACA TBP - TATA box Binding Protein (1C9B)
CAP - Catabolite gene Activating Protein (1BER)
GCN4 - leucine zipper transcription factor bound to palindromic DNA recognition site ATGAC(G)TCAT (1YSA)
GCN4 - leucine zipper transcription factor bound to palindromic DNA recognition site ATGAC(G)TCAT (1YSA)
GCN4 - leucine zipper transcription factor bound to palindromic DNA recognition site ATGAC(G)TCAT (1YSA)
GCN4 - leucine zipper transcription factor bound to palindromic DNA recognition site ATGAC(G)TCAT (1YSA)
GCN4 - leucine zipper transcription factor bound to palindromic DNA recognition site ATGAC(G)TCAT (1YSA)
TBP - TATA box Binding Protein (1C9B)
 

Your guide to YASARA View



° 

Essentials

-

What you really have to know


° 

Getting started

° 

The ten magic words


° 

Atom

-

YASARA's representation of a true atom

° 

Residue

-

any continuous stretch of atoms sharing the same residue name, residue number and molecule name

° 

Molecule

-

any continuous stretch of residues sharing the same molecule name

° 

Object

-

a collection of molecules and additional items

° 

Soup

-

all atoms in active objects

° 

Scene

-

all objects together

° 

All

-

the scene or the soup

° 

Bond

-

a covalent link between two atoms with pH dependent order

° 

Local coordinate system - The coordinate system within one object

° 

Global coordinate system - The coordinate system of the scene

° 

The three potential pitfalls


° 

You never get less than you want

° 

There is a difference between 'Hide', 'Switch off', 'Remove' and 'Delete'

° 

Gaps in a molecule are bridged by default

° 

The keys and mouse buttons to use


° 

Moving objects around

° 

Changing the scene style

° 

Editing

° 

Analyzing the soup

° 

Controlling a simulation

° 

Using the console

° 

Other keys

° 

The command line parameters

° 

Running YASARA in special environments


° 

Running YASARA without graphics

° 

Running YASARA on one machine with multiple users

° 

Running YASARA from an NFS mounted volume

° 

Running YASARA on a 64 bit operating system

° 

Working with extremely large protein structures

° 

Citing YASARA, its algorithms and force fields

° 

Reporting bugs, problems and inconveniences

° 

Screenshots as examples of what you can do


° 

Selections

-

Tell YASARA what you want


° 

Selections are defined by a final type and an expression

° 

Possible final selection types are All, Obj, Mol, Res and Atom

° 

Ranges can be specified with a minus sign

° 

A logical OR is assumed between items of the same selection type

° 

A logical AND is assumed if you switch the selection type

° 

Selections are inflated to the final selection type at the end

° 

Additional selection types allow to filter for various properties


° 

'Element' switches to a selection of chemical elements

° 

'SecStr' switches to a selection of secondary structure types

° 

'Segment' switches to a selection of macromolecular segments

° 

'AltLoc' switches to a selection of alternate conformations

° 

'Protein', 'NucAcid' and 'HetGroup' immediately select proteins, nucleic acids and the rest

° 

'Backbone', 'Sidechain' and 'Visible' immediately select backbone, side-chain and visible atoms

° 

'PDB', 'PDBRev', 'YASARA', 'IUPAC' and 'XPLOR' change the atom naming scheme

° 

'LocalX|Y|Z<>X' and 'GlobalX|Y|Z<>X' select atoms by their position

° 

'BFactor<>X', 'Occupancy<>X' and 'Property<>X' select atoms by B-factor, occupancy and property value

° 

'Charge<=>X' selects units by their charge

° 

Names can be negated with an exclamation mark '!'

° 

Names can be wildcards using a question mark '?'

° 

Names with unusual characters can be quoted

° 

Selections can be combined with explicit operators


° 

The 'and', 'or' and 'not' operators perform logical operations

° 

The 'with distance <>X from' operator measures distances between atoms

° 

The 'with minimum distance from' operator finds the closest atom

° 

The 'with maximum distance from' operator finds the most distant atom

° 

The 'with <>X atoms closer Y among' operator counts close atoms

° 

The 'with <>X bonds to' operator analyzes bound atoms

° 

The 'with <>X bond angles to' operator analyzes second neighbor atoms

° 

The 'with distance <>X from Y surface...' operator measures distances from a surface

° 

The 'with contribution to X surface...' operator analyzes surface contributions

° 

The 'within sequence' operator selects within a given sequence

° 

Selections are not case sensitive except for two special cases

° 

Selection windows allow to build selections with the mouse

° 

Yanaconda helps to define selection subsets

° 

Examples of selections needed in real-life


° 

Commands

-

Tell YASARA what to do


° 

File

-

Load and save the scene or parts of it


° 

New scene - Start again

Clear all objects and bitmaps for a fresh start or reset YASARA entirely, including simulation parameters and undo-history.

° 

Clear

-

Clear scene

° 

Reset

-

Reset YASARA to startup state

° 

PDB files - Load and save objects in plain PDB format

° 

LoadPDB

-

Load Protein Data Bank file

° 

SavePDB

-

Save Protein Data Bank file

° 

YASARA objects - Load and save complete objects

° 

LoadYOb

-

Load YASARA object

° 

SaveYOb

-

Save YASARA object

° 

YASARA scenes - Load and save the entire scene

° 

LoadSce

-

Load complete scene

° 

SaveSce

-

Save complete scene

° 

OpenBabel

-

Import and export molecules using OpenBabel

When working with more exotic file formats, import and export structures with OpenBabel.

° 

Load*

-

Import file with OpenBabel

° 

Save*

-

Export file with OpenBabel

° 

Screenshots

-

Save plain or ray-traced screenshots

Save simple screenshots (optionally including the menu), save scene descriptions for PovRay or run it immediately to create photorealistic images including shadows.

° 

RayTrace

-

Create raytraced screenshot using POVRay

° 

SaveBMP

-

Save screenshot as Windows bitmap

° 

SavePOV

-

Save POVRay scene description

° 

MPEG movies - Encode plain or ray-traced animations

Save MPEG movies (optionally including the menu).

° 

SaveMPG

-

Save MPEG video

° 

Simulation snapshots - Load and save simulation states

Load simulation snapshots to restore atom positions and velocities at a certain time or save them in periodic time intervals. Atom positions without velocities can also be saved and restored in XTC format, which minimizes the required storage space.

° 

LoadSim

-

Load simulation snapshot in sim format

° 

LoadXTC<Obj|All>

-

Load simulation snapshot in XTC format

° 

SaveSim

-

Save simulation snapshots in sim format

° 

SaveXTC

-

Save simulation snapshots in XTC format

° 

Exit

-

Quit YASARA

Exit YASARA immediately .

° 

Exit

-

Exit YASARA

° 

Edit

-

Change content and properties of the soup


° 

History

-

Undo and redo changes

Undo and redo a number of changes up to the maximum undo-level .

° 

Redo

-

Redo changes

° 

Undo

-

Undo changes

° 

UndoLevels

-

Set number of undo levels

° 

Objects

-

Center, transform, transfer, remove, add and delete

Center objects for more intuitive mouse rotations, transfer them on top of another object , transform the atom coordinates, remove them temporarily from the soup (e.g. to exclude them from simulations), bring them back and delete them partly or entirely.

° 

Add<Obj|All>

-

Add objects to the soup

° 

Center<Atom|Res|Mol|Obj|All>

-

Center atoms

° 

Del<Atom|Res|Mol|Obj|All>

-

Delete atoms

° 

Remove<Obj|All>

-

Remove objects from the soup

° 

Transfer<Obj|All>

-

Transfer objects into another coordinate system

° 

Transform<Obj|All>

-

Transform objects

° 

Split points - Edit split points, split and join entire objects

Split points correspond to 'TER' entries in PDB files. Add or delete them , or split entire objects into multiple child objects, joining them again later.

° 

JoinObj

-

Join objects to one final object

° 

Join<Atom|Res|Mol>

-

Delete split points

° 

Split<Obj|All>

-

Split objects at split points

° 

Split<Atom|Res|Mol>

-

Introduce split points

° 

Bonds

-

Add, type and delete bonds

° 

AddBond

-

Add covalent bonds

° 

DelBond

-

Delete covalent bonds

° 

KekulizeBond

-

Remove fractional bond orders

° 

Link<Atom|Res|Mol|Obj|All>

-

Find bonds automatically

° 

ResonateBond

-

Introduce fractional bond orders

° 

SwapBond

-

Swap order of covalent bonds

° 

TypeBond

-

Assign bond orders automatically

° 

Building

-

Build atoms to molecules, oligomers, crystals and loops

° 

AddCap<Obj|All>

-

Add N/C-terminal capping groups

° 

AddRes

-

Add terminal residue

° 

AddTer<Obj|All>

-

Add C-terminal oxygens

° 

BuildAtom

-

Build single atom

° 

BuildLoop

-

Build central or terminal loop

° 

BuildLoopDB

-

Build loop data base

° 

BuildMol

-

Build peptide chain

° 

BuildRes

-

Build single residue

° 

Clean<Obj|All>

-

Clean objects for molecular dynamics simulation

° 

Crystallize<Obj|All>

-

Crystallize objects to fill the unit cell

° 

Duplicate<Obj|All>

-

Duplicate objects

° 

Oligomerize<Obj|All>

-

Oligomerize objects to generate the biologically active form

° 

SwapAtom

-

Swap chemical element of atoms

° 

SwapObj

-

Swap two objects in the list

° 

SwapPosAtom

-

Swap atom positions

° 

SwapRes

-

Swap residue side-chains

° 

Geometry

-

Set or optimize distances, angles and dihedrals

The quickest way of setting distances, angles and dihedrals is to mark up to four atoms with the mouse and click on Geometry in the atom context menu. It is always the last atom (marked with red fireflies) that moves. The geometry of small molecules can be optimized using semi-empirical quantum chemistry . In the Twinset, you can also regularize the covalent geometry.

° 

Angle

-

Set/get angle between atoms

° 

Dihedral

-

Set/get dihedral angle between atoms

° 

Distance

-

Set/get distance between atoms

° 

GroupAngle

-

Get angle between two atom groups

° 

GroupDihedral

-

Get dihedral angle between two atom groups

° 

GroupDistance

-

Get distance between two atom groups

° 

Optimize<Res|Mol|Obj|All>

-

Optimize molecular geometry

° 

Radius<Atom|Res|Mol|Obj|All>

-

Calculate the VdW radius

° 

Regularize<Obj|All>

-

Regularize covalent geometry

° 

Sampling

-

Search conformational space

Possible side-chain rotamers or domain movements can be analyzed by sampling dihedral angles (internal coordinates), while protein flexibility is best looked at in cartesian space by sampling loops or using Bert de Groot's CONCOORD plugin (currently Linux only). Apply CONCOORD only to energy-minimized structures without bumps, otherwise you may run into convergence problems.

° 

SampleDih

-

Sample dihedral angles

° 

SampleLoop

-

Sample central or terminal loop

° 

Surface environments - Define the context of surface analysis

To show or calculate partial surfaces, add or remove atoms to/from the surface environment.

° 

AddEnv<Atom|Res|Mol|Obj|All>

-

Add to environment for surface calculations

° 

RemoveEnv<Atom|Res|Mol|Obj|All>

-

Remove from environment for surface calculations

° 

Hydrogens

-

Add, swap and delete

Add missing hydrogens at default positions and use an energy minimization to place them correctly. Change their order within the residue and delete them when needed. In the Twinset, you can also optimize the hydrogen bonding network .

° 

AddHyd<Atom|Res|Mol|Obj|All>

-

Add missing hydrogens

° 

DelHyd<Obj|All>

-

Delete all hydrogens

° 

OptHyd<Obj|All>

-

Optimize hydrogen bonding network

° 

SwapHyd<Obj|All>

-

Swap hydrogen ordering in residues

° 

Water

-

Delete all waters

° 

DelWater<Obj|All>

-

Delete all water molecules

° 

Names and numbers - Set or get properties of atoms to objects

° 

BFactor<Atom|Res|Mol|Obj|All>

-

Set/get the B-factor

° 

Name<Atom|Res|Seg|Mol|Obj>

-

Set/get names of objects, segments, molecules, residues and atoms

° 

Occup<Atom|Res|Mol|Obj|All>

-

Set/get the occupancy

° 

Prop<Atom|Res|Mol|Obj|All>

-

Set/get the property value

° 

Renumber<Obj|All>

-

Renumber objects

° 

RenumberRes

-

Renumber residues

° 

Simulation

-

Simulate the soup


° 

Preparing a simulation - Define and fill the cell

° 

Boundary

-

Set cell boundary

° 

Cell

-

Set/get simulation cell dimensions

° 

FillCellObj

-

Fill simulation cell with object

° 

FillCellWater

-

Fill simulation cell with water

° 

Force fields - Get the recipe

Choose the force field and the force cutoff for non-bonded interactions, calculate electrostatic forces without a cutoff using PME for accurate results. In special cases, you may want to scale or exclude some force field components. The force field and AM1BCC atom types can also be retrieved to visualize YASARA's assignments.

° 

Cutoff

-

Set force cutoff distance

° 

ForceField

-

Set force field

° 

Force<Atom|Res|Mol|Obj|All>

-

Set/get force on atoms

° 

Interactions

-

Set force field terms

° 

Longrange

-

Set long range interactions

° 

ScaleForce

-

Set/get force scaling factors

° 

ShowSimGrid

-

Show simulation grid

° 

SimSpeed

-

Set simulation speed

° 

TypeAtom

-

Get the atom type

° 

Simulation parameters - Choose your favorite ingredients

° 

AnnealSteps

-

Set simulated annealing steps

° 

MinStep

-

Set energy minimization step

° 

PressureCtrl

-

Set pressure control

° 

SimSteps

-

Set number of simulation steps per screen update

° 

Temp

-

Set/get simulation temperature

° 

TempCtrl

-

Set temperature control

° 

Time

-

Set/get simulation time

° 

TimeStep

-

Set simulation time step

° 

Restraints

-

Enforce distances and dihedral angles

In addition to simply linking atoms with a spring , you can determine NMR structures using the same functions as XPLOR to restrain distances and dihedral angles individually or all together via a restraint file . The violation energies and statistics can be obtained using various potential functions and parameters like distance averaging . The restraints can be listed , selectively shown (satisfied restraints in green, violated ones in red), styled, hidden or deleted. Floating assignments can also be analyzed.

° 

AddSpring

-

Link atoms with a spring

° 

DelRest<Obj|All>

-

Delete restraints

° 

HideRest<Atom|Res|Mol|Obj|All>

-

Hide restraints

° 

LoadTbl

-

Load XPLOR distance and dihedral angle restraints

° 

ListFloat<Obj|All>

-

List floating assignments

° 

ListRest<Atom|Res|Mol|Obj|All>

-

List restraints and energies

° 

RestEnergy<Obj|All>

-

Calculate restraint energies

° 

RestViol<Obj|All>

-

Get restraint violation statistics

° 

RestrainDis

-

Restrain distance

° 

RestrainDih

-

Restrain dihedral angle

° 

RestrainPar

-

Set/get restraining parameters

° 

RestrainPot

-

Set/get restraining potential function

° 

SaveTbl

-

Save XPLOR distance and dihedral angle restraints

° 

ScaleRest<Atom|Res|Mol|Obj|All>

-

Scale restraints

° 

ShowRest<Atom|Res|Mol|Obj|All>

-

Show restraints

° 

Running a simulation - Keep the soup from boiling

When everything is ready, start the simulation . Note the possibility to save and restore simulation snapshots in the File menu. When running a non-realistic simulation (like high temperature NMR structure generation or some modeling tasks), you can fix and free atoms or correct cis-peptide bonds and wrong isomeres on the fly, reporting these errors when needed.

° 

CorrectCis

-

Correct cis-peptide bonds during simulation

° 

CorrectConv

-

Correct naming conventions during simulation

° 

CorrectIso

-

Correct wrong isomeres during simulation

° 

Fix<Atom|Res|Mol|Obj|All>

-

Fix atoms during simulation

° 

Free<Atom|Res|Mol|Obj|All>

-

Free atoms during simulation

° 

Sim

-

Control simulation

° 

WarnIsError

-

Treat warnings as errors

° 

Analyze

-

Analyze the soup


° 

Atom position - Calculate average positions and RMSFs

° 

AddPos<Atom|Res|Mol>

-

Sum atom positions to calculate average and standard deviation

° 

AveragePos<Atom|Res|Mol>

-

Average atom positions

° 

Pos<Atom|Res|Mol>

-

Set/get atom positions

° 

RMSF<Atom|Res|Mol>

-

Calculate root mean square fluctuations

° 

Superposition

-

Align atoms and calculate RMSDs

° 

AlignObj

-

Align objects

° 

RMSD<Atom|Res|Mol|Obj>

-

Calculate RMSDs

° 

Sup<Atom|Res|Mol|Obj>

-

Superpose objects

° 

Contacts

-

List contacts and hydrogen bonds

Search for contacts and hydrogen bonds between two selections.

° 

ListCon<Atom|Res|Mol|Obj>

-

List contacts

° 

ListHBo<Atom|Res|Mol|Obj>

-

List hydrogen bonds

° 

Energy

-

Calculate energies

° 

BindEnergyObj

-

Calculate binding energies

° 

Energy<Atom|Res|Mol|Obj|All>

-

Calculate force field energies

° 

FormEnergy<Atom|Res|Mol|Obj|All>

-

Calculate formation energies

° 

SolvEnergy

-

Calculate solvation energy

° 

Electrostatics

-

Calculate electrostatic potentials and charges

° 

Charge<Atom|Res|Mol|Obj|All>

-

Set/get the summed up charge

° 

Dipole<Atom|Res|Mol|Obj>

-

Calculate electric dipole moments

° 

ShowESP

-

Show electrostatic potential

° 

Geometry

-

Measure distances, angles, dihedrals and radii

For quick measurements, click on an atom, then hold down <Ctrl> and click on up to three more atoms. When analyzing a molecular dynamics simulation, distances, angles, dihedrals and radii can also be measured from within a macro. The same holds for distances between geometric centers , angles between regression lines and dihedrals between planes fit to groups of atoms.

° 

Angle

-

Set/get angle between atoms

° 

Dihedral

-

Set/get dihedral angle between atoms

° 

Distance

-

Set/get distance between atoms

° 

GroupAngle

-

Get angle between two atom groups

° 

GroupDihedral

-

Get dihedral angle between two atom groups

° 

GroupDistance

-

Get distance between two atom groups

° 

Optimize<Res|Mol|Obj|All>

-

Optimize molecular geometry

° 

Radius<Atom|Res|Mol|Obj|All>

-

Calculate the VdW radius

° 

Regularize<Obj|All>

-

Regularize covalent geometry

° 

Rotamers

-

Show rotamer distributions

° 

ShowRota<Res|Mol|Obj|All>

-

Show side-chain rotamers

° 

Secondary structure - Calculate secondary structure content

° 

HideSecStr<Res|Mol|Obj|All>

-

Hide secondary structure

° 

SecStrPar

-

Set secondary structure display parameters

° 

SecStr<Res|Mol|Obj|All>

-

Set/get secondary structure

° 

ShowSecStr<Res|Mol|Obj|All>

-

Show secondary structure

° 

Surface areas - Calculate VdW, molecular and accessible surfaces

° 

FirstSurf<Atom|Res>

-

Get first surface atom(s) or residue(s) and area(s)

° 

Surf<Atom|Res|Mol|Obj|All>

-

Calculate surface areas

° 

Volumes

-

Calculate VdW, molecular and solvent accessible volumes

° 

Volume<Atom|Res|Mol|Obj|All>

-

Calculate volumes

° 

Soup content - List, count and compare units, get boundaries

List the properties of atoms to objects, including names, numbers and secondary structure, count how many units are contained in a selection, find differences between selections , determine the first and last atom or object spanning a selection and sum up atom masses.

° 

Compare<Atom|Res>

-

Compare selections

° 

Count<Atom|Res|Mol|Obj>

-

Count selected units

° 

List<Atom|Res|Mol|Obj>

-

List selection

° 

Mass<Atom|Res|Mol|Obj|All>

-

Calculate mass

° 

Span<Atom|Res|Obj>

-

Determine first and last unit spanning a selection

° 

Checks

-

Search for errors

° 

Check<Atom|Res|Obj|All>

-

Check structure quality

° 

SolvDensity

-

Get solvent density in simulation cell

° 

View

-

Change the appearance of the soup


° 

Colors

-

Add a fourth dimension to your figures

In addition to coloring atoms , you can also change the colors of covalent bonds , hydrogen bonds and the background . The default colors for chemical elements, secondary structure, B-factors etc. can also be adjusted.

° 

ColorBonds

-

Color bonds

° 

ColorBG

-

Color background

° 

ColorPar

-

Set default color parameters

° 

Color<Atom|Res|Mol|Obj|All>

-

Set/get atom colors

° 

Visibility

-

Show and hide, switch on and off

° 

Hide<Atom|Res|Mol|Obj|All>

-

Hide atoms

° 

Show<Atom|Res|Mol|Obj|All>

-

Show atoms

° 

Switch<Obj|All>

-

Switch objects on/off

° 

Style

-

Display atoms as balls, balls&sticks, sticks and traces

Display atoms as space filling balls (CPK), balls of a certain radius connected with sticks or just plain sticks of a given radius. Show and hide a trace through a selection of atoms (e.g. Calpha atoms). When showing a trace, it may help to additionally hide atoms that are not traced.

° 

BallRadius

-

Set ball radius in balls&sticks

° 

BallStick<Atom|Res|Mol|Obj|All>

-

Style atoms as balls&sticks

° 

Ball<Atom|Res|Mol|Obj|All>

-

Style atoms as balls

° 

HideTrace

-

Hide trace through atoms

° 

PointPar

-

Set point and line radius and plasticity in wire frames

° 

ShowTrace

-

Show trace through atoms

° 

StickRadius

-

Set stick radius

° 

Stick<Atom|Res|Mol|Obj|All>

-

Style atoms as sticks

° 

Style

-

Set general display style

° 

Secondary structure - Show tubes, ribbons and cartoons

° 

HideSecStr<Res|Mol|Obj|All>

-

Hide secondary structure

° 

SecStrPar

-

Set secondary structure display parameters

° 

SecStr<Res|Mol|Obj|All>

-

Set/get secondary structure

° 

ShowSecStr<Res|Mol|Obj|All>

-

Show secondary structure

° 

Surfaces

-

Show VdW, molecular and solvent accessible surfaces

Show or hide three kinds of surfaces at various resolutions , color them afterwards or extract fragments by defining a surface environment .

° 

ColorSurf<Obj|All>

-

Color surface

° 

HideSurf<Atom|Res|Mol|Obj|All>

-

Hide surface

° 

ShowSurf<Atom|Res|Mol|Obj|All>

-

Show surface

° 

SurfPar

-

Set/get surface parameters

° 

Hydrogen bonds - Show hydrogen bonds

Show or hide all hydrogen bonds made by selected atoms and choose their color and transparency level.

° 

ColorHBo

-

Color hydrogen bonds

° 

HideHBo<Atom|Res|Mol|Obj|All>

-

Hide hydrogen bonds

° 

ShowHBo<Atom|Res|Mol|Obj|All>

-

Show hydrogen bonds

° 

Atoms

-

Choose atom styles

Set the overall atom size , attach various textures to the atoms , and toggle the display of the chemical element symbol or a whobbling plasma inside those atoms that are cut open by the viewplane.

° 

AtomPlasma

-

Switch plasma inside atoms on/off

° 

AtomSize

-

Set size of atoms

° 

AtomSymbol

-

Switch element symbol inside atoms on/off

° 

AtomTexture

-

Set texture style of atoms

° 

Projection

-

Switch the perspective

Switch between perspective and parallel projection .

° 

Projection

-

Set perspective or parallel projection

° 

Lighting

-

Light the scene

Configure the lightsource including shadows and ambient influence, and add fog of a certain color to the scene.

° 

ColorFog

-

Color fog

° 

Fog

-

Set fog density

° 

LightSource

-

Configure the light source

° 

Effects

-

Change and animate the scene


° 

Position

-

Place and move objects

Choose object positions on an absolute or relative scale (including polygon meshes), grab either one, the next or the previous object for movement with mouse and Spaceball, or let them move automatically in a certain direction or to a certain spot.

° 

AutoMoveTo<Obj|All>

-

Move objects or scene automatically to a certain location

° 

AutoMove<Obj|All>

-

Move objects or scene automatically

° 

GrabNext

-

Grab next object for mouse movement

° 

GrabPrev

-

Grab previous object for mouse movement

° 

Grab<Obj|All>

-

Grab object or scene for mouse movement

° 

MoveMesh

-

Move polygon mesh

° 

Move<Atom|Res|Mol|Obj|All>

-

Move atoms, objects or scene

° 

Pos<Obj|All>

-

Set/get object or scene position

° 

Orientation

-

Orient and rotate objects

° 

AutoRotateTo<Obj|All>

-

Rotate objects or scene automatically to a certain orientation

° 

AutoRotate<Obj|All>

-

Rotate objects or scene automatically

° 

NiceOri<Obj|All>

-

Orient objects nicely

° 

Ori<Obj|All>

-

Set/get object or scene orientation

° 

Rotate<Obj|All>

-

Rotate objects or scene

° 

Labels

-

Display text labels

° 

LabelDis

-

Label atom distances

° 

LabelPar

-

Set label parameters

° 

Label<Atom|Res|Seg|Mol|Obj|All>

-

Add labels

° 

UnlabelDis

-

Delete distances labels

° 

Unlabel<Atom|Res|Seg|Mol|Obj|All>

-

Delete labels

° 

Marks and zooms - Mark atoms with fireflies and zoom in

Mark one atom and display its properties in the head up display, then zoom in closely on one or more atoms .

° 

MarkAtom

-

Mark atom with fireflies

° 

Zoom<Atom|Res|Mol|Obj|All>

-

Zoom in on atoms

° 

Arrows

-

Show arrows connecting atoms or points

° 

HideArrow<Atom|Res|Mol|Obj|All>

-

Hide arrows

° 

ShowArrow

-

Show arrows between atoms or points

° 

Solids

-

Show spheres, boxes, pyramids, cylinders, tori and others

° 

ShowBox

-

Show a rectangular box

° 

ShowCone

-

Show a cone, cylinder, pyramid or prism

° 

ShowSphere

-

Show a sphere or ellipsoid

° 

ShowTorus

-

Show a torus

° 

Images

-

Show and animate bitmaps

° 

AnimateImage

-

Animate appearance and disappearance of images

° 

AutoMoveImage

-

Move images automatically

° 

DelImage

-

Delete images

° 

HideImage

-

Hide images

° 

ImageFog

-

Switch image fog on/off

° 

LoadBMP

-

Load image from BMP file

° 

LoadPNG

-

Load image from PNG file

° 

MakeImageObj

-

Make object with attached image

° 

ShowImage

-

Show images

° 

SwapImage

-

Swap images

° 

UnrestImage

-

Let animated image disappear

° 

Text

-

Print text, possibly in 3D letters

By default, printing is done to the console. To get fancier text output, create a text object and redirect printing . Choose a font, possibly with fog , position the cursor, then print three-dimensional characters . When writing a plugin or macro, it sometimes helps to show a text message at the bottom and hide it afterwards, show a button to click or print to the top right head up display .

° 

Font

-

Set font for 3D letters

° 

FontFog

-

Switch font fog on/off

° 

HideMessage

-

Hide text message at the bottom

° 

MakeTextObj

-

Make text object to print 3D letters

° 

PosText

-

Position and justify text

° 

Print

-

Print text

° 

PrintCon

-

Print to console

° 

PrintHUD

-

Print to head up display

° 

PrintObj

-

Print to text object

° 

ShowButton

-

Show clickable button

° 

ShowMessage

-

Show text message at the bottom

° 

Options

-

Other commands


° 

Experiments

-

Let YASARA cook for you

Some things are non-trivial. Nevertheless, YASARA delivers the answer at the touch of the 'Experiment' button. During an experiment, YASARA takes over control and uses its 'artificial intelligence' to do various things in the right order. A message at the bottom will keep you informed. Some experiments accept additional parameters, look at the example macros to see how it works.

° 

Experiment

-

Choose and control experiments

° 

Macros

-

Watch YASARA do the work for you

Save YASARA's current state in a macro or record your input as a macro (excluding mouse movements), play back your own macros or those made by others with a higher stage of YASARA, stopping whenever you want. You can use the back/forward icons in the top right corner to jump around in the macro. Macros can wait for certain events before they continue, raise errors if something goes wrong, take a certain action if an error occurs, disallow user input, speedup animations if the graphics get slow , require a minimum YASARA version, and be applied to a certain target. You can save a lot of time by running macros in text console mode (start YASARA with command line parameter -con).

° 

Go

-

Go to another position in the macro

° 

MacroTarget

-

Set macro target

° 

OnError

-

Set error action

° 

PlayMacro

-

Play back macro

° 

PlayMovie

-

Play back macro as a movie

° 

RaiseError

-

Display error message

° 

RecordMacro

-

Record all following commands in a macro

° 

RequireVersion

-

Require a minimum YASARA version

° 

SaveMacro

-

Save a macro to restore the current state

° 

SpeedUp

-

Speed up movements when graphics are slow

° 

StopMacro

-

Stop macro playback or recording

° 

UserInput

-

Set user input

° 

Wait

-

Wait for certain time period or condition

° 

Tables

-

Collect, visualize and export data

° 

Tabulate

-

Add cells to table

° 

DelTab

-

Delete tables

° 

FlipTab

-

Flip table axes

° 

LoadTab

-

Load formatted table

° 

MakeTab

-

Make a table

° 

SaveTab

-

Save formatted table

° 

SelectTab

-

Select table to add cells

° 

ShowTab

-

Show table data as 3D object

° 

Tab

-

Set/get table cells

° 

Formats

-

Choose the residue output format

Many commands output a list of residues. Change the format for residue names if you log this output.

° 

FormatRes

-

Format residue output

° 

Logs

-

Redirect output to a file

Many YASARA commands, especially those in the Analyze section, write their output to the console. You can log all output or just the result of the next command to a file and stop logging at a later point.

° 

LogAs

-

Log output of next command

° 

RecordLog

-

Record all console output in a log file

° 

StopLog

-

Stop log recorder

° 

Plugins

-

Run plugins from a macro

Normally plugins are run by clicking on the options they add to the menus. In some rare cases, it may help to create a plugin input file and then run a plugin directly. If there is a bug in the plugin and it crashes, you must additionally stop it before it can be run again.

° 

RunPlugin

-

Run Python plugin

° 

SavePLI<Atom|Res|Mol|Obj>

-

Save plugin input file

° 

StopPlugin

-

Stop running plugin

° 

Default pH - Set the H+ ion concentration and residue pKas

YASARA normally assigns bond orders and protonation patterns according to pH 7.0. Here you can change this value and also assign pKas to certain residues, overriding YASARA's predictions made during the neutralization experiment.

° 

pH

-

Set/get default pH

° 

pKaRes

-

Set/get residue pKa

° 

Quantum mechanics - Configure YAPAC

YASARA provides semi-empirical quantum chemistry based on YAPAC, a derivative of James Stewart's MOPAC. Choose one of the MNDO, AM1 or PM3 methods, optimize geometries (possibly in water) and calculate formation energies .

° 

QuantumMechanics

-

Set quantum mechanics method

° 

Coordinate system - Live in a left or right handed world

YASARA's default is a left-handed coordinate system, feel free to live in a right-handed world .

° 

CoordSys

-

Set coordinate system

° 

Units

-

Choose your favorite units

By default, YASARA displays energies in kJ/mol. Here you can switch to kcal/mol .

° 

EnergyUnit

-

Set energy unit

° 

Parallel computations - Configure multi CPU core usage

Today's CPUs contain more than one core to speed up calculations. Here you can change the number of CPUs YASARA should use.

° 

Processors

-

Set/get number of processors to use

° 

Input devices - Configure the interaction with YASARA

Choose between three different pointer styles , change the function of the mouse wheel , activate the P5 data glove or configure the Spaceball and its buttons .

° 

MouseWheel

-

Assign command to mouse wheel

° 

P5

-

Set state of p5 data glove

° 

PointerStyle

-

Set style of mouse pointer

° 

SpaceballButton

-

Assign command to Spaceball button

° 

SpaceballPar

-

Set Spaceball parameters

° 

Shell

-

Execute shell commands

Change or print your current working directory, delete files, get their size or run any other shell command.

° 

CD

-

Change working directory

° 

DelFile

-

Delete file on disk

° 

FileSize

-

Get file size

° 

PWD

-

Print working directory

° 

Shell

-

Execute shell command

° 

Window

-

Change the display properties


° 

Location

-

Place the YASARA window

° 

FullScreen

-

Switch fullscreen mode on/off

° 

Screen

-

Fix YASARA window on a certain screen

° 

ScreenSize

-

Set/get window and fullscreen size

° 

Menus

-

Change the appearance of menus

° 

AnimateWin

-

Animate Windows

° 

HUD

-

Switch head up display

° 

Menu

-

Switch menu on/off

° 

SeqSelector

-

Switch sequence selector on/off

° 

StyleWin

-

Style Windows

° 

WinFont

-

Set window font

° 

WinTexture

-

Set window background texture

° 

Console

-

Configure the console

YASARA's command console can be extensively configured and hidden to speed up calculations and movies. Several console functions like copy/paste are explained here.

° 

Console

-

Switch console on/off

° 

ConsolePar

-

Set console parameters

° 

Antialiasing

-

Smooth is better

Toggle YASARA's built in antialiasing and note that it only affects atom balls. Activate fullscreen antialiasing separately in your OpenGL settings.

° 

Antialias

-

Switch antialiasing on/off

° 

Frequency

-

Change the frames per second and save battery power

Depending on the power of your computer, you can let YASARA update the screen more often or enter a special power saving mode when running on a notebook.

° 

FramesPerSec

-

Set screen update frequency

° 

Stereo

-

Time to touch your molecules

Choose a stereo mode and adjust the stereo parameters to let molecules fly out of the screen.

° 

Stereo

-

Set stereo mode

° 

StereoPar

-

Set stereo parameters

° 

Help

-

Access the documentation and solve problems


° 

Manual

-

Browse the HTML documentation

° 

SearchDoc

-

Search documentation

° 

ShowCom

-

Show command description

° 

ShowDoc

-

Show documentation

° 

Installation

-

Download missing programs

YASARA uses other programs to perform additional tasks, here you can install them.

° 

Install

-

Install accessory program

° 

Index

-

All commands in alphabetic order


° 

Recipes

-

Answer complex questions


° 

Run molecular dynamics simulations


° 

Preparing the topology

° 

Preparing the force field


° 

Deriving new (Y)AMBER force field parameters

° 

Deriving new NOVA force field parameters

° 

Running a simulation

° 

Analyzing a trajectory

° 

Playing back a trajectory

° 

Refine a homology model


° 

The quick method: in vacuo energy minimization with the NOVA force field

° 

The slow method: explicit solvent molecular dynamics simulation with the YAMBER force field

° 

Solve an NMR structure


° 

Setting the parameters

° 

Folding the structure

° 

Refining the structure in vacuo

° 

Refining the structure in explicit solvent

° 

Analyzing the ensemble

° 

Handling special cases like Cys-bridges, oligomers and metalloproteins

° 

Avoiding problems with hydrogen nomenclature

° 

Making floating assignments

° 

Create your own YASARA Movies


° 

Movies are written in Yanaconda

° 

Movies are stored in the yasara/mov directory

° 

Movies start with typical commands

° 

Movies can wait for a specified time or until you press a button

° 

Labels allow to jump back and forth between movie sections

° 

Work with YASARA and your text editor in parallel

° 

Movies can be imported from OpenOffice or PowerPoint

° 

Bitmap images can be displayed and animated

° 

Text can be displayed using 3D letters

° 

The look of the movie depends on the aspect ratio of the YASARA window

° 

Hints for using movies in important presentations


° 

Macros

-

Automate your work with Yanaconda


° 

Macros can be recorded or written manually

° 

Yanaconda is Yet ANother Abridged COding 'N' Development Approach

° 

Yanaconda is a reinterpreted language

° 

Explicit evaluators modify the source code at run time

° 

When writing Yanaconda macros, use Python syntax highlighting

° 

The four datatypes are integer, float, weak string and strong string


° 

Integers remember the number of leading zeroes

° 

Floats remember their precision

° 

Weak strings are enclosed by single quotes

° 

Strong strings are enclosed by double quotes

° 

The left operand defines the datatype of the result

° 

Yanaconda supports the usual operators


° 

The negation operator has the maximum priority 7: !, not

° 

Operators with priority 6: *, /, //, %, <<, >>

° 

Operators with priority 5: +, -

° 

Operators with priority 4: &, |, ^

° 

Operators with priority 3: >, >=, <=, <, ==, !=

° 

Operators with priority 2: in

° 

Operators with minimum priority 1: and, or

° 

Indentation defines the program flow and must be a multiple of two spaces

° 

Control the program flow with if, elif and else

° 

There are four types of loops


° 

Loops can run over a range of numbers: for i = X to Y step Z

° 

Loops can run over a list: for i in X,Y,Z,..

° 

Loops can run while an expression is true: while X and do .. while X

° 

Stop a loop with 'break'

° 

Loop ahead with 'continue'

° 

Lists are emulated with explicit evaluators


° 

Matrices are two dimensional lists

° 

The 'count' function determines the length of lists

° 

The 'min', 'max', 'sum', 'mean', 'stddev' and 'join' functions return the smallest, largest, sum, mean, standard deviation and concatenation of all list elements

° 

Lists can be sorted

° 

Yanaconda macros can access predefined variables

° 

Yanaconda macros can include each other

° 

Calls to built in functions can be placed anywhere within an expression

° 

Calls to YASARA commands must appear one per line

° 

Macros can be speeded up by switching off the console


° 

Plugins

-

Extend YASARA with your own functions


° 

Plugins allow you to add your own menu options

° 

Plugins can be written in Yanaconda or Python

° 

Python can be downloaded from www.python.org

° 

Plugins must stick to format conventions


° 

The header identifies a plugin

° 

The menu structure is enclosed in a triple-quote comment


° 

MainMenu

-

Add an option to the top menu line

° 

AtomContextMenu

-

Add an option to the atom context menu

° 

ResidueContextMenu

-

Add an option to the residue context menu

° 

PullDownMenu

-

Add an option to a pull-down menu

° 

PopUpMenu

-

Add an option to a pop-up menu

° 

ObjectSelectionMenu

-

Add a menu allowing to select objects

° 

MoleculeSelectionMenu

-

Add a menu allowing to select molecules

° 

ResidueSelectionMenu

-

Add a menu allowing to select residues

° 

AtomSelectionMenu

-

Add a menu allowing to select atoms

° 

TextInputMenu[1-4]

-

Add a menu allowing to input 1 to 4 text strings

° 

NumberInputMenu[1-6]

-

Add a menu allowing to input 1 to 6 numbers

° 

SwitchBoxMenu[1-5]

-

Add a menu allowing to switch between 1 to 5 options

° 

CheckBoxMenu[1-5]

-

Add a menu allowing to toggle 1 to 5 options

° 

ListMenu

-

Add a menu allowing to select from a list

° 

FileSelectionMenu

-

Add a menu allowing to select files

° 

The layout for the remaining plugin differs between Python and Yanaconda

° 

Plugins can access most YASARA functions

° 

Python plugins can access a number of predefined variables


° 

Object descriptors identify selected objects

° 

Molecule descriptors identify selected molecules

° 

Residue descriptors identify selected residues

° 

Atom descriptors identify selected atoms

° 

Python plugins run in a separate thread

° 

Plugins can be speeded up by switching off the console

° 

Plugins can be run from the command line and in console mode

° 

Debugging is done by adding temporary print commands


° 

Scripts

-

Use YASARA as a Python module


° 

Windows users can obtain Python from www.python.org

° 

Copy and import yasara/pym/yasara.py

° 

There is a Python function wrapper for most YASARA commands

° 

Python functions return either nothing, a single value or a list

° 

YASARA specific data is available in 'info'

° 

YASARA commands with multiple formats map to different Python functions

° 

A subset of the YASARA soup can be obtained as a pdb_file instance

° 

The console needs to be switched off for maximum performance

° 

There is a specific Python function for each experiment

° 

The Python module can run YASARA in graphics or text mode


° 

Troubleshooting

-

Get things going


° 

Known inconveniences

° 

YASARA cannot be installed


° 

The message './install_yasara: No such file or directory' appears in the Linux terminal

° 

YASARA does not start


° 

YASARA does not start from CD

° 

You are using Windows and nothing happens when you start YASARA

° 

A message about /dev/nvidiactl permission problems appears in the Linux terminal

° 

'Killed' or 'Segmentation fault' appears in the Linux terminal

° 

'Error while loading shared libraries' appears in the Linux terminal

° 

A red box appears: Error 2 - Essential videomode not supported under Linux

° 

A red box appears: Error 53 or 353 - No vector registers available or wrong CPU architecture

° 

A red box appears: Error 93 - Center of YASARA window off screen

° 

The YASARA windows stays empty and black in Linux

° 

YASARA displays an error-like message in the terminal


° 

The message '*** Assertion failure in -[NSEvent deviceDeltaX]' appears in the terminal

° 

The message 'Disabled smooth atom colors' appears in the terminal

° 

The message 'disabling TCL support' appears in the terminal

° 

The message 'libgcc_s.so.1 must be installed for pthread_cancel to work' appears in the terminal

° 

The message 'libGL warning: 3D driver claims to not support visual 0x4b' appears in the terminal

° 

The message 'Mesa X.Y.Z implementation error' appears in the terminal

° 

The message 'XFree86-DRI missing' appears in the terminal

° 

YASARA gets stuck in the startup screen

° 

YASARA displays a warning at the bottom of the startup screen


° 

Warning

-

Python not found

° 

Warning

-

Screen update not synchronized

° 

YASARA crashes right after the startup screen

° 

Something is wrong with the user interface


° 

YASARA crashes completely when you activate a menu

° 

It takes too long till the menu appears

° 

When the menu appears, the colors turn crazy

° 

Some menu entries are missing

° 

The mouse pointer disappears or flickers

° 

Some keys do not work as expected

° 

The Spaceball 3D controller does not work as expected

° 

YASARA runs slowly or displays incorrect graphics


° 

You have an unknown graphics cards, it is relatively old or has less than 16MB video memory

° 

You are running Windows Vista

° 

You are running Windows with an nVIDIA card

° 

You are running Windows with an ATI Radeon card

° 

You are running Linux with an nVIDIA card

° 

You are running Linux with an ATI Radeon card

° 

You are running Linux with a Xig graphics driver

° 

You are using a notebook

° 

You have an Intel 82845G graphics chip

° 

You have an Intel 82865G graphics chip

° 

You have an Intel 82915G graphics chip

° 

You have an S3 graphics chip

° 

You have a SiS M650 graphics chip

° 

You have a 3DLabs Wildcat card

° 

YASARA shows strange CPU usage patterns or crashes on dual core CPUs or dual CPU systems

° 

Something is wrong with your molecule


° 

You used OpenBabel ('other Fileformat') to read/write the molecule

° 

YASARA does not behave as expected with two or more connected monitors

° 

Quad-buffered stereo cannot be activated or flickers.

° 

YASARA fails to run Python plugins or other programs like PovRay, OpenBabel, MSMS

° 

YASARA or the entire computer freezes


° 

YASARA hangs, but other programs are not affected

° 

The computer freezes when you minimize the YASARA window

° 

The computer freezes when you start YASARA a second time

° 

YASARA quits with a red error box or crashes sometime later

° 

The Twinset encounters a technical problem

° 

Forwarding the YASARA window via SSH does not work