ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/group/trunk/OOPSE-3.0/src/brains/SimCreator.cpp
(Generate patch)

Comparing trunk/OOPSE-3.0/src/brains/SimCreator.cpp (file contents):
Revision 2081 by gezelter, Fri Mar 4 15:29:03 2005 UTC vs.
Revision 2120 by tim, Fri Mar 11 17:50:11 2005 UTC

# Line 1 | Line 1
1 < /*
2 < * Copyright (c) 2005 The University of Notre Dame. All Rights Reserved.
3 < *
4 < * The University of Notre Dame grants you ("Licensee") a
5 < * non-exclusive, royalty free, license to use, modify and
6 < * redistribute this software in source and binary code form, provided
7 < * that the following conditions are met:
8 < *
9 < * 1. Acknowledgement of the program authors must be made in any
10 < *    publication of scientific results based in part on use of the
11 < *    program.  An acceptable form of acknowledgement is citation of
12 < *    the article in which the program was described (Matthew
13 < *    A. Meineke, Charles F. Vardeman II, Teng Lin, Christopher
14 < *    J. Fennell and J. Daniel Gezelter, "OOPSE: An Object-Oriented
15 < *    Parallel Simulation Engine for Molecular Dynamics,"
16 < *    J. Comput. Chem. 26, pp. 252-271 (2005))
17 < *
18 < * 2. Redistributions of source code must retain the above copyright
19 < *    notice, this list of conditions and the following disclaimer.
20 < *
21 < * 3. Redistributions in binary form must reproduce the above copyright
22 < *    notice, this list of conditions and the following disclaimer in the
23 < *    documentation and/or other materials provided with the
24 < *    distribution.
25 < *
26 < * This software is provided "AS IS," without a warranty of any
27 < * kind. All express or implied conditions, representations and
28 < * warranties, including any implied warranty of merchantability,
29 < * fitness for a particular purpose or non-infringement, are hereby
30 < * excluded.  The University of Notre Dame and its licensors shall not
31 < * be liable for any damages suffered by licensee as a result of
32 < * using, modifying or distributing the software or its
33 < * derivatives. In no event will the University of Notre Dame or its
34 < * licensors be liable for any lost revenue, profit or data, or for
35 < * direct, indirect, special, consequential, incidental or punitive
36 < * damages, however caused and regardless of the theory of liability,
37 < * arising out of the use of or inability to use software, even if the
38 < * University of Notre Dame has been advised of the possibility of
39 < * such damages.
40 < */
41 <
42 < /**
43 < * @file SimCreator.cpp
44 < * @author tlin
45 < * @date 11/03/2004
46 < * @time 13:51am
47 < * @version 1.0
48 < */
49 <
50 < #include "brains/MoleculeCreator.hpp"
51 < #include "brains/SimCreator.hpp"
52 < #include "brains/SimSnapshotManager.hpp"
53 < #include "io/DumpReader.hpp"
54 < #include "io/parse_me.h"
55 < #include "UseTheForce/ForceFieldFactory.hpp"
56 < #include "utils/simError.h"
57 < #include "utils/StringUtils.hpp"
58 < #include "math/SeqRandNumGen.hpp"
59 < #ifdef IS_MPI
60 < #include "io/mpiBASS.h"
61 < #include "math/ParallelRandNumGen.hpp"
62 < #endif
63 <
64 < namespace oopse {
65 <
66 < void SimCreator::parseFile(const std::string mdFileName,  MakeStamps* stamps, Globals* simParams){
67 <
68 < #ifdef IS_MPI
69 <
70 <    if (worldRank == 0) {
71 < #endif // is_mpi
72 <
73 <        simParams->initalize();
74 <        set_interface_stamps(stamps, simParams);
75 <
76 < #ifdef IS_MPI
77 <
78 <        mpiEventInit();
79 <
80 < #endif
81 <
82 <        yacc_BASS(mdFileName.c_str());
83 <
84 < #ifdef IS_MPI
85 <
86 <        throwMPIEvent(NULL);
87 <    } else {
88 <        set_interface_stamps(stamps, simParams);
89 <        mpiEventInit();
90 <        MPIcheckPoint();
91 <        mpiEventLoop();
92 <    }
93 <
94 < #endif
95 <
96 < }
97 <
98 < SimInfo*  SimCreator::createSim(const std::string & mdFileName, bool loadInitCoords) {
99 <    
100 <    MakeStamps * stamps = new MakeStamps();
101 <
102 <    Globals * simParams = new Globals();
103 <
104 <    //parse meta-data file
105 <    parseFile(mdFileName, stamps, simParams);
106 <
107 <    //create the force field
108 <    ForceField * ff = ForceFieldFactory::getInstance()->createForceField(
109 <                          simParams->getForceField());
110 <    
111 <    if (ff == NULL) {
112 <        sprintf(painCave.errMsg, "ForceField Factory can not create %s force field\n",
113 <                simParams->getForceField());
114 <        painCave.isFatal = 1;
115 <        simError();
116 <    }
117 <
118 <    if (simParams->haveForceFieldFileName()) {
119 <        ff->setForceFieldFileName(simParams->getForceFieldFileName());
120 <    }
121 <    
122 <    std::string forcefieldFileName;
123 <    forcefieldFileName = ff->getForceFieldFileName();
124 <
125 <    if (simParams->haveForceFieldVariant()) {
126 <        //If the force field has variant, the variant force field name will be
127 <        //Base.variant.frc. For exampel EAM.u6.frc
128 <        
129 <        std::string variant = simParams->getForceFieldVariant();
130 <
131 <        std::string::size_type pos = forcefieldFileName.rfind(".frc");
132 <        variant = "." + variant;
133 <        if (pos != std::string::npos) {
134 <            forcefieldFileName.insert(pos, variant);
135 <        } else {
136 <            //If the default force field file name does not containt .frc suffix, just append the .variant
137 <            forcefieldFileName.append(variant);
138 <        }
139 <    }
140 <    
141 <    ff->parse(forcefieldFileName);
142 <    
143 <    //extract the molecule stamps
144 <    std::vector < std::pair<MoleculeStamp *, int> > moleculeStampPairs;
145 <    compList(stamps, simParams, moleculeStampPairs);
146 <
147 <    //create SimInfo
148 <    SimInfo * info = new SimInfo(moleculeStampPairs, ff, simParams);
149 <
150 <    //gather parameters (SimCreator only retrieves part of the parameters)
151 <    gatherParameters(info, mdFileName);
152 <
153 <    //divide the molecules and determine the global index of molecules
154 < #ifdef IS_MPI
155 <    divideMolecules(info);
156 < #endif
157 <
158 <    //create the molecules
159 <    createMolecules(info);
160 <
161 <
162 <    //allocate memory for DataStorage(circular reference, need to break it)
163 <    info->setSnapshotManager(new SimSnapshotManager(info));
164 <    
165 <    //set the global index of atoms, rigidbodies and cutoffgroups (only need to be set once, the
166 <    //global index will never change again). Local indices of atoms and rigidbodies are already set by
167 <    //MoleculeCreator class which actually delegates the responsibility to LocalIndexManager.
168 <    setGlobalIndex(info);
169 <
170 <    //Alought addExculdePairs is called inside SimInfo's addMolecule method, at that point
171 <    //atoms don't have the global index yet  (their global index are all initialized to -1).
172 <    //Therefore we have to call addExcludePairs explicitly here. A way to work around is that
173 <    //we can determine the beginning global indices of atoms before they get created.
174 <    SimInfo::MoleculeIterator mi;
175 <    Molecule* mol;
176 <    for (mol= info->beginMolecule(mi); mol != NULL; mol = info->nextMolecule(mi)) {
177 <        info->addExcludePairs(mol);
178 <    }
179 <    
180 <
181 <    //load initial coordinates, some extra information are pushed into SimInfo's property map ( such as
182 <    //eta, chi for NPT integrator)
183 <    if (loadInitCoords)
184 <        loadCoordinates(info);    
185 <    
186 <    return info;
187 < }
188 <
189 < void SimCreator::gatherParameters(SimInfo *info, const std::string& mdfile) {
190 <
191 <    //figure out the ouput file names
192 <    std::string prefix;
193 <
194 < #ifdef IS_MPI
195 <
196 <    if (worldRank == 0) {
197 < #endif // is_mpi
198 <        Globals * simParams = info->getSimParams();
199 <        if (simParams->haveFinalConfig()) {
200 <            prefix = getPrefix(simParams->getFinalConfig());
201 <        } else {
202 <            prefix = getPrefix(mdfile);
203 <        }
204 <
205 <        info->setFinalConfigFileName(prefix + ".eor");
206 <        info->setDumpFileName(prefix + ".dump");
207 <        info->setStatFileName(prefix + ".stat");
208 <
209 < #ifdef IS_MPI
210 <
211 <    }
212 <
213 < #endif
214 <
215 < }
216 <
217 < #ifdef IS_MPI
218 < void SimCreator::divideMolecules(SimInfo *info) {
219 <    double numerator;
220 <    double denominator;
221 <    double precast;
222 <    double x;
223 <    double y;
224 <    double a;
225 <    int old_atoms;
226 <    int add_atoms;
227 <    int new_atoms;
228 <    int nTarget;
229 <    int done;
230 <    int i;
231 <    int j;
232 <    int loops;
233 <    int which_proc;
234 <    int nProcessors;
235 <    std::vector<int> atomsPerProc;
236 <    int nGlobalMols = info->getNGlobalMolecules();
237 <    std::vector<int> molToProcMap(nGlobalMols, -1); // default to an error condition:
238 <    
239 <    MPI_Comm_size(MPI_COMM_WORLD, &nProcessors);
240 <
241 <    if (nProcessors > nGlobalMols) {
242 <        sprintf(painCave.errMsg,
243 <                "nProcessors (%d) > nMol (%d)\n"
244 <                    "\tThe number of processors is larger than\n"
245 <                    "\tthe number of molecules.  This will not result in a \n"
246 <                    "\tusable division of atoms for force decomposition.\n"
247 <                    "\tEither try a smaller number of processors, or run the\n"
248 <                    "\tsingle-processor version of OOPSE.\n", nProcessors, nGlobalMols);
249 <
250 <        painCave.isFatal = 1;
251 <        simError();
252 <    }
253 <
254 <    int seedValue;
255 <    Globals * simParams = info->getSimParams();
256 <    SeqRandNumGen* myRandom; //divide labor does not need Parallel random number generator
257 <    if (simParams->haveSeed()) {
258 <        seedValue = simParams->getSeed();
259 <        myRandom = new SeqRandNumGen(seedValue);
260 <    }else {
261 <        myRandom = new SeqRandNumGen();
262 <    }  
263 <
264 <
265 <    a = 3.0 * nGlobalMols / info->getNGlobalAtoms();
266 <
267 <    //initialize atomsPerProc
268 <    atomsPerProc.insert(atomsPerProc.end(), nProcessors, 0);
269 <
270 <    if (worldRank == 0) {
271 <        numerator = info->getNGlobalAtoms();
272 <        denominator = nProcessors;
273 <        precast = numerator / denominator;
274 <        nTarget = (int)(precast + 0.5);
275 <
276 <        for(i = 0; i < nGlobalMols; i++) {
277 <            done = 0;
278 <            loops = 0;
279 <
280 <            while (!done) {
281 <                loops++;
282 <
283 <                // Pick a processor at random
284 <
285 <                which_proc = (int) (myRandom->rand() * nProcessors);
286 <
287 <                //get the molecule stamp first
288 <                int stampId = info->getMoleculeStampId(i);
289 <                MoleculeStamp * moleculeStamp = info->getMoleculeStamp(stampId);
290 <
291 <                // How many atoms does this processor have so far?
292 <                old_atoms = atomsPerProc[which_proc];
293 <                add_atoms = moleculeStamp->getNAtoms();
294 <                new_atoms = old_atoms + add_atoms;
295 <
296 <                // If we've been through this loop too many times, we need
297 <                // to just give up and assign the molecule to this processor
298 <                // and be done with it.
299 <
300 <                if (loops > 100) {
301 <                    sprintf(painCave.errMsg,
302 <                            "I've tried 100 times to assign molecule %d to a "
303 <                                " processor, but can't find a good spot.\n"
304 <                                "I'm assigning it at random to processor %d.\n",
305 <                            i, which_proc);
306 <
307 <                    painCave.isFatal = 0;
308 <                    simError();
309 <
310 <                    molToProcMap[i] = which_proc;
311 <                    atomsPerProc[which_proc] += add_atoms;
312 <
313 <                    done = 1;
314 <                    continue;
315 <                }
316 <
317 <                // If we can add this molecule to this processor without sending
318 <                // it above nTarget, then go ahead and do it:
319 <
320 <                if (new_atoms <= nTarget) {
321 <                    molToProcMap[i] = which_proc;
322 <                    atomsPerProc[which_proc] += add_atoms;
323 <
324 <                    done = 1;
325 <                    continue;
326 <                }
327 <
328 <                // The only situation left is when new_atoms > nTarget.  We
329 <                // want to accept this with some probability that dies off the
330 <                // farther we are from nTarget
331 <
332 <                // roughly:  x = new_atoms - nTarget
333 <                //           Pacc(x) = exp(- a * x)
334 <                // where a = penalty / (average atoms per molecule)
335 <
336 <                x = (double)(new_atoms - nTarget);
337 <                y = myRandom->rand();
338 <
339 <                if (y < exp(- a * x)) {
340 <                    molToProcMap[i] = which_proc;
341 <                    atomsPerProc[which_proc] += add_atoms;
342 <
343 <                    done = 1;
344 <                    continue;
345 <                } else {
346 <                    continue;
347 <                }
348 <            }
349 <        }
350 <
351 <        delete myRandom;
352 <        
353 <        // Spray out this nonsense to all other processors:
354 <
355 <        MPI_Bcast(&molToProcMap[0], nGlobalMols, MPI_INT, 0, MPI_COMM_WORLD);
356 <    } else {
357 <
358 <        // Listen to your marching orders from processor 0:
359 <
360 <        MPI_Bcast(&molToProcMap[0], nGlobalMols, MPI_INT, 0, MPI_COMM_WORLD);
361 <    }
362 <
363 <    info->setMolToProcMap(molToProcMap);
364 <    sprintf(checkPointMsg,
365 <            "Successfully divided the molecules among the processors.\n");
366 <    MPIcheckPoint();
367 < }
368 <
369 < #endif
370 <
371 < void SimCreator::createMolecules(SimInfo *info) {
372 <    MoleculeCreator molCreator;
373 <    int stampId;
374 <
375 <    for(int i = 0; i < info->getNGlobalMolecules(); i++) {
376 <
377 < #ifdef IS_MPI
378 <
379 <        if (info->getMolToProc(i) == worldRank) {
380 < #endif
381 <
382 <            stampId = info->getMoleculeStampId(i);
383 <            Molecule * mol = molCreator.createMolecule(info->getForceField(), info->getMoleculeStamp(stampId),
384 <                                                                                    stampId, i, info->getLocalIndexManager());
385 <
386 <            info->addMolecule(mol);
387 <
388 < #ifdef IS_MPI
389 <
390 <        }
391 <
392 < #endif
393 <
394 <    } //end for(int i=0)  
395 < }
396 <
397 < void SimCreator::compList(MakeStamps *stamps, Globals* simParams,
398 <                        std::vector < std::pair<MoleculeStamp *, int> > &moleculeStampPairs) {
399 <    int i;
400 <    char * id;
401 <    MoleculeStamp * currentStamp;
402 <    Component** the_components = simParams->getComponents();
403 <    int n_components = simParams->getNComponents();
404 <
405 <    if (!simParams->haveNMol()) {
406 <        // we don't have the total number of molecules, so we assume it is
407 <        // given in each component
408 <
409 <        for(i = 0; i < n_components; i++) {
410 <            if (!the_components[i]->haveNMol()) {
411 <                // we have a problem
412 <                sprintf(painCave.errMsg,
413 <                        "SimCreator Error. No global NMol or component NMol given.\n"
414 <                            "\tCannot calculate the number of atoms.\n");
415 <
416 <                painCave.isFatal = 1;
417 <                simError();
418 <            }
419 <
420 <            id = the_components[i]->getType();
421 <            currentStamp = (stamps->extractMolStamp(id))->getStamp();
422 <
423 <            if (currentStamp == NULL) {
424 <                sprintf(painCave.errMsg,
425 <                        "SimCreator error: Component \"%s\" was not found in the "
426 <                            "list of declared molecules\n", id);
427 <
428 <                painCave.isFatal = 1;
429 <                simError();
430 <            }
431 <
432 <            moleculeStampPairs.push_back(
433 <                std::make_pair(currentStamp, the_components[i]->getNMol()));
434 <        } //end for (i = 0; i < n_components; i++)
435 <    } else {
436 <        sprintf(painCave.errMsg, "SimSetup error.\n"
437 <                                     "\tSorry, the ability to specify total"
438 <                                     " nMols and then give molfractions in the components\n"
439 <                                     "\tis not currently supported."
440 <                                     " Please give nMol in the components.\n");
441 <
442 <        painCave.isFatal = 1;
443 <        simError();
444 <    }
445 <
446 < #ifdef IS_MPI
447 <
448 <    strcpy(checkPointMsg, "Component stamps successfully extracted\n");
449 <    MPIcheckPoint();
450 <
451 < #endif // is_mpi
452 <
453 < }
454 <
455 < void SimCreator::setGlobalIndex(SimInfo *info) {
456 <    SimInfo::MoleculeIterator mi;
457 <    Molecule::AtomIterator ai;
458 <    Molecule::RigidBodyIterator ri;
459 <    Molecule::CutoffGroupIterator ci;
460 <    Molecule * mol;
461 <    Atom * atom;
462 <    RigidBody * rb;
463 <    CutoffGroup * cg;
464 <    int beginAtomIndex;
465 <    int beginRigidBodyIndex;
466 <    int beginCutoffGroupIndex;
467 <    int nGlobalAtoms = info->getNGlobalAtoms();
468 <    
469 < #ifndef IS_MPI
470 <
471 <    beginAtomIndex = 0;
472 <    beginRigidBodyIndex = 0;
473 <    beginCutoffGroupIndex = 0;
474 <
475 < #else
476 <
477 <    int nproc;
478 <    int myNode;
479 <
480 <    myNode = worldRank;
481 <    MPI_Comm_size(MPI_COMM_WORLD, &nproc);
482 <
483 <    std::vector < int > tmpAtomsInProc(nproc, 0);
484 <    std::vector < int > tmpRigidBodiesInProc(nproc, 0);
485 <    std::vector < int > tmpCutoffGroupsInProc(nproc, 0);
486 <    std::vector < int > NumAtomsInProc(nproc, 0);
487 <    std::vector < int > NumRigidBodiesInProc(nproc, 0);
488 <    std::vector < int > NumCutoffGroupsInProc(nproc, 0);
489 <
490 <    tmpAtomsInProc[myNode] = info->getNAtoms();
491 <    tmpRigidBodiesInProc[myNode] = info->getNRigidBodies();
492 <    tmpCutoffGroupsInProc[myNode] = info->getNCutoffGroups();
493 <
494 <    //do MPI_ALLREDUCE to exchange the total number of atoms, rigidbodies and cutoff groups
495 <    MPI_Allreduce(&tmpAtomsInProc[0], &NumAtomsInProc[0], nproc, MPI_INT,
496 <                  MPI_SUM, MPI_COMM_WORLD);
497 <    MPI_Allreduce(&tmpRigidBodiesInProc[0], &NumRigidBodiesInProc[0], nproc,
498 <                  MPI_INT, MPI_SUM, MPI_COMM_WORLD);
499 <    MPI_Allreduce(&tmpCutoffGroupsInProc[0], &NumCutoffGroupsInProc[0], nproc,
500 <                  MPI_INT, MPI_SUM, MPI_COMM_WORLD);
501 <
502 <    beginAtomIndex = 0;
503 <    beginRigidBodyIndex = 0;
504 <    beginCutoffGroupIndex = 0;
505 <
506 <    for(int i = 0; i < myNode; i++) {
507 <        beginAtomIndex += NumAtomsInProc[i];
508 <        beginRigidBodyIndex += NumRigidBodiesInProc[i];
509 <        beginCutoffGroupIndex += NumCutoffGroupsInProc[i];
510 <    }
511 <
512 < #endif
513 <
514 <    //rigidbody's index begins right after atom's
515 <    beginRigidBodyIndex += info->getNGlobalAtoms();
516 <
517 <    for(mol = info->beginMolecule(mi); mol != NULL;
518 <        mol = info->nextMolecule(mi)) {
519 <
520 <        //local index(index in DataStorge) of atom is important
521 <        for(atom = mol->beginAtom(ai); atom != NULL; atom = mol->nextAtom(ai)) {
522 <            atom->setGlobalIndex(beginAtomIndex++);
523 <        }
524 <
525 <        for(rb = mol->beginRigidBody(ri); rb != NULL;
526 <            rb = mol->nextRigidBody(ri)) {
527 <            rb->setGlobalIndex(beginRigidBodyIndex++);
528 <        }
529 <
530 <        //local index of cutoff group is trivial, it only depends on the order of travesing
531 <        for(cg = mol->beginCutoffGroup(ci); cg != NULL;
532 <            cg = mol->nextCutoffGroup(ci)) {
533 <            cg->setGlobalIndex(beginCutoffGroupIndex++);
534 <        }
535 <    }
536 <
537 <    //fill globalGroupMembership
538 <    std::vector<int> globalGroupMembership(info->getNGlobalAtoms(), 0);
539 <    for(mol = info->beginMolecule(mi); mol != NULL; mol = info->nextMolecule(mi)) {        
540 <        for (cg = mol->beginCutoffGroup(ci); cg != NULL; cg = mol->nextCutoffGroup(ci)) {
541 <
542 <            for(atom = cg->beginAtom(ai); atom != NULL; atom = cg->nextAtom(ai)) {
543 <                globalGroupMembership[atom->getGlobalIndex()] = cg->getGlobalIndex();
544 <            }
545 <
546 <        }      
547 <    }
548 <
549 < #ifdef IS_MPI    
550 <    // Since the globalGroupMembership has been zero filled and we've only
551 <    // poked values into the atoms we know, we can do an Allreduce
552 <    // to get the full globalGroupMembership array (We think).
553 <    // This would be prettier if we could use MPI_IN_PLACE like the MPI-2
554 <    // docs said we could.
555 <    std::vector<int> tmpGroupMembership(nGlobalAtoms, 0);
556 <    MPI_Allreduce(&globalGroupMembership[0], &tmpGroupMembership[0], nGlobalAtoms,
557 <                  MPI_INT, MPI_SUM, MPI_COMM_WORLD);
558 <     info->setGlobalGroupMembership(tmpGroupMembership);
559 < #else
560 <    info->setGlobalGroupMembership(globalGroupMembership);
561 < #endif
562 <
563 <    //fill molMembership
564 <    std::vector<int> globalMolMembership(info->getNGlobalAtoms(), 0);
565 <    
566 <    for(mol = info->beginMolecule(mi); mol != NULL; mol = info->nextMolecule(mi)) {
567 <
568 <        for(atom = mol->beginAtom(ai); atom != NULL; atom = mol->nextAtom(ai)) {
569 <            globalMolMembership[atom->getGlobalIndex()] = mol->getGlobalIndex();
570 <        }
571 <    }
572 <
573 < #ifdef IS_MPI
574 <    std::vector<int> tmpMolMembership(nGlobalAtoms, 0);
575 <
576 <    MPI_Allreduce(&globalMolMembership[0], &tmpMolMembership[0], nGlobalAtoms,
577 <                  MPI_INT, MPI_SUM, MPI_COMM_WORLD);
578 <    
579 <    info->setGlobalMolMembership(tmpMolMembership);
580 < #else
581 <    info->setGlobalMolMembership(globalMolMembership);
582 < #endif
583 <
584 < }
585 <
586 < void SimCreator::loadCoordinates(SimInfo* info) {
587 <    Globals* simParams;
588 <    simParams = info->getSimParams();
589 <    
590 <    if (!simParams->haveInitialConfig()) {
591 <        sprintf(painCave.errMsg,
592 <                "Cannot intialize a simulation without an initial configuration file.\n");
593 <        painCave.isFatal = 1;;
594 <        simError();
595 <    }
596 <        
597 <    DumpReader reader(info, simParams->getInitialConfig());
598 <    int nframes = reader.getNFrames();
599 <
600 <    if (nframes > 0) {
601 <        reader.readFrame(nframes - 1);
602 <    } else {
603 <        //invalid initial coordinate file
604 <        sprintf(painCave.errMsg, "Initial configuration file %s should at least contain one frame\n",
605 <                simParams->getInitialConfig());
606 <        painCave.isFatal = 1;
607 <        simError();
608 <    }
609 <
610 <    //copy the current snapshot to previous snapshot
611 <    info->getSnapshotManager()->advance();
612 < }
613 <
614 < } //end namespace oopse
615 <
616 <
1 > /*
2 > * Copyright (c) 2005 The University of Notre Dame. All Rights Reserved.
3 > *
4 > * The University of Notre Dame grants you ("Licensee") a
5 > * non-exclusive, royalty free, license to use, modify and
6 > * redistribute this software in source and binary code form, provided
7 > * that the following conditions are met:
8 > *
9 > * 1. Acknowledgement of the program authors must be made in any
10 > *    publication of scientific results based in part on use of the
11 > *    program.  An acceptable form of acknowledgement is citation of
12 > *    the article in which the program was described (Matthew
13 > *    A. Meineke, Charles F. Vardeman II, Teng Lin, Christopher
14 > *    J. Fennell and J. Daniel Gezelter, "OOPSE: An Object-Oriented
15 > *    Parallel Simulation Engine for Molecular Dynamics,"
16 > *    J. Comput. Chem. 26, pp. 252-271 (2005))
17 > *
18 > * 2. Redistributions of source code must retain the above copyright
19 > *    notice, this list of conditions and the following disclaimer.
20 > *
21 > * 3. Redistributions in binary form must reproduce the above copyright
22 > *    notice, this list of conditions and the following disclaimer in the
23 > *    documentation and/or other materials provided with the
24 > *    distribution.
25 > *
26 > * This software is provided "AS IS," without a warranty of any
27 > * kind. All express or implied conditions, representations and
28 > * warranties, including any implied warranty of merchantability,
29 > * fitness for a particular purpose or non-infringement, are hereby
30 > * excluded.  The University of Notre Dame and its licensors shall not
31 > * be liable for any damages suffered by licensee as a result of
32 > * using, modifying or distributing the software or its
33 > * derivatives. In no event will the University of Notre Dame or its
34 > * licensors be liable for any lost revenue, profit or data, or for
35 > * direct, indirect, special, consequential, incidental or punitive
36 > * damages, however caused and regardless of the theory of liability,
37 > * arising out of the use of or inability to use software, even if the
38 > * University of Notre Dame has been advised of the possibility of
39 > * such damages.
40 > */
41 >
42 > /**
43 > * @file SimCreator.cpp
44 > * @author tlin
45 > * @date 11/03/2004
46 > * @time 13:51am
47 > * @version 1.0
48 > */
49 >
50 > #include "brains/MoleculeCreator.hpp"
51 > #include "brains/SimCreator.hpp"
52 > #include "brains/SimSnapshotManager.hpp"
53 > #include "io/DumpReader.hpp"
54 > #include "io/parse_me.h"
55 > #include "UseTheForce/ForceFieldFactory.hpp"
56 > #include "utils/simError.h"
57 > #include "utils/StringUtils.hpp"
58 > #include "math/SeqRandNumGen.hpp"
59 > #ifdef IS_MPI
60 > #include "io/mpiBASS.h"
61 > #include "math/ParallelRandNumGen.hpp"
62 > #endif
63 >
64 > namespace oopse {
65 >  
66 >  void SimCreator::parseFile(const std::string mdFileName,  MakeStamps* stamps,
67 >                             Globals* simParams){
68 >    
69 > #ifdef IS_MPI
70 >    
71 >    if (worldRank == 0) {
72 > #endif // is_mpi
73 >      
74 >      simParams->initalize();
75 >      set_interface_stamps(stamps, simParams);
76 >      
77 > #ifdef IS_MPI
78 >      
79 >      mpiEventInit();
80 >      
81 > #endif
82 >      
83 >      yacc_BASS(mdFileName.c_str());
84 >      
85 > #ifdef IS_MPI
86 >      
87 >      throwMPIEvent(NULL);
88 >    } else {
89 >      set_interface_stamps(stamps, simParams);
90 >      mpiEventInit();
91 >      MPIcheckPoint();
92 >      mpiEventLoop();
93 >    }
94 >    
95 > #endif
96 >    
97 >  }
98 >  
99 >  SimInfo*  SimCreator::createSim(const std::string & mdFileName, bool loadInitCoords) {
100 >    
101 >    MakeStamps * stamps = new MakeStamps();
102 >    
103 >    Globals * simParams = new Globals();
104 >    
105 >    //parse meta-data file
106 >    parseFile(mdFileName, stamps, simParams);
107 >    
108 >    //create the force field
109 >    ForceField * ff = ForceFieldFactory::getInstance()->createForceField(
110 >                                                                         simParams->getForceField());
111 >    
112 >    if (ff == NULL) {
113 >      sprintf(painCave.errMsg, "ForceField Factory can not create %s force field\n",
114 >              simParams->getForceField());
115 >      painCave.isFatal = 1;
116 >      simError();
117 >    }
118 >    
119 >    if (simParams->haveForceFieldFileName()) {
120 >      ff->setForceFieldFileName(simParams->getForceFieldFileName());
121 >    }
122 >    
123 >    std::string forcefieldFileName;
124 >    forcefieldFileName = ff->getForceFieldFileName();
125 >    
126 >    if (simParams->haveForceFieldVariant()) {
127 >      //If the force field has variant, the variant force field name will be
128 >      //Base.variant.frc. For exampel EAM.u6.frc
129 >      
130 >      std::string variant = simParams->getForceFieldVariant();
131 >      
132 >      std::string::size_type pos = forcefieldFileName.rfind(".frc");
133 >      variant = "." + variant;
134 >      if (pos != std::string::npos) {
135 >        forcefieldFileName.insert(pos, variant);
136 >      } else {
137 >        //If the default force field file name does not containt .frc suffix, just append the .variant
138 >        forcefieldFileName.append(variant);
139 >      }
140 >    }
141 >    
142 >    ff->parse(forcefieldFileName);
143 >    
144 >    //extract the molecule stamps
145 >    std::vector < std::pair<MoleculeStamp *, int> > moleculeStampPairs;
146 >    compList(stamps, simParams, moleculeStampPairs);
147 >    
148 >    //create SimInfo
149 >    SimInfo * info = new SimInfo(moleculeStampPairs, ff, simParams);
150 >    
151 >    //gather parameters (SimCreator only retrieves part of the parameters)
152 >    gatherParameters(info, mdFileName);
153 >    
154 >    //divide the molecules and determine the global index of molecules
155 > #ifdef IS_MPI
156 >    divideMolecules(info);
157 > #endif
158 >    
159 >    //create the molecules
160 >    createMolecules(info);
161 >    
162 >    
163 >    //allocate memory for DataStorage(circular reference, need to break it)
164 >    info->setSnapshotManager(new SimSnapshotManager(info));
165 >    
166 >    //set the global index of atoms, rigidbodies and cutoffgroups (only need to be set once, the
167 >    //global index will never change again). Local indices of atoms and rigidbodies are already set by
168 >    //MoleculeCreator class which actually delegates the responsibility to LocalIndexManager.
169 >    setGlobalIndex(info);
170 >    
171 >    //Alought addExculdePairs is called inside SimInfo's addMolecule method, at that point
172 >    //atoms don't have the global index yet  (their global index are all initialized to -1).
173 >    //Therefore we have to call addExcludePairs explicitly here. A way to work around is that
174 >    //we can determine the beginning global indices of atoms before they get created.
175 >    SimInfo::MoleculeIterator mi;
176 >    Molecule* mol;
177 >    for (mol= info->beginMolecule(mi); mol != NULL; mol = info->nextMolecule(mi)) {
178 >      info->addExcludePairs(mol);
179 >    }
180 >    
181 >    if (loadInitCoords)
182 >      loadCoordinates(info);    
183 >    
184 >    return info;
185 >  }
186 >  
187 >  void SimCreator::gatherParameters(SimInfo *info, const std::string& mdfile) {
188 >    
189 >    //figure out the ouput file names
190 >    std::string prefix;
191 >    
192 > #ifdef IS_MPI
193 >    
194 >    if (worldRank == 0) {
195 > #endif // is_mpi
196 >      Globals * simParams = info->getSimParams();
197 >      if (simParams->haveFinalConfig()) {
198 >        prefix = getPrefix(simParams->getFinalConfig());
199 >      } else {
200 >        prefix = getPrefix(mdfile);
201 >      }
202 >      
203 >      info->setFinalConfigFileName(prefix + ".eor");
204 >      info->setDumpFileName(prefix + ".dump");
205 >      info->setStatFileName(prefix + ".stat");
206 >      info->setRestFileName(prefix + ".zang");
207 >      
208 > #ifdef IS_MPI
209 >      
210 >    }
211 >    
212 > #endif
213 >    
214 >  }
215 >  
216 > #ifdef IS_MPI
217 >  void SimCreator::divideMolecules(SimInfo *info) {
218 >    double numerator;
219 >    double denominator;
220 >    double precast;
221 >    double x;
222 >    double y;
223 >    double a;
224 >    int old_atoms;
225 >    int add_atoms;
226 >    int new_atoms;
227 >    int nTarget;
228 >    int done;
229 >    int i;
230 >    int j;
231 >    int loops;
232 >    int which_proc;
233 >    int nProcessors;
234 >    std::vector<int> atomsPerProc;
235 >    int nGlobalMols = info->getNGlobalMolecules();
236 >    std::vector<int> molToProcMap(nGlobalMols, -1); // default to an error condition:
237 >    
238 >    MPI_Comm_size(MPI_COMM_WORLD, &nProcessors);
239 >    
240 >    if (nProcessors > nGlobalMols) {
241 >      sprintf(painCave.errMsg,
242 >              "nProcessors (%d) > nMol (%d)\n"
243 >              "\tThe number of processors is larger than\n"
244 >              "\tthe number of molecules.  This will not result in a \n"
245 >              "\tusable division of atoms for force decomposition.\n"
246 >              "\tEither try a smaller number of processors, or run the\n"
247 >              "\tsingle-processor version of OOPSE.\n", nProcessors, nGlobalMols);
248 >      
249 >      painCave.isFatal = 1;
250 >      simError();
251 >    }
252 >    
253 >    int seedValue;
254 >    Globals * simParams = info->getSimParams();
255 >    SeqRandNumGen* myRandom; //divide labor does not need Parallel random number generator
256 >    if (simParams->haveSeed()) {
257 >      seedValue = simParams->getSeed();
258 >      myRandom = new SeqRandNumGen(seedValue);
259 >    }else {
260 >      myRandom = new SeqRandNumGen();
261 >    }  
262 >    
263 >    
264 >    a = 3.0 * nGlobalMols / info->getNGlobalAtoms();
265 >    
266 >    //initialize atomsPerProc
267 >    atomsPerProc.insert(atomsPerProc.end(), nProcessors, 0);
268 >    
269 >    if (worldRank == 0) {
270 >      numerator = info->getNGlobalAtoms();
271 >      denominator = nProcessors;
272 >      precast = numerator / denominator;
273 >      nTarget = (int)(precast + 0.5);
274 >      
275 >      for(i = 0; i < nGlobalMols; i++) {
276 >        done = 0;
277 >        loops = 0;
278 >        
279 >        while (!done) {
280 >          loops++;
281 >          
282 >          // Pick a processor at random
283 >          
284 >          which_proc = (int) (myRandom->rand() * nProcessors);
285 >          
286 >          //get the molecule stamp first
287 >          int stampId = info->getMoleculeStampId(i);
288 >          MoleculeStamp * moleculeStamp = info->getMoleculeStamp(stampId);
289 >          
290 >          // How many atoms does this processor have so far?
291 >          old_atoms = atomsPerProc[which_proc];
292 >          add_atoms = moleculeStamp->getNAtoms();
293 >          new_atoms = old_atoms + add_atoms;
294 >          
295 >          // If we've been through this loop too many times, we need
296 >          // to just give up and assign the molecule to this processor
297 >          // and be done with it.
298 >          
299 >          if (loops > 100) {
300 >            sprintf(painCave.errMsg,
301 >                    "I've tried 100 times to assign molecule %d to a "
302 >                    " processor, but can't find a good spot.\n"
303 >                    "I'm assigning it at random to processor %d.\n",
304 >                    i, which_proc);
305 >            
306 >            painCave.isFatal = 0;
307 >            simError();
308 >            
309 >            molToProcMap[i] = which_proc;
310 >            atomsPerProc[which_proc] += add_atoms;
311 >            
312 >            done = 1;
313 >            continue;
314 >          }
315 >          
316 >          // If we can add this molecule to this processor without sending
317 >          // it above nTarget, then go ahead and do it:
318 >          
319 >          if (new_atoms <= nTarget) {
320 >            molToProcMap[i] = which_proc;
321 >            atomsPerProc[which_proc] += add_atoms;
322 >            
323 >            done = 1;
324 >            continue;
325 >          }
326 >          
327 >          // The only situation left is when new_atoms > nTarget.  We
328 >          // want to accept this with some probability that dies off the
329 >          // farther we are from nTarget
330 >          
331 >          // roughly:  x = new_atoms - nTarget
332 >          //           Pacc(x) = exp(- a * x)
333 >          // where a = penalty / (average atoms per molecule)
334 >          
335 >          x = (double)(new_atoms - nTarget);
336 >          y = myRandom->rand();
337 >          
338 >          if (y < exp(- a * x)) {
339 >            molToProcMap[i] = which_proc;
340 >            atomsPerProc[which_proc] += add_atoms;
341 >            
342 >            done = 1;
343 >            continue;
344 >          } else {
345 >            continue;
346 >          }
347 >        }
348 >      }
349 >      
350 >      delete myRandom;
351 >      
352 >      // Spray out this nonsense to all other processors:
353 >      
354 >      MPI_Bcast(&molToProcMap[0], nGlobalMols, MPI_INT, 0, MPI_COMM_WORLD);
355 >    } else {
356 >      
357 >      // Listen to your marching orders from processor 0:
358 >      
359 >      MPI_Bcast(&molToProcMap[0], nGlobalMols, MPI_INT, 0, MPI_COMM_WORLD);
360 >    }
361 >    
362 >    info->setMolToProcMap(molToProcMap);
363 >    sprintf(checkPointMsg,
364 >            "Successfully divided the molecules among the processors.\n");
365 >    MPIcheckPoint();
366 >  }
367 >  
368 > #endif
369 >  
370 >  void SimCreator::createMolecules(SimInfo *info) {
371 >    MoleculeCreator molCreator;
372 >    int stampId;
373 >    
374 >    for(int i = 0; i < info->getNGlobalMolecules(); i++) {
375 >      
376 > #ifdef IS_MPI
377 >      
378 >      if (info->getMolToProc(i) == worldRank) {
379 > #endif
380 >        
381 >        stampId = info->getMoleculeStampId(i);
382 >        Molecule * mol = molCreator.createMolecule(info->getForceField(), info->getMoleculeStamp(stampId),
383 >                                                   stampId, i, info->getLocalIndexManager());
384 >        
385 >        info->addMolecule(mol);
386 >        
387 > #ifdef IS_MPI
388 >        
389 >      }
390 >      
391 > #endif
392 >      
393 >    } //end for(int i=0)  
394 >  }
395 >  
396 >  void SimCreator::compList(MakeStamps *stamps, Globals* simParams,
397 >                            std::vector < std::pair<MoleculeStamp *, int> > &moleculeStampPairs) {
398 >    int i;
399 >    char * id;
400 >    LinkedMolStamp* extractedStamp = NULL;
401 >    MoleculeStamp * currentStamp;
402 >    Component** the_components = simParams->getComponents();
403 >    int n_components = simParams->getNComponents();
404 >    
405 >    if (!simParams->haveNMol()) {
406 >      // we don't have the total number of molecules, so we assume it is
407 >      // given in each component
408 >      
409 >      for(i = 0; i < n_components; i++) {
410 >        if (!the_components[i]->haveNMol()) {
411 >          // we have a problem
412 >          sprintf(painCave.errMsg,
413 >                  "SimCreator Error. No global NMol or component NMol given.\n"
414 >                  "\tCannot calculate the number of atoms.\n");
415 >          
416 >          painCave.isFatal = 1;
417 >          simError();
418 >        }
419 >        
420 >        id = the_components[i]->getType();
421 >        
422 >        extractedStamp = stamps->extractMolStamp(id);
423 >        if (extractedStamp == NULL) {
424 >          sprintf(painCave.errMsg,
425 >                  "SimCreator error: Component \"%s\" was not found in the "
426 >                  "list of declared molecules\n", id);
427 >          
428 >          painCave.isFatal = 1;
429 >          simError();
430 >        }
431 >        
432 >        currentStamp = extractedStamp->getStamp();
433 >        
434 >        
435 >        moleculeStampPairs.push_back(
436 >                                     std::make_pair(currentStamp, the_components[i]->getNMol()));
437 >      } //end for (i = 0; i < n_components; i++)
438 >    } else {
439 >      sprintf(painCave.errMsg, "SimSetup error.\n"
440 >              "\tSorry, the ability to specify total"
441 >              " nMols and then give molfractions in the components\n"
442 >              "\tis not currently supported."
443 >              " Please give nMol in the components.\n");
444 >      
445 >      painCave.isFatal = 1;
446 >      simError();
447 >    }
448 >    
449 > #ifdef IS_MPI
450 >    
451 >    strcpy(checkPointMsg, "Component stamps successfully extracted\n");
452 >    MPIcheckPoint();
453 >    
454 > #endif // is_mpi
455 >    
456 >  }
457 >  
458 >  void SimCreator::setGlobalIndex(SimInfo *info) {
459 >    SimInfo::MoleculeIterator mi;
460 >    Molecule::AtomIterator ai;
461 >    Molecule::RigidBodyIterator ri;
462 >    Molecule::CutoffGroupIterator ci;
463 >    Molecule * mol;
464 >    Atom * atom;
465 >    RigidBody * rb;
466 >    CutoffGroup * cg;
467 >    int beginAtomIndex;
468 >    int beginRigidBodyIndex;
469 >    int beginCutoffGroupIndex;
470 >    int nGlobalAtoms = info->getNGlobalAtoms();
471 >    
472 > #ifndef IS_MPI
473 >    
474 >    beginAtomIndex = 0;
475 >    beginRigidBodyIndex = 0;
476 >    beginCutoffGroupIndex = 0;
477 >    
478 > #else
479 >    
480 >    int nproc;
481 >    int myNode;
482 >    
483 >    myNode = worldRank;
484 >    MPI_Comm_size(MPI_COMM_WORLD, &nproc);
485 >    
486 >    std::vector < int > tmpAtomsInProc(nproc, 0);
487 >    std::vector < int > tmpRigidBodiesInProc(nproc, 0);
488 >    std::vector < int > tmpCutoffGroupsInProc(nproc, 0);
489 >    std::vector < int > NumAtomsInProc(nproc, 0);
490 >    std::vector < int > NumRigidBodiesInProc(nproc, 0);
491 >    std::vector < int > NumCutoffGroupsInProc(nproc, 0);
492 >    
493 >    tmpAtomsInProc[myNode] = info->getNAtoms();
494 >    tmpRigidBodiesInProc[myNode] = info->getNRigidBodies();
495 >    tmpCutoffGroupsInProc[myNode] = info->getNCutoffGroups();
496 >    
497 >    //do MPI_ALLREDUCE to exchange the total number of atoms, rigidbodies and cutoff groups
498 >    MPI_Allreduce(&tmpAtomsInProc[0], &NumAtomsInProc[0], nproc, MPI_INT,
499 >                  MPI_SUM, MPI_COMM_WORLD);
500 >    MPI_Allreduce(&tmpRigidBodiesInProc[0], &NumRigidBodiesInProc[0], nproc,
501 >                  MPI_INT, MPI_SUM, MPI_COMM_WORLD);
502 >    MPI_Allreduce(&tmpCutoffGroupsInProc[0], &NumCutoffGroupsInProc[0], nproc,
503 >                  MPI_INT, MPI_SUM, MPI_COMM_WORLD);
504 >    
505 >    beginAtomIndex = 0;
506 >    beginRigidBodyIndex = 0;
507 >    beginCutoffGroupIndex = 0;
508 >    
509 >    for(int i = 0; i < myNode; i++) {
510 >      beginAtomIndex += NumAtomsInProc[i];
511 >      beginRigidBodyIndex += NumRigidBodiesInProc[i];
512 >      beginCutoffGroupIndex += NumCutoffGroupsInProc[i];
513 >    }
514 >    
515 > #endif
516 >    
517 >    //rigidbody's index begins right after atom's
518 >    beginRigidBodyIndex += info->getNGlobalAtoms();
519 >    
520 >    for(mol = info->beginMolecule(mi); mol != NULL;
521 >        mol = info->nextMolecule(mi)) {
522 >      
523 >      //local index(index in DataStorge) of atom is important
524 >      for(atom = mol->beginAtom(ai); atom != NULL; atom = mol->nextAtom(ai)) {
525 >        atom->setGlobalIndex(beginAtomIndex++);
526 >      }
527 >      
528 >      for(rb = mol->beginRigidBody(ri); rb != NULL;
529 >          rb = mol->nextRigidBody(ri)) {
530 >        rb->setGlobalIndex(beginRigidBodyIndex++);
531 >      }
532 >      
533 >      //local index of cutoff group is trivial, it only depends on the order of travesing
534 >      for(cg = mol->beginCutoffGroup(ci); cg != NULL;
535 >          cg = mol->nextCutoffGroup(ci)) {
536 >        cg->setGlobalIndex(beginCutoffGroupIndex++);
537 >      }
538 >    }
539 >    
540 >    //fill globalGroupMembership
541 >    std::vector<int> globalGroupMembership(info->getNGlobalAtoms(), 0);
542 >    for(mol = info->beginMolecule(mi); mol != NULL; mol = info->nextMolecule(mi)) {        
543 >      for (cg = mol->beginCutoffGroup(ci); cg != NULL; cg = mol->nextCutoffGroup(ci)) {
544 >        
545 >        for(atom = cg->beginAtom(ai); atom != NULL; atom = cg->nextAtom(ai)) {
546 >          globalGroupMembership[atom->getGlobalIndex()] = cg->getGlobalIndex();
547 >        }
548 >        
549 >      }      
550 >    }
551 >    
552 > #ifdef IS_MPI    
553 >    // Since the globalGroupMembership has been zero filled and we've only
554 >    // poked values into the atoms we know, we can do an Allreduce
555 >    // to get the full globalGroupMembership array (We think).
556 >    // This would be prettier if we could use MPI_IN_PLACE like the MPI-2
557 >    // docs said we could.
558 >    std::vector<int> tmpGroupMembership(nGlobalAtoms, 0);
559 >    MPI_Allreduce(&globalGroupMembership[0], &tmpGroupMembership[0], nGlobalAtoms,
560 >                  MPI_INT, MPI_SUM, MPI_COMM_WORLD);
561 >    info->setGlobalGroupMembership(tmpGroupMembership);
562 > #else
563 >    info->setGlobalGroupMembership(globalGroupMembership);
564 > #endif
565 >    
566 >    //fill molMembership
567 >    std::vector<int> globalMolMembership(info->getNGlobalAtoms(), 0);
568 >    
569 >    for(mol = info->beginMolecule(mi); mol != NULL; mol = info->nextMolecule(mi)) {
570 >      
571 >      for(atom = mol->beginAtom(ai); atom != NULL; atom = mol->nextAtom(ai)) {
572 >        globalMolMembership[atom->getGlobalIndex()] = mol->getGlobalIndex();
573 >      }
574 >    }
575 >    
576 > #ifdef IS_MPI
577 >    std::vector<int> tmpMolMembership(nGlobalAtoms, 0);
578 >    
579 >    MPI_Allreduce(&globalMolMembership[0], &tmpMolMembership[0], nGlobalAtoms,
580 >                  MPI_INT, MPI_SUM, MPI_COMM_WORLD);
581 >    
582 >    info->setGlobalMolMembership(tmpMolMembership);
583 > #else
584 >    info->setGlobalMolMembership(globalMolMembership);
585 > #endif
586 >    
587 >  }
588 >  
589 >  void SimCreator::loadCoordinates(SimInfo* info) {
590 >    Globals* simParams;
591 >    simParams = info->getSimParams();
592 >    
593 >    if (!simParams->haveInitialConfig()) {
594 >      sprintf(painCave.errMsg,
595 >              "Cannot intialize a simulation without an initial configuration file.\n");
596 >      painCave.isFatal = 1;;
597 >      simError();
598 >    }
599 >    
600 >    DumpReader reader(info, simParams->getInitialConfig());
601 >    int nframes = reader.getNFrames();
602 >    
603 >    if (nframes > 0) {
604 >      reader.readFrame(nframes - 1);
605 >    } else {
606 >      //invalid initial coordinate file
607 >      sprintf(painCave.errMsg,
608 >              "Initial configuration file %s should at least contain one frame\n",
609 >              simParams->getInitialConfig());
610 >      painCave.isFatal = 1;
611 >      simError();
612 >    }
613 >    
614 >    //copy the current snapshot to previous snapshot
615 >    info->getSnapshotManager()->advance();
616 >  }
617 >  
618 > } //end namespace oopse
619 >
620 >

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines