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.potential; 39 40 import ffx.potential.bonded.Atom; 41 import ffx.potential.bonded.MSNode; 42 import ffx.potential.bonded.MultiResidue; 43 import ffx.potential.bonded.Residue; 44 import ffx.potential.bonded.ResidueState; 45 import java.util.ArrayList; 46 import java.util.List; 47 48 /** 49 * The AssemblyState class stores the chemical and coordinate state of a Molecular Assembly. Not 50 * robust to any chemical perturbation except for mutation of MultiResidues. 51 * 52 * @author Michael J. Schnieders 53 * @author Jacob M. Litman 54 * @since 1.0 55 */ 56 public class AssemblyState { 57 private final MolecularAssembly mola; 58 private final Residue[] residues; 59 private final ResidueState[] resStates; 60 private final Atom[] otherAtoms; 61 private final double[][] otherCoords; 62 63 /** 64 * Construct a snapshot of a MolecularAssembly. Currently accounts for the coordinates of all 65 * entities, and the chemical state of MultiResidues. Does not include velocities, etc. 66 * 67 * @param assembly To store state of. 68 */ 69 public AssemblyState(MolecularAssembly assembly) { 70 mola = assembly; 71 72 List<Residue> residueList = mola.getResidueList(); 73 List<Residue> copyResList = new ArrayList<>(residueList); 74 // Remove all Residue nodes, including subnodes of a MultiResidue, from otherNodeList. 75 List<MSNode> otherNodeList = mola.getNodeList(); 76 otherNodeList.removeAll(residueList); 77 78 // Remove any Residue nodes which are beneath a MultiResidue. 79 for (Residue res : copyResList) { 80 if (res instanceof MultiResidue) { 81 List<Residue> subResidues = ((MultiResidue) res).getConsideredResidues(); 82 residueList.removeAll(subResidues); 83 } 84 } 85 86 residues = residueList.toArray(new Residue[0]); 87 resStates = ResidueState.storeAllCoordinates(residues); 88 89 List<Atom> otherAtomList = new ArrayList<>(); 90 for (MSNode node : otherNodeList) { 91 otherAtomList.addAll(node.getAtomList()); 92 } 93 int nOtherAtoms = otherAtomList.size(); 94 otherAtoms = new Atom[nOtherAtoms]; 95 otherAtomList.toArray(otherAtoms); 96 otherCoords = ResidueState.storeAtomicCoordinates(otherAtoms); 97 } 98 99 /** 100 * Copies an AssemblyState. Note: side effects possible if they occur between applying the state 101 * to be copied and reverting to the pre-method-call state. 102 * 103 * @param state AssemblyState to copy. 104 * @return A copied AssemblyState. 105 */ 106 public static AssemblyState copyState(AssemblyState state) { 107 MolecularAssembly assembly = state.getMolecularAssembly(); 108 AssemblyState orig = new AssemblyState(assembly); 109 state.revertState(); 110 AssemblyState copiedState = new AssemblyState(assembly); 111 orig.revertState(); 112 return copiedState; 113 } 114 115 /** 116 * Returns the MolecularAssembly associated with this AssemblyState. 117 * 118 * @return The associated MolecularAssembly. 119 */ 120 public MolecularAssembly getMolecularAssembly() { 121 return mola; 122 } 123 124 /** 125 * Revert the state of the associated MolecularAssembly, assuming no chemical changes were made 126 * except to MultiResidues. 127 */ 128 public void revertState() { 129 int nResidues = residues.length; 130 for (int i = 0; i < nResidues; i++) { 131 residues[i].revertState(resStates[i]); 132 } 133 134 int nOthers = otherAtoms.length; 135 for (int i = 0; i < nOthers; i++) { 136 otherAtoms[i].setXYZ(otherCoords[i]); 137 } 138 } 139 }