View Javadoc
1   // ******************************************************************************
2   //
3   // Title:       Force Field X.
4   // Description: Force Field X - Software for Molecular Biophysics.
5   // Copyright:   Copyright (c) Michael J. Schnieders 2001-2024.
6   //
7   // This file is part of Force Field X.
8   //
9   // Force Field X is free software; you can redistribute it and/or modify it
10  // under the terms of the GNU General Public License version 3 as published by
11  // the Free Software Foundation.
12  //
13  // Force Field X is distributed in the hope that it will be useful, but WITHOUT
14  // ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
15  // FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
16  // details.
17  //
18  // You should have received a copy of the GNU General Public License along with
19  // Force Field X; if not, write to the Free Software Foundation, Inc., 59 Temple
20  // Place, Suite 330, Boston, MA 02111-1307 USA
21  //
22  // Linking this library statically or dynamically with other modules is making a
23  // combined work based on this library. Thus, the terms and conditions of the
24  // GNU General Public License cover the whole combination.
25  //
26  // As a special exception, the copyright holders of this library give you
27  // permission to link this library with independent modules to produce an
28  // executable, regardless of the license terms of these independent modules, and
29  // to copy and distribute the resulting executable under terms of your choice,
30  // provided that you also meet, for each linked independent module, the terms
31  // and conditions of the license of that module. An independent module is a
32  // module which is not derived from or based on this library. If you modify this
33  // library, you may extend this exception to your version of the library, but
34  // you are not obligated to do so. If you do not wish to do so, delete this
35  // exception statement from your version.
36  //
37  // ******************************************************************************
38  package ffx.algorithms.groovy;
39  
40  import ffx.algorithms.groovy.test.OSTGradient;
41  import ffx.algorithms.misc.AlgorithmsTest;
42  import org.apache.commons.math3.util.FastMath;
43  import org.junit.Test;
44  import org.junit.runner.RunWith;
45  import org.junit.runners.Parameterized;
46  import org.junit.runners.Parameterized.Parameters;
47  
48  import java.util.Arrays;
49  import java.util.Collection;
50  
51  import static java.lang.Math.random;
52  import static org.apache.commons.math3.util.FastMath.floor;
53  import static org.junit.Assert.assertEquals;
54  
55  /** @author Michael J. Schnieders */
56  @RunWith(Parameterized.class)
57  public class OSTGradientTest extends AlgorithmsTest {
58  
59    private String info;
60    private String filename;
61    private int nAtoms;
62    private double tolerance = 1.0e-2;
63  
64    public OSTGradientTest(String info, String filename, int nAtoms) {
65      this.info = info;
66      this.filename = filename;
67      this.nAtoms = nAtoms;
68    }
69  
70    @Parameters
71    public static Collection<Object[]> data() {
72      return Arrays.asList(
73          new Object[][] {
74              {
75                  "C23 OST Test", // info
76                  "compound23.xyz", // filename
77                  43 // Number of atoms.
78              }
79          });
80    }
81  
82    @Test
83    public void testOSTBiasHelp() {
84      // Set-up the input arguments for the script.
85      String[] args = {"-h"};
86      binding.setVariable("args", args);
87  
88      // Construct and evaluate the script.
89      OSTGradient ostGradient = new OSTGradient(binding).run();
90      algorithmsScript = ostGradient;
91    }
92  
93    @Test
94    public void testOSTGradient() {
95  
96      double lambda = random();
97      int atomID = (int) floor(FastMath.random() * nAtoms) + 1;
98  
99      // Set-up the input arguments for the script.
100     String[] args = {
101         "--ac", "ALL",
102         "-l", Double.toString(lambda),
103         "--ga", Integer.toString(atomID),
104         getResourcePath(filename)
105     };
106     binding.setVariable("args", args);
107 
108     // Construct and evaluate the script.
109     OSTGradient ostGradient = new OSTGradient(binding).run();
110     algorithmsScript = ostGradient;
111 
112     double dUdLError = ostGradient.dUdLError;
113     double nFailures = ostGradient.nFailures;
114 
115     // Assert that energy is conserved at the end of the dynamics trajectory.
116     assertEquals(info + ": dUdL error: ", 0.0, dUdLError, tolerance);
117     assertEquals(info + ": Number of coordinate gradient errors: ", 0, nFailures, 0);
118   }
119 
120   @Test
121   public void testMetaDynamicsGradient() {
122 
123     double lambda = random();
124     int atomID = (int) floor(FastMath.random() * nAtoms) + 1;
125 
126     // Set-up the input arguments for the script.
127     String[] args = {
128         "--ac", "ALL",
129         "--meta",
130         "-l", Double.toString(lambda),
131         "--ga", Integer.toString(atomID),
132         getResourcePath(filename)
133     };
134     binding.setVariable("args", args);
135 
136     // Construct and evaluate the script.
137     OSTGradient ostGradient = new OSTGradient(binding).run();
138     algorithmsScript = ostGradient;
139 
140     double dUdLError = ostGradient.dUdLError;
141     double nFailures = ostGradient.nFailures;
142 
143     // Assert that energy is conserved at the end of the dynamics trajectory.
144     assertEquals(info + ": dUdL error: ", 0.0, dUdLError, tolerance);
145     assertEquals(info + ": Number of coordinate gradient errors: ", 0, nFailures, 0);
146   }
147 }