Action: PRINT

Module	generic
Description	Usage
Print quantities to a file.
This action outputs data to a file. You can read more about how PLUMED manages output files here

Input

The arguments that serve as the input for this action are specified using one or more of the keywords in the following table.

Further details and examples

Print quantities to a file.

This command can be used to output quantities to a file. The following demonstrates a very simple example:

Click on the labels of the actions for more information on what each action computes

dThe DISTANCE action with label d calculates the following quantities:
 Quantity   
 Type   
 Description  
d
scalar
the DISTANCE between this pair of atoms: DISTANCECalculate the distance/s between pairs of atoms. More details ATOMSthe pair of atom that we are calculating the distance between=1,2
PRINTPrint quantities to a file. More details ARGthe labels of the values that you would like to print to the file=d FILEthe name of the file on which to output these quantities=colvar

This command outputs the distance between atom 1 and 2 to a file called colvar every step of trajectory. If you want to output the distance less frequently you can use the STRIDE keyword as illustrated below:

Click on the labels of the actions for more information on what each action computes

dThe DISTANCE action with label d calculates the following quantities:
 Quantity   
 Type   
 Description  
d
scalar
the DISTANCE between this pair of atoms: DISTANCECalculate the distance/s between pairs of atoms. More details ATOMSthe pair of atom that we are calculating the distance between=1,2
PRINTPrint quantities to a file. More details ARGthe labels of the values that you would like to print to the file=d FILEthe name of the file on which to output these quantities=colvar STRIDE the frequency with which the quantities of interest should be output=10

With the input above the distance is only output on every 10th step. Notice this distance will only be calculated on every step as this quantity is not used on every other step.

You can also use the PRINT command to output objects that have a rank that is greater than zero. For example, the following input calculates a vector of three distances. These three distances are then output to the output colvar file every step.

Click on the labels of the actions for more information on what each action computes

dThe DISTANCE action with label d calculates the following quantities:
 Quantity   
 Type   
 Description  
d
vector
the DISTANCE for each set of specified atoms: DISTANCECalculate the distance/s between pairs of atoms. More details ATOMS1the pair of atom that we are calculating the distance between=1,2 ATOMS2the pair of atom that we are calculating the distance between=3,4 ATOMS3the pair of atom that we are calculating the distance between=5,6
PRINTPrint quantities to a file. More details ARGthe labels of the values that you would like to print to the file=d FILEthe name of the file on which to output these quantities=colvar

Alterantively, we can output a matrix by using an input like the one shown below:

Click on the labels of the actions for more information on what each action computes

dThe DISTANCE_MATRIX action with label d calculates the following quantities:
 Quantity   
 Type   
 Description  
d
matrix
a matrix containing the weights for the bonds between each pair of atoms: DISTANCE_MATRIXCalculate a matrix of distances between atoms. This action has hidden defaults. More details GROUPthe atoms for which you would like to calculate the adjacency matrix=1-4
d: DISTANCE_MATRIXCalculate a matrix of distances between atoms. This action uses the defaults shown here. More details GROUPthe atoms for which you would like to calculate the adjacency matrix=1-4  NL_CUTOFF The cutoff for the neighbor list=0.0 NL_STRIDE The frequency with which we are updating the atoms in the neighbor list=1 CUTOFF ignore distances that have a value larger than this cutoff=-1
PRINTPrint quantities to a file. More details ARGthe labels of the values that you would like to print to the file=d FILEthe name of the file on which to output these quantities=colvar

The output colvar file here will contain the 16 elements of the matrix on each line output. You can also use PRINT to output functions on grids. However, you are probably better using DUMPGRID or DUMPCUBE to output functions on grids.

The PRINT directive can be used multiple times in the input so you can print files with different strides or print different quantities to different files as illustrated in the example input below:

Click on the labels of the actions for more information on what each action computes

# compute distance:
distanceThe DISTANCE action with label distance calculates the following quantities:
 Quantity   
 Type   
 Description  
distance
scalar
the DISTANCE between this pair of atoms: DISTANCECalculate the distance/s between pairs of atoms. More details ATOMSthe pair of atom that we are calculating the distance between=2,5
# compute total energy (potential)
energyThe ENERGY action with label energy calculates the following quantities:
 Quantity   
 Type   
 Description  
energy
scalar
the internal energy: ENERGYCalculate the total potential energy of the simulation box. More details
# print distance on a file
PRINTPrint quantities to a file. More details ARGthe labels of the values that you would like to print to the file=distance          STRIDE the frequency with which the quantities of interest should be output=10   FILEthe name of the file on which to output these quantities=COLVAR
# print both variables on another file
The PRINT action with label  calculates somethingPRINTPrint quantities to a file. More details ARGthe labels of the values that you would like to print to the file=distance,energy   STRIDE the frequency with which the quantities of interest should be output=1000 FILEthe name of the file on which to output these quantities=COLVAR_ALL

The input above instructs plumed to print the distance between atoms 3 and 5 on a file called COLVAR every 10 steps, and the distance and total energy on a file called COLVAR_ALL every 1000 steps.

You can control the buffering of output using the FLUSH keyword. Furthermore, whether the output file is appended or backed up depends on whetehr or not the RESTART action is present on the file. If you add RESTART=yes on the line containing the PRINT directive the file will be appended also.

Printing happens in the so-called "update" phase. This implies that printing is affected by the presence of UPDATE_IF actions. One can thus decide to start and stop printing at preassigned values of time using the UPDATE_FROM and UPDATE_UNTIL keywords. Keep into account that even on steps when the action is not updated (and thus the file is not printed) the argument will be activated. In other words, if you use UPDATE_FROM to start printing at a given time, the collective variables this PRINT statement depends on will be computed also before that time.

Syntax

The following table describes the keywords and options that can be used with this action