File: periodicBoundary.C

package info (click to toggle)
ball 1.5.0%2Bgit20180813.37fc53c-3
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 239,848 kB
  • sloc: cpp: 326,149; ansic: 4,208; python: 2,303; yacc: 1,778; lex: 1,099; xml: 958; sh: 322; makefile: 93
file content (542 lines) | stat: -rw-r--r-- 15,054 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
// -*- Mode: C++; tab-width: 2; -*-
// vi: set ts=2:
//

#include <BALL/MOLMEC/COMMON/periodicBoundary.h>
#include <BALL/MOLMEC/COMMON/forceField.h>
#include <BALL/MOLMEC/COMMON/support.h>
#include <BALL/STRUCTURE/geometricProperties.h>
#include <BALL/STRUCTURE/geometricTransformations.h>
#include <BALL/SYSTEM/path.h>
#include <BALL/CONCEPT/processor.h>
#include <BALL/FORMAT/HINFile.h>
#include <BALL/MATHS/common.h>
#include <BALL/KERNEL/system.h>
#include <BALL/KERNEL/PTE.h>

using namespace std;

namespace BALL 
{

	const char* PeriodicBoundary::Option::PERIODIC_BOX_LOWER = "periodic_box_lower";
	const char* PeriodicBoundary::Option::PERIODIC_BOX_UPPER = "periodic_box_upper";
	const char* PeriodicBoundary::Option::PERIODIC_BOX_ENABLED = "periodic_box_enabled";
	const char* PeriodicBoundary::Option::PERIODIC_BOX_DISTANCE = "periodic_box_distance";
	const char* PeriodicBoundary::Option::PERIODIC_BOX_ADD_SOLVENT = "periodic_box_add_solvent";
	const char* PeriodicBoundary::Option::PERIODIC_BOX_SOLVENT_FILE = "periodic_box_solvent_file";
	const char* PeriodicBoundary::Option::PERIODIC_BOX_SOLVENT_SOLUTE_DISTANCE = "periodic_box_solvent_solute_distance";
	const char* PeriodicBoundary::Option::PERIODIC_WATER_FILE = "periodic_water_file";
 
	const bool    PeriodicBoundary::Default::PERIODIC_BOX_ENABLED = false;
	const float   PeriodicBoundary::Default::PERIODIC_BOX_DISTANCE = 5.0;
	const bool    PeriodicBoundary::Default::PERIODIC_BOX_ADD_SOLVENT = true;
	const char*   PeriodicBoundary::Default::PERIODIC_BOX_SOLVENT_FILE = "solvents/water.hin";
	const float   PeriodicBoundary::Default::PERIODIC_BOX_SOLVENT_SOLUTE_DISTANCE = 2.3;
	const char*   PeriodicBoundary::Default::PERIODIC_WATER_FILE = "solvents/water.hin";

	// Default Constructor
	PeriodicBoundary::PeriodicBoundary()
		:	options(0),
			force_field_(0), 
			enabled_(false)
	{
	}

	// Constructor
	PeriodicBoundary::PeriodicBoundary(const ForceField& force_field)
		: options(const_cast<Options*>(&force_field.options)),
			force_field_(const_cast<ForceField*>(&force_field)), 
			enabled_(false)
	{
	}

	// Copy Constructor
	PeriodicBoundary::PeriodicBoundary(const PeriodicBoundary& periodic_boundary)
		: options(periodic_boundary.options), 
			force_field_(periodic_boundary.force_field_), 
			enabled_(periodic_boundary.enabled_),
			box_(periodic_boundary.box_), 
			molecules_(periodic_boundary.molecules_)
	{
	}

	// Clear method
	void PeriodicBoundary::clear()
		
	{
		options = 0;
		force_field_ = 0;
		enabled_ = false;
		box_.clear();
		molecules_.clear();
	}

	// Destructor
	PeriodicBoundary::~PeriodicBoundary()
	{
		clear();
	}

	// assignment operator
	PeriodicBoundary& PeriodicBoundary::operator = (const PeriodicBoundary& periodic_boundary)
	{
		// avoid self assignment
		if (&periodic_boundary != this)
		{
			force_field_	= periodic_boundary.force_field_;
			enabled_	= periodic_boundary.enabled_;
			options		= periodic_boundary.options;
			box_		= periodic_boundary.box_;
			molecules_	= periodic_boundary.molecules_;
		}

		return *this;
	}
 
	// Accessor for enabling periodic boundary
	void PeriodicBoundary::enable()
	{
		enabled_ = true;
	}

	// Accessor for disabling periodic boundary
	void PeriodicBoundary::disable()
	{
		enabled_ = false;
	}

	// Accessor for setting the box of the periodic boundary
	void PeriodicBoundary::setBox(const SimpleBox3& box)
	{
		box_.a = box.a;
		box_.b = box.b;
	}

	// Accessor for reading the box of the periodic boundary
	SimpleBox3 PeriodicBoundary::getBox() const
	{
		return box_;
	}

	//	Predicate for testing if the periodic boundary is enabled or not
	bool PeriodicBoundary::isEnabled() const
	{
		return enabled_;
	}

	// Accessor for updating the positions of the molecules:
	// If the center of gravity of a molecule lies outside the box of the
	// periodic boundary, the molecule is moved according to the periodic
	// boundary conditions.
	void PeriodicBoundary::updateMolecules()
	{
		// the mass of a molecule
		float mass;
		// the mass of one atom according to its type
		float atomic_mass;
		// the center of gravity of one molecule
		Vector3 center_of_gravity;
		// the atoms of the system
		AtomVector& atom = const_cast<AtomVector&>(force_field_->getAtoms());
		// 
		float shift_x = box_.b.x - box_.a.x;
		float shift_y = box_.b.y - box_.a.y;
		float shift_z = box_.b.z - box_.a.z;
		// flag indicating the need of a shift
		bool shift;
		// the actual translation which has to be performed
		Vector3 translation;

		AtomIndexArray::iterator it = molecules_.begin();

		// Iterate over all molecules stored in molecule_
		for (; it != molecules_.end(); ++it) 
		{
			mass = 0;
			shift = false;
			center_of_gravity.clear();
			translation.clear();

			// Iterate over all atoms of the molecule and calculate the center of
			// gravity 

			for (Size i = it->first; i < it->second; i++) 
			{
				atomic_mass = atom[i]->getElement().getAtomicWeight();
				mass += atomic_mass;
				center_of_gravity += (atom[i]->getPosition() * atomic_mass);
			}  
			center_of_gravity /= mass;

			// Test if the center of gravity is outside the box and determine 
			// the translation (according to the periodic boundary definition)
			// that moves the center of gravity back into the box.

			if (center_of_gravity.x < box_.a.x) 
			{
				translation.x += shift_x;
				shift = true;
			} 
			else if (center_of_gravity.x > box_.b.x) 
			{
				translation.x -= shift_x;
				shift = true;
			}

			if (center_of_gravity.y < box_.a.y) 
			{
				translation.y += shift_y;
				shift = true;
			} 
			else if (center_of_gravity.y > box_.b.y) 
			{
				translation.y -= shift_y;
				shift = true;
			}

			if (center_of_gravity.z < box_.a.z) 
			{
				translation.z += shift_z;
				shift = true;
			} 
			else if (center_of_gravity.z > box_.b.z) 
			{
				translation.z -= shift_z;
				shift = true;
			}

			// Translate the atoms of the molecule if it has to be shifted
			if (shift) 
			{
				for (Size i = it->first; i < it->second; i++) 
				{
					atom[i]->setPosition(atom[i]->getPosition() + translation);
				}
			}
		}
	}


	// Periodic boundary is enabled:
	// Generate molecules_ with the start and end indices of the atoms of the
	// molecules in atom_. 
	Size PeriodicBoundary::generateMoleculesVector()
	{
		vector<Atom*>::const_iterator it = force_field_->getAtoms().begin();
		Molecule* old_molecule = (*it)->getMolecule();
		Molecule* new_molecule;
		Size start = 0;
		Size end = 0;
		float mass = 0;

		molecules_.clear();

		for (; it != force_field_->getAtoms().end(); ++it, ++end) 
		{
			new_molecule = (*it)->getMolecule();
			if (new_molecule != old_molecule) 
			{
				if (end > start && mass != 0)
				{
					 molecules_.push_back(pair<Size,Size>(start,end));
				}

				start = end;
				old_molecule = new_molecule;
				mass = 0;
			} 
			else 
			{
				mass += (*it)->getElement().getAtomicWeight();
			}
		}

		return (Size)molecules_.size();
	}

	// Setup the periodic boundary	
	bool PeriodicBoundary::setup()
	{
		// we have no options from the force field: give up
		if (options == 0)
		{
			Log.warn() << "PeriodicBoundary not bound to a force field!" << endl;
			return false;
		}

		// check whether the box is enabled 
		if (options->has(Option::PERIODIC_BOX_ENABLED))
		{
			enabled_ = options->getBool(Option::PERIODIC_BOX_ENABLED);
		}

		// Periodic boundary not enabled
		if (!enabled_)
		{
			return true;
		}

		// set default values if necessary
		options->setDefaultBool(Option::PERIODIC_BOX_ENABLED, true);
		options->setDefault(Option::PERIODIC_BOX_SOLVENT_FILE, Default::PERIODIC_BOX_SOLVENT_FILE);
		options->setDefaultBool(Option::PERIODIC_BOX_ADD_SOLVENT,Default::PERIODIC_BOX_ADD_SOLVENT);
		options->setDefaultReal(Option::PERIODIC_BOX_DISTANCE, Default::PERIODIC_BOX_DISTANCE);
		options->setDefaultReal(Option::PERIODIC_BOX_SOLVENT_SOLUTE_DISTANCE, Default::PERIODIC_BOX_SOLVENT_SOLUTE_DISTANCE);
		options->setDefault(Option::PERIODIC_WATER_FILE, Default::PERIODIC_WATER_FILE);

		// first, check whether the box dimensions are already set
		if (options->has(Option::PERIODIC_BOX_LOWER) && options->has(Option::PERIODIC_BOX_UPPER))
		{

			// now check whether the options contain valid coordinates
			Vector3 tmp_lower = options->getVector(Option::PERIODIC_BOX_LOWER);
			Vector3 tmp_upper = options->getVector(Option::PERIODIC_BOX_UPPER);
			
			// store the box
			box_.set(tmp_lower, tmp_upper);
		} 
		else 
		{
			// we didn`t find box dimensions - perhaps we got a distance?

			if (options->has(Option::PERIODIC_BOX_DISTANCE))
			{
				float dist = options->getReal(Option::PERIODIC_BOX_DISTANCE);
				
				// make sure we have a system
				if (force_field_->getSystem() == 0)
				{
					Log.error() << "Force field has no system!" << endl;
					return false;
				}

				// the minimum distance has to be non-negative
				if (dist < 0)
				{
					Log.error() << "Minimum distance for periodic boundary is negative: " << dist << endl;
					return false;
				}

				// calculate the system`s bounding box 
				BoundingBoxProcessor p;
				const_cast<System*>(force_field_->getSystem())->apply(p);
				box_.a = p.getLower() - Vector3(dist);
				box_.b = p.getUpper() + Vector3(dist);
			
				Log.info() << "Creating periodic boundary with a minimum distance of " << dist << " Angstrom" << endl;
			}
		}
		
		
		// ensure that the box is non-degenerate
		if ((box_.a.x >= box_.b.x) || (box_.a.y >= box_.b.y) || (box_.a.z >= box_.b.z))
		{
			Log.error() << "Illegal coordinates for periodic boundary: " << box_.a << "/" << box_.b << endl;
			return false;
		}

		// check whether we should add water
		if (options->has(Option::PERIODIC_BOX_ADD_SOLVENT) && options->getBool(Option::PERIODIC_BOX_ADD_SOLVENT))
		{
			String filename(Option::PERIODIC_WATER_FILE);
			
			if (options->has(Option::PERIODIC_BOX_SOLVENT_FILE))
			{
				filename = options->get(Option::PERIODIC_BOX_SOLVENT_FILE);
			}
			
			// avoid further addition of water
			options->setBool(Option::PERIODIC_BOX_ADD_SOLVENT, false);


			// add the solvent
			try 
			{
				if (addSolvent(filename) == 0)
				{
					return false;
				}
			}
			catch (Exception::FileNotFound& e)
			{
				Log.error() << "PeriodicBoundary::setup: Solvent file not found: " << e.getName() << endl;
				return false;
			}
		}

		// store the box dimensions in the options
		options->setVector(Option::PERIODIC_BOX_LOWER, box_.a);
		options->setVector(Option::PERIODIC_BOX_UPPER, box_.b);
	
		return true;
	}

	// Fill the part of the box that contains no system atoms with solvent
	// molecules
	Size PeriodicBoundary::addSolvent(const String& filename)
	{
		// try to find and read the file
		Path p;
		HINFile hin(String(p.find(filename)));
		if (!hin.isValid())
		{
			throw Exception::FileNotFound(__FILE__, __LINE__, filename);
		}

		// remove old solvent molecules
		removeSolvent();

		// read the system
		System solvent;
		hin >> solvent;

		
		if (!hin.hasPeriodicBoundary())
		{
			Log.error() << "Solvent file " << hin.getName() 
									<< " does not contain a periodic boundary!" << endl;
			return 0;
		}
		
		SimpleBox3 solvent_box = hin.getPeriodicBoundary();

		// calculate the number of solvent boxes needed for each dimension
		float width = solvent_box.getWidth();
		float height = solvent_box.getHeight();
		float depth = solvent_box.getDepth();
		
		Size N_x = (Size)ceil(box_.getWidth() / width);
		Size N_y = (Size)ceil(box_.getHeight() / height);
		Size N_z = (Size)ceil(box_.getDepth() / depth);

		Vector3 box_lower;
		Vector3 box_upper;
		box_.get(box_lower,box_upper);
		
		box_upper.x = box_lower.x + N_x * width;
		box_upper.y = box_lower.y + N_y * height;
		box_upper.z = box_lower.z + N_z * depth;

		box_.set(box_lower, box_upper);
		
		// adapt foreign water boxes to our definition
		MolmecSupport::adaptWaterBox(solvent, solvent_box);

		// copy solvent molecules from the solvent system into 
		// the simulation system
		System* system = force_field_->getSystem();
		if ((force_field_ == 0) || (system == 0))
		{
			Log.error() << "Force field does not contain  a system." << endl;
			return 0;
		}

		// get the minimum solvent-solute distance from the options
		float solvent_solute_distance = 0.0;
		if (options->has(Option::PERIODIC_BOX_SOLVENT_SOLUTE_DISTANCE))
		{
			solvent_solute_distance = options->getReal(Option::PERIODIC_BOX_SOLVENT_SOLUTE_DISTANCE);
		}

		// build a hash grid containing _only_ the solute molecules; this is
		// needed for addNonOverlappingMolecules()
		// (we add 102% of the distance to make sure we get no points
		// on the grid boundary)
		Vector3	additional_space(solvent_solute_distance * 1.02);
		HashGrid3<const Atom*> solute_grid(box_.a - additional_space,
				box_.b - box_.a + additional_space + additional_space,
				solvent_solute_distance);

		// Insert the atoms of the solute into the hash grid
		AtomIterator atom_it = system->beginAtom();
		for (; +atom_it; ++atom_it) 
		{
			solute_grid.insert(atom_it->getPosition(), &*atom_it);
		}

		// set the property IS_SOLVENT for all molecules in the solvent box
		MoleculeIterator mol_it = solvent.beginMolecule();
		for (; +mol_it; ++mol_it)
		{
			mol_it->setProperty(Molecule::IS_SOLVENT);
		}

		// add the solvent molecules
		Size added_molecules = 0;
		TranslationProcessor translation;
		
		// This is the vector that translates the lower vector of the solvent
		// box to the lower vector of the periodic box
		Vector3 basis = box_.a - solvent_box.a;
		
		for (Size i = 0; i <= N_x; ++i)
		{
			for (Size j = 0; j <= N_y; ++j)
			{
				for (Size k = 0; k <= N_z; ++k)
				{
					Vector3 tmp;
					tmp.x = basis.x + (float)i * width;
					tmp.y = basis.y + (float)j * height;
					tmp.z = basis.z + (float)k * depth;
					translation.setTranslation(tmp);
					solvent.apply(translation);
					
					// check for overlaps and insert solvent molecules
					added_molecules += MolmecSupport::addNonOverlappingMolecules
															(*system, solute_grid, solvent, box_, 
																solvent_solute_distance);

					tmp.x = -tmp.x;
					tmp.y = -tmp.y;
					tmp.z = -tmp.z;

					translation.setTranslation(tmp);
					solvent.apply(translation);
				}
			}
		}

		return added_molecules;
	}


	// Remove the solvent molecules that have been added by periodic boundary
	Size PeriodicBoundary::removeSolvent()
	{
		// check whether the force field and the system therein
		// are set
		if ((force_field_ == 0) || (force_field_->getSystem() == 0))
		{
			return 0;
		}

		Size counter = 0;
		MoleculeIterator mol_it = force_field_->getSystem()->beginMolecule();
		for (; +mol_it; ++mol_it) 
		{
			if (mol_it->hasProperty(Molecule::IS_SOLVENT)) 
			{
				counter++;
				Molecule* mol = &(*mol_it);
				force_field_->getSystem()->remove((*mol_it));

				// check whether the molecule is static or dynamic
				if (mol->isAutoDeletable()) 
				{
					// it was created dynamically - destruct it!
					delete mol;
				} 
				else 
				{
					// this is a static object - destroy it only!
					mol->destroy();
				}
			}
		}

		return counter;
	}

}