NetworkManager.C 212 KB
Newer Older
hrchilds's avatar
hrchilds committed
1 2
/*****************************************************************************
*
brugger's avatar
 
brugger committed
3
* Copyright (c) 2000 - 2009, Lawrence Livermore National Security, LLC
hrchilds's avatar
hrchilds committed
4
* Produced at the Lawrence Livermore National Laboratory
brugger's avatar
 
brugger committed
5
* LLNL-CODE-400124
hrchilds's avatar
hrchilds committed
6 7
* All rights reserved.
*
brugger's avatar
 
brugger committed
8
* This file is  part of VisIt. For  details, see https://visit.llnl.gov/.  The
hrchilds's avatar
hrchilds committed
9 10 11 12 13 14 15 16 17 18
* full copyright notice is contained in the file COPYRIGHT located at the root
* of the VisIt distribution or at http://www.llnl.gov/visit/copyright.html.
*
* Redistribution  and  use  in  source  and  binary  forms,  with  or  without
* modification, are permitted provided that the following conditions are met:
*
*  - Redistributions of  source code must  retain the above  copyright notice,
*    this list of conditions and the disclaimer below.
*  - Redistributions in binary form must reproduce the above copyright notice,
*    this  list of  conditions  and  the  disclaimer (as noted below)  in  the
brugger's avatar
 
brugger committed
19 20 21
*    documentation and/or other materials provided with the distribution.
*  - Neither the name of  the LLNS/LLNL nor the names of  its contributors may
*    be used to endorse or promote products derived from this software without
hrchilds's avatar
hrchilds committed
22 23 24 25 26
*    specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT  HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR  IMPLIED WARRANTIES, INCLUDING,  BUT NOT  LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND  FITNESS FOR A PARTICULAR  PURPOSE
brugger's avatar
 
brugger committed
27 28 29
* ARE  DISCLAIMED. IN  NO EVENT  SHALL LAWRENCE  LIVERMORE NATIONAL  SECURITY,
* LLC, THE  U.S.  DEPARTMENT OF  ENERGY  OR  CONTRIBUTORS BE  LIABLE  FOR  ANY
* DIRECT,  INDIRECT,   INCIDENTAL,   SPECIAL,   EXEMPLARY,  OR   CONSEQUENTIAL
hrchilds's avatar
hrchilds committed
30 31 32 33 34 35 36 37 38
* DAMAGES (INCLUDING, BUT NOT  LIMITED TO, PROCUREMENT OF  SUBSTITUTE GOODS OR
* SERVICES; LOSS OF  USE, DATA, OR PROFITS; OR  BUSINESS INTERRUPTION) HOWEVER
* CAUSED  AND  ON  ANY  THEORY  OF  LIABILITY,  WHETHER  IN  CONTRACT,  STRICT
* LIABILITY, OR TORT  (INCLUDING NEGLIGENCE OR OTHERWISE)  ARISING IN ANY  WAY
* OUT OF THE  USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*
*****************************************************************************/

hrchilds's avatar
hrchilds committed
39 40 41 42
// ************************************************************************* //
//                              NetworkManager.C                             //
// ************************************************************************* //

hrchilds's avatar
hrchilds committed
43
#include <snprintf.h>
hrchilds's avatar
hrchilds committed
44
#include <AttributeSubject.h>
hrchilds's avatar
hrchilds committed
45 46
#include <NetworkManager.h>
#include <DataNetwork.h>
hrchilds's avatar
hrchilds committed
47
#include <ClonedDataNetwork.h>
hrchilds's avatar
hrchilds committed
48 49 50
#include <DebugStream.h>
#include <avtDatabaseFactory.h>
#include <LoadBalancer.h>
hrchilds's avatar
hrchilds committed
51
#include <ConstructDDFAttributes.h>
hrchilds's avatar
hrchilds committed
52 53
#include <DBOptionsAttributes.h>
#include <ExportDBAttributes.h>
hrchilds's avatar
hrchilds committed
54
#include <MaterialAttributes.h>
hrchilds's avatar
hrchilds committed
55
#include <MeshManagementAttributes.h>
hrchilds's avatar
hrchilds committed
56
#include <avtExpressionEvaluatorFilter.h>
57 58
#include <avtNamedSelectionFilter.h>
#include <avtNamedSelectionManager.h>
hrchilds's avatar
hrchilds committed
59
#include <ImproperUseException.h>
hrchilds's avatar
hrchilds committed
60
#include <InvalidVariableException.h>
hrchilds's avatar
hrchilds committed
61 62 63 64 65
#include <DatabaseException.h>
#include <NoInputException.h>
#include <avtPluginFilter.h>
#include <OperatorPluginManager.h>
#include <OperatorPluginInfo.h>
66
#include <AnnotationObject.h>
hrchilds's avatar
hrchilds committed
67
#include <AnnotationObjectList.h>
fogal1's avatar
fogal1 committed
68
#include <AnnotationAttributes.h>
hrchilds's avatar
hrchilds committed
69
#include <PickAttributes.h>
hrchilds's avatar
hrchilds committed
70 71
#include <VisualCueInfo.h>
#include <VisualCueList.h>
hrchilds's avatar
hrchilds committed
72
#include <avtApplyDDFExpression.h>
hrchilds's avatar
hrchilds committed
73
#include <avtCallback.h>
hrchilds's avatar
hrchilds committed
74
#include <avtColorTables.h>
75
#include <avtDebugDumpOptions.h>
hrchilds's avatar
hrchilds committed
76
#include <avtExtents.h>
hrchilds's avatar
hrchilds committed
77 78
#include <avtNullData.h>
#include <avtDataObjectQuery.h>
hrchilds's avatar
hrchilds committed
79
#include <avtMultipleInputQuery.h>
hrchilds's avatar
hrchilds committed
80
#include <avtAreaBetweenCurvesQuery.h>
hrchilds's avatar
hrchilds committed
81
#include <avtFileWriter.h>
hrchilds's avatar
hrchilds committed
82
#include <avtDatabaseWriter.h>
hrchilds's avatar
hrchilds committed
83
#include <avtL2NormBetweenCurvesQuery.h>
hrchilds's avatar
hrchilds committed
84
#include <avtLocateQuery.h>
hrchilds's avatar
hrchilds committed
85
#include <avtLocateCellQuery.h>
hrchilds's avatar
hrchilds committed
86 87 88 89
#include <avtLocateNodeQuery.h>
#include <avtActualCoordsQuery.h>
#include <avtActualNodeCoordsQuery.h>
#include <avtActualZoneCoordsQuery.h>
hrchilds's avatar
hrchilds committed
90
#include <avtPickQuery.h>
hrchilds's avatar
hrchilds committed
91
#include <avtNodePickQuery.h>
hrchilds's avatar
hrchilds committed
92
#include <avtParallel.h>
hrchilds's avatar
hrchilds committed
93 94
#include <avtPickByNodeQuery.h>
#include <avtPickByZoneQuery.h>
95
#include <avtTransparencyActor.h>
hrchilds's avatar
hrchilds committed
96
#include <avtZonePickQuery.h>
hrchilds's avatar
hrchilds committed
97
#include <avtCurvePickQuery.h>
hrchilds's avatar
hrchilds committed
98
#include <avtSoftwareShader.h>
hrchilds's avatar
hrchilds committed
99 100
#include <avtDDF.h>
#include <avtDDFConstructor.h>
hrchilds's avatar
hrchilds committed
101 102 103
#include <avtSourceFromAVTImage.h>
#include <avtSourceFromImage.h>
#include <avtSourceFromNullData.h>
hrchilds's avatar
hrchilds committed
104
#include <avtTiledImageCompositor.h>
hrchilds's avatar
hrchilds committed
105 106
#include <avtWholeImageCompositerWithZ.h>
#include <avtWholeImageCompositerNoZ.h>
hrchilds's avatar
hrchilds committed
107
#include <avtPlot.h>
hrchilds's avatar
hrchilds committed
108 109
#include <avtQueryOverTimeFilter.h>
#include <avtQueryFactory.h>
hrchilds's avatar
hrchilds committed
110
#include <CompactSILRestrictionAttributes.h>
hrchilds's avatar
hrchilds committed
111
#include <VisWindow.h>
hrchilds's avatar
hrchilds committed
112
#include <VisWinRendering.h> // for SetStereoEnabled
hrchilds's avatar
hrchilds committed
113
#include <ParsingExprList.h>
hrchilds's avatar
hrchilds committed
114
#include <avtExprNode.h>
hrchilds's avatar
hrchilds committed
115 116
#include <DatabasePluginManager.h>
#include <DatabasePluginInfo.h>
hrchilds's avatar
hrchilds committed
117 118
#include <PlotPluginManager.h>
#include <PlotPluginInfo.h>
fogal1's avatar
fogal1 committed
119
#include <StackTimer.h>
hrchilds's avatar
hrchilds committed
120 121 122
#ifdef PARALLEL
#include <mpi.h>
#endif
hrchilds's avatar
hrchilds committed
123
#include <visit-config.h>
hrchilds's avatar
hrchilds committed
124
#include <TimingsManager.h>
125
#include <SaveWindowAttributes.h>
hrchilds's avatar
hrchilds committed
126

hrchilds's avatar
hrchilds committed
127
#include <set>
hrchilds's avatar
hrchilds committed
128
#include <map>
bonnell's avatar
bonnell committed
129
#include <algorithm>
130 131 132

#include <climits>

bonnell's avatar
bonnell committed
133 134
#include <vtkImageData.h>

hrchilds's avatar
hrchilds committed
135 136
using std::set;

hrchilds's avatar
hrchilds committed
137 138 139
//
// Static functions.
//
hrchilds's avatar
hrchilds committed
140 141
static void   DumpImage(avtDataObject_p, const char *fmt, bool allprocs=true);
static void   DumpImage(avtImage_p, const char *fmt, bool allprocs=true);
hrchilds's avatar
hrchilds committed
142 143
static ref_ptr<avtDatabase> GetDatabase(void *, const std::string &,
                                        int, const char *);
hrchilds's avatar
hrchilds committed
144
static avtDDF *GetDDFCallbackBridge(void *arg, const char *name);
bonnell's avatar
bonnell committed
145
static bool OnlyRootNodeHasData(avtImage_p &);
146
static void BroadcastImage(avtImage_p &, bool, int);
147
#ifdef PARALLEL
148
static bool IsBlankImage(avtImage_p img);
149 150
static std::vector<int> BuildBlankImageVector(avtImage_p img);
#endif
hrchilds's avatar
hrchilds committed
151

hrchilds's avatar
hrchilds committed
152 153 154 155 156 157 158 159 160 161
//
// Static data members of the NetworkManager class.
//
InitializeProgressCallback NetworkManager::initializeProgressCallback = NULL;
void                      *NetworkManager::initializeProgressCallbackArgs=NULL;
ProgressCallback           NetworkManager::progressCallback = NULL;
void                      *NetworkManager::progressCallbackArgs = NULL;



hrchilds's avatar
hrchilds committed
162 163 164 165 166 167 168 169 170
// ****************************************************************************
//  Method: NetworkManager default constructor
//
//  Programmer: Jeremy Meredith
//  Creation:   September 29, 2000
//
//  Modifications:
//
//    Kathleen Bonnell, Tue Nov 20 12:35:54 PST 2001
171
//    Initialize requireOriginalCells.
hrchilds's avatar
hrchilds committed
172
//
hrchilds's avatar
hrchilds committed
173 174 175
//    Hank Childs, Mon Jan  5 16:04:57 PST 2004
//    Initialize uniqueNetworkId.
//
hrchilds's avatar
hrchilds committed
176 177 178
//    Hank Childs, Thu Mar  4 09:11:46 PST 2004
//    Change instantiation of vis window, since it is now assumed to be nowin.
//
hrchilds's avatar
hrchilds committed
179 180 181
//    Mark C. Miller, Thu Apr 29 16:15:25 PDT 2004
//    Added missing initialization of dumpRenders
//
hrchilds's avatar
hrchilds committed
182 183 184
//    Mark C. Miller, Tue May 25 20:44:10 PDT 2004
//    Removed unnecessary scope. Set annotationAttributes data member
//
185 186
//    Kathleen Bonnell, Wed Jun  2 09:48:29 PDT 2004
//    Initialize requireOriginalNodes.
hrchilds's avatar
hrchilds committed
187
//
hrchilds's avatar
hrchilds committed
188 189 190 191
//    Mark C. Miller, Tue Jan  4 10:23:19 PST 2005
//    Made the viswin part of a map of EngineVisWinInfo objects
//    Removed some unnecessary initialization
//
hrchilds's avatar
hrchilds committed
192 193 194
//    Mark C. Miller, Wed Jan  5 10:14:21 PST 2005
//    Added call to NewVisWindow
//
hrchilds's avatar
hrchilds committed
195 196 197
//    Hank Childs, Mon Feb 28 16:56:20 PST 2005
//    Initialize inQueryMode.
//
hrchilds's avatar
hrchilds committed
198 199 200
//    Hank Childs, Fri Aug 26 15:44:48 PDT 2005
//    Register a callback to get databases.
//
hrchilds's avatar
hrchilds committed
201 202 203
//    Hank Childs, Sat Feb 18 11:31:23 PST 2006
//    Added a call back for the apply ddf expression.
//
204 205 206
//    Cyrus Harrison, Tue Feb 19 08:42:51 PST 2008
//    Removed dumpRenders (now controled by avtDebugDumpOptions)
//
207 208 209
//    Brad Whitlock, Tue Jun 24 15:40:29 PDT 2008
//    Added plugin managers.
//
hrchilds's avatar
hrchilds committed
210 211 212 213 214 215
// ****************************************************************************
NetworkManager::NetworkManager(void) : virtualDatabases()
{
    workingNet = NULL;
    loadBalancer = NULL;
    requireOriginalCells = false;
hrchilds's avatar
hrchilds committed
216
    requireOriginalNodes = false;
hrchilds's avatar
hrchilds committed
217
    inQueryMode = false;
hrchilds's avatar
hrchilds committed
218
    uniqueNetworkId = 0;
hrchilds's avatar
hrchilds committed
219

hrchilds's avatar
hrchilds committed
220
    // stuff to support scalable rendering. We always have window 0
hrchilds's avatar
hrchilds committed
221
    NewVisWindow(0);
hrchilds's avatar
hrchilds committed
222 223

    avtCallback::RegisterGetDatabaseCallback(GetDatabase, this);
hrchilds's avatar
hrchilds committed
224 225 226
    avtApplyDDFExpression::RegisterGetDDFCallback(GetDDFCallbackBridge, this);
    avtExpressionEvaluatorFilter::RegisterGetDDFCallback(
                                                  GetDDFCallbackBridge, this);
227 228 229 230

    databasePlugins = new DatabasePluginManager;
    operatorPlugins = new OperatorPluginManager;
    plotPlugins = new PlotPluginManager;
hrchilds's avatar
hrchilds committed
231 232 233 234 235 236 237 238 239
}

// ****************************************************************************
//  Method: NetworkManager destructor
//
//  Programmer: Jeremy Meredith
//  Creation:   September 29, 2000
//
//  Modifications:
hrchilds's avatar
hrchilds committed
240 241 242 243 244 245
//    Sean Ahern, Fri May 24 11:12:25 PDT 2002
//    Got rid of deletion of the database cache, since all DBs in there
//    will be deleted by deleting the network cache.
//
//    Hank Childs, Mon Jan  5 16:30:04 PST 2004
//    Don't assume the caches are valid.
hrchilds's avatar
hrchilds committed
246
//
hrchilds's avatar
hrchilds committed
247 248 249
//    Mark C. Miller, Tue Jan  4 10:23:19 PST 2005
//    Added code to delete VisWindow objects
//
hrchilds's avatar
hrchilds committed
250 251 252
//    Hank Childs, Mon Feb 13 23:14:23 PST 2006
//    Delete the DDFs.
//
253 254 255
//    Brad Whitlock, Tue Jun 24 15:41:08 PDT 2008
//    Added plugin managers.
//
hrchilds's avatar
hrchilds committed
256
// ****************************************************************************
257

hrchilds's avatar
hrchilds committed
258 259
NetworkManager::~NetworkManager(void)
{
260
    for (size_t i = 0; i < networkCache.size(); i++)
hrchilds's avatar
hrchilds committed
261 262
        if (networkCache[i] != NULL)
            delete networkCache[i];
hrchilds's avatar
hrchilds committed
263 264 265 266

    std::map<int, EngineVisWinInfo>::iterator it;
    for (it = viswinMap.begin(); it != viswinMap.end(); it++)
        delete it->second.viswin;
hrchilds's avatar
hrchilds committed
267

268
    for (size_t d = 0 ; d < ddf.size() ; d++)
hrchilds's avatar
hrchilds committed
269
        delete ddf[d];
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

    delete databasePlugins;
    delete operatorPlugins;
    delete plotPlugins;
}

// ****************************************************************************
// Method: NetworkManager::GetDatabasePluginManager
//
// Purpose: 
//   Return the database plugin manager.
//
// Returns:    the database plugin manager.
//
// Programmer: Brad Whitlock
// Creation:   Tue Jun 24 15:25:41 PDT 2008
//
// Modifications:
//   
// ****************************************************************************

DatabasePluginManager *
NetworkManager::GetDatabasePluginManager() const
{
    return databasePlugins;
}

// ****************************************************************************
// Method: NetworkManager::GetOperatorPluginManager
//
// Purpose: 
//   Return the operator plugin manager.
//
// Returns:    the operator plugin manager.
//
// Programmer: Brad Whitlock
// Creation:   Tue Jun 24 15:26:07 PDT 2008
//
// Modifications:
//   
// ****************************************************************************

OperatorPluginManager *
NetworkManager::GetOperatorPluginManager() const
{
    return operatorPlugins;
}

// ****************************************************************************
// Method: NetworkManager::GetPlotPluginManager
//
// Purpose: 
//   Return the plot plugin manager.
//
// Returns:    the plot plugin manager.
//
// Programmer: Brad Whitlock
// Creation:   Tue Jun 24 15:26:28 PDT 2008
//
// Modifications:
//   
// ****************************************************************************

PlotPluginManager *
NetworkManager::GetPlotPluginManager() const
{
    return plotPlugins;
hrchilds's avatar
hrchilds committed
337 338 339 340 341 342 343 344 345 346 347 348
}

// ****************************************************************************
//  Method: NetworkManager::ClearAllNetworks
//
//  Purpose:
//      Clears out the caches.  Really only used for checking for memory leaks.
//
//  Programmer: Hank Childs
//  Creation:   January 7, 2001
//
//  Modifications:
hrchilds's avatar
hrchilds committed
349 350 351 352 353
//    Sean Ahern, Tue May 14 14:35:42 PDT 2002
//    Retrofitted for my new network management techniques.
//
//    Sean Ahern, Tue May 21 16:09:56 PDT 2002
//    Told the underlying objects to free their data.
hrchilds's avatar
hrchilds committed
354
//
hrchilds's avatar
hrchilds committed
355 356 357
//    Hank Childs, Mon Jan  5 16:30:04 PST 2004
//    Don't clear out the vectors, so this can be consistent with how the
//    ClearNetworksWithDatabase works.
hrchilds's avatar
hrchilds committed
358
//
hrchilds's avatar
hrchilds committed
359 360 361
//    Brad Whitlock, Thu Feb 26 11:58:58 PDT 2004
//    I replaced the commented out cerr with debug3.
//
hrchilds's avatar
hrchilds committed
362 363 364 365 366
//    Hank Childs, Sun Mar  7 16:05:03 PST 2004
//    Delete the networks before the databases, since the networks have
//    references to the databases (and the previous ordering yielded dangling
//    pointers).
//
hrchilds's avatar
hrchilds committed
367 368 369 370
//    Mark C. Miller, Wed Sep  8 17:06:25 PDT 2004
//    Added code to clear the vis window and the list of plots currently in
//    the window.
//
hrchilds's avatar
hrchilds committed
371 372 373 374
//    Mark C. Miller, Mon Sep 13 18:30:26 PDT 2004
//    Protected call to clear viswin and plotsCurrentlyInWindow with test
//    for emptiness
//
hrchilds's avatar
hrchilds committed
375 376 377
//    Mark C. Miller, Tue Jan  4 10:23:19 PST 2005
//    Added code to delete VisWindow objects
//
hrchilds's avatar
hrchilds committed
378 379 380
//    Hank Childs, Thu Mar  2 10:06:33 PST 2006
//    Added support for image based plots.
//
hrchilds's avatar
hrchilds committed
381 382 383 384
// ****************************************************************************
void
NetworkManager::ClearAllNetworks(void)
{
hrchilds's avatar
hrchilds committed
385
    debug3 << "NetworkManager::ClearAllNetworks(void)" << endl;
hrchilds's avatar
hrchilds committed
386

387
    for (size_t i = 0; i < networkCache.size(); i++)
hrchilds's avatar
hrchilds committed
388 389 390 391 392 393
    {
        if (networkCache[i] != NULL)
            delete networkCache[i];
        networkCache[i] = NULL;
    }

394
    for (size_t i = 0; i < databaseCache.size(); i++)
hrchilds's avatar
hrchilds committed
395 396 397 398 399 400
    {
        if (databaseCache[i] != NULL)
            delete databaseCache[i];
        databaseCache[i] = NULL;
    }

401
    for (size_t i = 0 ; i < globalCellCounts.size() ; i++)
hrchilds's avatar
hrchilds committed
402
    {
hrchilds's avatar
hrchilds committed
403
        globalCellCounts[i] = -1;
hrchilds's avatar
hrchilds committed
404
    }
hrchilds's avatar
hrchilds committed
405 406 407 408 409 410

    std::map<int, EngineVisWinInfo>::iterator it;
    for (it = viswinMap.begin(); it != viswinMap.end(); it++)
    {
        it->second.viswin->ClearPlots();
        it->second.plotsCurrentlyInWindow.clear();
hrchilds's avatar
hrchilds committed
411
        it->second.imageBasedPlots.clear();
hrchilds's avatar
hrchilds committed
412 413 414 415
        delete it->second.viswin;
    }
    viswinMap.clear();
    NewVisWindow(0);
hrchilds's avatar
hrchilds committed
416 417 418 419 420 421 422 423 424 425 426 427 428 429
}

// ****************************************************************************
//  Method: NetworkManager::ClearNetworksWithDatabase
//
//  Purpose:
//      Clears out the caches that reference a specific database.
//
//  Arguments:
//      db      The name of a database.
//
//  Programmer: Hank Childs
//  Creation:   January 5, 2004
//
hrchilds's avatar
hrchilds committed
430 431 432 433
//  Modifications:
//    Brad Whitlock, Thu Feb 26 11:58:58 PDT 2004
//    I replaced the commented out cerr with debug3.
//
hrchilds's avatar
hrchilds committed
434 435 436
//    Mark C. Miller, Wed Sep  8 17:06:25 PDT 2004
//    Added code to clear the vis window and the list of plots currently in
//    the window for the first plot id it encounters in this db
hrchilds's avatar
hrchilds committed
437 438 439 440
//
//    Mark C. Miller, Mon Sep 13 18:30:26 PDT 2004
//    Moved code to delete the networkCache entry to after the clearning
//    of the viswin.
hrchilds's avatar
hrchilds committed
441 442 443
//
//    Mark C. Miller, Tue Jan  4 10:23:19 PST 2005
//    Modified for viswinMap object
hrchilds's avatar
hrchilds committed
444 445 446 447
// ****************************************************************************
void
NetworkManager::ClearNetworksWithDatabase(const std::string &db)
{
hrchilds's avatar
hrchilds committed
448
    debug3 << "NetworkManager::ClearNetworksWithDatabase()" << endl;
hrchilds's avatar
hrchilds committed
449

450
    //
hrchilds's avatar
hrchilds committed
451 452 453
    // Clear out the networks before the databases.  This is because if we
    // delete the databases first, the networks will have dangling pointers.
    //
454
    for (size_t i = 0; i < networkCache.size(); i++)
hrchilds's avatar
hrchilds committed
455 456 457 458 459 460 461 462
    {
        if (networkCache[i] != NULL)
        {
            NetnodeDB *ndb = networkCache[i]->GetNetDB();
            if (ndb != NULL)
            {
                if (ndb->GetFilename() == db)
                {
hrchilds's avatar
hrchilds committed
463
                    DoneWithNetwork(i);
hrchilds's avatar
hrchilds committed
464 465 466 467
                }
            }
        }
    }
hrchilds's avatar
hrchilds committed
468

469
    for (size_t i = 0; i < databaseCache.size(); i++)
hrchilds's avatar
hrchilds committed
470 471 472 473 474 475 476 477 478 479
    {
        if (databaseCache[i] != NULL)
        {
            if (databaseCache[i]->GetFilename() == db)
            {
                delete databaseCache[i];
                databaseCache[i] = NULL;
            }
        }
    }
hrchilds's avatar
hrchilds committed
480 481 482
}

// ****************************************************************************
hrchilds's avatar
hrchilds committed
483
//  Method: NetworkManager::GetDBFromCache
hrchilds's avatar
hrchilds committed
484 485
//
//  Purpose:
hrchilds's avatar
hrchilds committed
486 487 488 489 490 491 492 493 494 495 496 497 498
//      Get a DB from the cache.  If it's not there already, create it and
//      return it.
//
//  Programmer: Sean Ahern
//  Creation:   Mon Dec 23 12:28:30 PST 2002
//
//  Modifications:
//
//    Brad Whitlock, Wed May 14 12:56:16 PDT 2003
//    I made it get the metadata and the SIL if the time is greater than 0.
//    This ensures that we pick up the metadata and SIL for the time state
//    that we're intersted in.
//
hrchilds's avatar
hrchilds committed
499 500 501 502
//    Brad Whitlock, Mon Aug 25 16:51:35 PST 2003
//    Changed the return statement to CATCH_RETURN2 so bad things don't happen
//    when we use fake exceptions.
//
hrchilds's avatar
hrchilds committed
503 504 505
//    Mark C. Miller Thu Oct  9 10:59:27 PDT 2003
//    I modified to force GetMetaData and GetSIL if they're invariant 
//
hrchilds's avatar
hrchilds committed
506 507 508
//    Hank Childs, Tue Nov  4 14:19:05 PST 2003
//    Checked in work-around (HACK) to avoid apparent compiler bug on AIX.
//
hrchilds's avatar
hrchilds committed
509 510 511
//    Hank Childs, Mon Jan  5 16:49:28 PST 2004
//    Do not assume that all of the cached databases are non-NULL.
//
hrchilds's avatar
hrchilds committed
512 513 514
//    Hank Childs, Mon Mar  1 08:48:26 PST 2004
//    Send the time to the database factory as well.
//
hrchilds's avatar
hrchilds committed
515 516 517
//    Hank Childs, Mon Mar 22 11:10:43 PST 2004
//    Allow for the DB type to be explicitly specified.
//
hrchilds's avatar
hrchilds committed
518 519 520 521 522
//    Mark C. Miller, Tue Sep 28 19:57:42 PDT 2004
//    Added code to pass avtDatabaseMetaData to LoadBalancer->AddDatabase
//
//    Hank Childs, Sun Feb 27 12:30:17 PST 2005
//    Added avtDatabase argument to AddDatabase.
hrchilds's avatar
hrchilds committed
523
//
hrchilds's avatar
hrchilds committed
524 525 526
//    Hank Childs, Tue Sep 20 13:03:00 PDT 2005
//    Don't assume that filename lengths are bigger than 6 characters ['6616].
//
hrchilds's avatar
hrchilds committed
527 528 529 530 531 532 533
//    Hank Childs, Fri Oct  7 17:22:01 PDT 2005
//    Tell database what it's full name is.  Also, remove some antiquated code
//    that the variable name in the DB info to the empty string.  I believe
//    the code was no longer doing anything useful, besides torpedoing SR
//    and CMFE when used in combination.  The test suite passes without it
//    and there is really no explanation for why we were doing it.
//
hrchilds's avatar
hrchilds committed
534 535
//    Mark C. Miller, Wed Nov 16 10:46:36 PST 2005
//    Changed interface to lb->AddDatabase 
hrchilds's avatar
hrchilds committed
536 537 538 539
//
//    Hank Childs, Thu Jan 11 16:10:12 PST 2007
//    Added argument to DatabaseFactory calls.
//
540 541
//    Mark C. Miller, Thu Jun 14 10:26:37 PDT 2007
//    Added support to treat all databases as time varying
542 543 544
//
//    Mark C. Miller, Wed Aug 22 20:16:59 PDT 2007
//    Added treatAllDBsAsTimeVarying to GetSIL call
545 546 547 548
//
//    Hank Childs, Fri Feb  1 15:45:28 PST 2008
//    Added argument for loading database plugins.
//
549 550
//    Mark C. Miller, Tue Jun 10 22:36:25 PDT 2008
//    Added support for ignoring bad extents from dbs.
551 552 553 554
//
//    Brad Whitlock, Tue Jun 24 15:45:43 PDT 2008
//    Pass the database plugin manager to the factory.
//
hrchilds's avatar
hrchilds committed
555
// ****************************************************************************
hrchilds's avatar
hrchilds committed
556

hrchilds's avatar
hrchilds committed
557
NetnodeDB *
hrchilds's avatar
hrchilds committed
558
NetworkManager::GetDBFromCache(const string &filename, int time,
559
    const char *format, bool treatAllDBsAsTimeVarying, 
560
    bool fileMayHaveUnloadedPlugin, bool ignoreExtents)
hrchilds's avatar
hrchilds committed
561 562 563 564
{
    // If we don't have a load balancer, we're dead.
    if (loadBalancer == NULL)
    {
hrchilds's avatar
hrchilds committed
565 566
        debug1 << "Internal error: A load balancer was never registered." 
               << endl;
hrchilds's avatar
hrchilds committed
567 568 569
        EXCEPTION0(ImproperUseException);
    }

hrchilds's avatar
hrchilds committed
570 571
    // Find a matching database 
    NetnodeDB* cachedDB = NULL;
572
    for (size_t i = 0; i < databaseCache.size(); i++)
hrchilds's avatar
hrchilds committed
573
    {
hrchilds's avatar
hrchilds committed
574 575
        if (databaseCache[i] == NULL)
            continue;
hrchilds's avatar
hrchilds committed
576
        if (databaseCache[i]->GetFilename() == filename)
hrchilds's avatar
hrchilds committed
577
        {
hrchilds's avatar
hrchilds committed
578 579
            cachedDB = databaseCache[i];
            break;
hrchilds's avatar
hrchilds committed
580
        }
hrchilds's avatar
hrchilds committed
581 582
    }

583 584 585 586
    // use of these makes calls to GetMetaData a little clearer
    const bool forceReadAllCyclesAndTimes = false;
    const bool forceReadThisCycleAndTime  = false;

hrchilds's avatar
hrchilds committed
587 588 589 590 591
    // got a match
    if (cachedDB != NULL)
    {
        // even if we found the DB in the cache,
        // we need to update the metadata if its time-varying
592
        if (treatAllDBsAsTimeVarying ||
593
            !cachedDB->GetDB()->MetaDataIsInvariant() ||
hrchilds's avatar
hrchilds committed
594
            !cachedDB->GetDB()->SILIsInvariant())
hrchilds's avatar
hrchilds committed
595
        {
596
            cachedDB->GetDB()->GetMetaData(time,
597 598 599
                                           forceReadAllCyclesAndTimes,
                                           forceReadThisCycleAndTime,
                                           treatAllDBsAsTimeVarying);
600
            cachedDB->GetDB()->GetSIL(time, treatAllDBsAsTimeVarying);
hrchilds's avatar
hrchilds committed
601
        }
hrchilds's avatar
hrchilds committed
602 603

        return cachedDB;
hrchilds's avatar
hrchilds committed
604 605 606 607 608 609
    }

    // No match.  Load a new DB.
    debug3 << "Loading new database" << endl;
    TRY
    {
610
        if (fileMayHaveUnloadedPlugin)
611 612
             GetDatabasePluginManager()->LoadPluginsNow();

hrchilds's avatar
hrchilds committed
613 614 615
        avtDatabase *db = NULL;
        NetnodeDB *netDB = NULL;
        const char *filename_c = filename.c_str();
hrchilds's avatar
hrchilds committed
616
        std::vector<std::string> plugins;  // unused
hrchilds's avatar
hrchilds committed
617 618
        if (filename.length() >= 6 &&
            filename.substr(filename.length() - 6) == ".visit")
619 620 621 622 623 624 625 626
        {
            db = avtDatabaseFactory::VisitFile(
                GetDatabasePluginManager(),
                filename_c,
                time,
                plugins,
                format);
        }
hrchilds's avatar
hrchilds committed
627
        else
628 629 630 631 632 633 634 635 636 637
        {
            db = avtDatabaseFactory::FileList(
                GetDatabasePluginManager(),
                &filename_c,
                1,
                time,
                plugins, 
                format);
        }

hrchilds's avatar
hrchilds committed
638
        db->SetFullDBName(filename);
639
        db->SetIgnoreExtents(ignoreExtents);
hrchilds's avatar
hrchilds committed
640 641

        // If we want to open the file at a later timestep, get the
hrchilds's avatar
hrchilds committed
642 643
        // SIL so that it contains the right data.
        if ((time > 0) ||
644
            treatAllDBsAsTimeVarying ||
hrchilds's avatar
hrchilds committed
645 646
            (!db->MetaDataIsInvariant()) ||
            (!db->SILIsInvariant()))
hrchilds's avatar
hrchilds committed
647 648 649
        {
            debug2 << "NetworkManager::AddDB: We were instructed to open "
                   << filename.c_str() << " at timestate=" << time
hrchilds's avatar
hrchilds committed
650
                   << " so we're reading the SIL early."
hrchilds's avatar
hrchilds committed
651
                   << endl;
652
            db->GetMetaData(time,
653 654 655
                            forceReadAllCyclesAndTimes,
                            forceReadThisCycleAndTime,
                            treatAllDBsAsTimeVarying);
656
            db->GetSIL(time, treatAllDBsAsTimeVarying);
hrchilds's avatar
hrchilds committed
657 658 659 660 661 662
        }

        netDB = new NetnodeDB(db);
        databaseCache.push_back(netDB);

        netDB->SetDBInfo(filename, "", time);
hrchilds's avatar
hrchilds committed
663
        loadBalancer->AddDatabase(filename, db, time);
hrchilds's avatar
hrchilds committed
664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699
      
        // The code here should be:
        // CATCH_RETURN2(1, netDB);
        //
        // However: this is crashing on AIX when you do a re-open (see '3984).
        // After investigating this bug, I have determined the following:
        // (1) A valid pointer is being returned from this function.  However
        // the calling function receives NULL (leading to a seg fault).
        // (2) When compiling with fake exceptions and running under purify
        // on the Suns, there are no warnings.
        // (3) The catch return unwinds into 3 calls.  If you put a print
        // statement right before the last one (the return), everything is
        // returned correctly and there is no seg fault.
        //
        // I'm always very leery to call something a compiler bug.  However,
        // on different platforms there is no problem.  I think it is even
        // more fishy that things work if there is a print statement and don't
        // if there is not.  It certainly sounds like a compiler bug.
        //
        // Below is code that "makes this work".  It is essentially a
        // CATCH_RETURN2 with a print statement in the middle.  If CATCH_RETURN
        // were to ever change, this coding would have to change as well
        // (thus, I have introduced a maintenance problem).  As such, I put
        // a comment in VisItException.h referencing this comment.  If the
        // coding below can ever be replaced with an everyday CATCH_RETURN,
        // the comment in VisItException.h should be removed.
        //
#ifdef FAKE_EXCEPTIONS
           exception_delete(exception_caught); 
           jump_stack_top -= (1); 
           debug5 << "This debug statement (from the NetworkManager) is "
                  << "being issued to get around a compiler bug." << endl;
           return (netDB); 
#else
           return netDB;
#endif
hrchilds's avatar
hrchilds committed
700 701 702 703 704 705 706 707 708 709 710 711 712 713 714
    }
    CATCH(DatabaseException)
    {
        debug1 << "ERROR - could not create database " << filename.c_str()
            << endl;
        RETHROW;
    }
    ENDTRY
}

// ****************************************************************************
//  Method: NetworkManager::StartNetwork
//
//  Purpose:
//      Start building the pipeline.
hrchilds's avatar
hrchilds committed
715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760
//
//  Programmer: Jeremy Meredith
//  Creation:   September 29, 2000
//
//  Modifications:
//
//    Jeremy Meredith, Thu Nov  2 14:07:34 PST 2000
//    Changed the file initialization.  Apparently substr() may not portably 
//    be a const method of strings....
//
//    Hank Childs, Tue Jun 12 20:01:55 PDT 2001
//    Incorporate data specifications and the load balancer.
//
//    Jeremy Meredith, Thu Jul 26 12:08:42 PDT 2001
//    Fixed a bug passing the data file name to the load balancer.
//
//    Hank Childs, Thu Jul 26 20:17:56 PDT 2001
//    Re-enable caching by checking data specifications.
//
//    Brad Whitlock, Mon Oct 22 18:33:37 PST 2001
//    Changed the exception keywords to macros.
//
//    Jeremy Meredith, Fri Nov  9 10:24:23 PST 2001
//    Replaced netPool with netMRU, and simply made it release its
//    data, not delete the whole network. Made is only set the data
//    specification, not the pipeline specification yet.
//
//    Hank Childs, Fri Dec 14 17:39:36 PST 2001
//    Add support for using a more compact version of sil attributes.
//
//    Sean Ahern, Mon May 13 17:24:25 PDT 2002
//    Refactored to start support for a tree-based network scheme.
//
//    Sean Ahern, Tue May 28 09:47:21 PDT 2002
//    Added tree-based networks.
//
//    Brad Whitlock, Fri Jun 28 14:03:49 PST 2002
//    I renamed Network to DataNetwork to make the Windows compiler happy.
//
//    Hank Childs, Thu Sep 12 11:11:16 PDT 2002
//    There was an issue with multiple networks sharing NetnodeDBs, so I
//    made them all have their own reference.
//
//    Jeremy Meredith, Thu Oct 24 16:03:39 PDT 2002
//    Added material options.
//
hrchilds's avatar
hrchilds committed
761 762 763 764 765 766
//    Sean Ahern, Mon Dec 23 12:38:17 PST 2002
//    Changed this dramatically.  Broke out a good portion of the logic
//    into GetDBFromCache.
//
//    Sean Ahern, Sat Mar  8 00:59:16 America/Los_Angeles 2003
//    Cleaned up unnecessarily complicated code.
hrchilds's avatar
hrchilds committed
767
//
hrchilds's avatar
hrchilds committed
768 769 770
//    Jeremy Meredith, Wed Jul 30 10:45:45 PDT 2003
//    Added the check for requiring full connectivity.
//
hrchilds's avatar
hrchilds committed
771 772 773
//    Jeremy Meredith, Fri Sep  5 15:23:13 PDT 2003
//    Added a flag for the new MIR algorithm.
//
hrchilds's avatar
hrchilds committed
774 775 776
//    Jeremy Meredith, Thu Oct 30 16:09:32 PST 2003
//    Added code to make sure varLeaves was non-empty before accessing it.
//
hrchilds's avatar
hrchilds committed
777 778 779
//    Jeremy Meredith, Fri Oct 31 13:05:26 PST 2003
//    Made the error message for no-real-variables more informative.
//
hrchilds's avatar
hrchilds committed
780 781 782 783
//    Hank Childs, Sun Mar  7 16:05:03 PST 2004
//    Do not make the database be a node for the network.  Also add the EEF
//    as a node.
//
hrchilds's avatar
hrchilds committed
784 785 786
//    Jeremy Meredith, Tue Mar 23 14:40:20 PST 2004
//    Added the file format as an argument.  Made use of it in GetDBFromCache.
//
hrchilds's avatar
hrchilds committed
787 788 789
//    Mark C. Miller, Thu Aug 19 10:28:45 PDT 2004
//    Removed #ifdef 0 code block
//
hrchilds's avatar
hrchilds committed
790 791 792 793 794 795
//    Jeremy Meredith, Tue Dec 14 14:02:35 PST 2004
//    The code to get the real variable name was a duplicate of two
//    other spots in VisIt, but this one was out of date.  I
//    refactored the best one into ParsingExprList::GetRealVariable
//    and made this one point to it.
//
hrchilds's avatar
hrchilds committed
796 797 798 799
//    Brad Whitlock, Tue Feb 22 12:13:44 PDT 2005
//    Made format argument come first. I also made it possible for an empty
//    format string to make the code behave as through no format was specified.
//
hrchilds's avatar
hrchilds committed
800 801 802
//    Hank Childs, Wed Jul 13 10:38:02 PDT 2005
//    Added call to SetTime to prevent UMR when exporting databases.
//
hrchilds's avatar
hrchilds committed
803 804 805
//    Hank Childs, Wed Aug 17 21:55:55 PDT 2005
//    Pass along the material options to simplify the interface reconstruction.
//
hrchilds's avatar
hrchilds committed
806 807 808
//    Jeremy Meredith, Thu Aug 18 17:54:51 PDT 2005
//    Added a new isovolume algorithm, with adjustable VF cutoff.
//
hrchilds's avatar
hrchilds committed
809 810
//    Mark C. Miller, Wed Nov 16 10:46:36 PST 2005
//    Added mesh management attributes 
hrchilds's avatar
hrchilds committed
811 812 813
//
//    Mark C. Miller, Sun Dec  3 12:20:11 PST 2006
//    Added setting of flatness tolerance to data spec for CSG stuff
hrchilds's avatar
hrchilds committed
814 815 816 817 818
//
//    Hank Childs, Wed Jan 17 10:42:21 PST 2007
//    Tell the output of the expression evaluator filter that it is *not*
//    transient, since picks sometimes like to look at these.
//
819 820
//    Mark C. Miller, Thu Jun 14 10:26:37 PDT 2007
//    Added support to treat all databases as time varying
821 822 823
//
//    Mark C. Miller, Wed Aug 22 20:16:59 PDT 2007
//    Added treatAllDBsAsTimeVarying to GetSIL call.
824 825 826 827
//
//    Hank Childs, Fri Feb  1 15:48:01 PST 2008
//    Add new Boolean argument to GetDBFromCache. 
//
828 829
//    Mark C. Miller, Tue Jun 10 22:36:25 PDT 2008
//    Added support for ignoring bad extents from dbs.
830 831 832 833
//
//    Hank Childs, Fri Jan 16 15:30:15 PST 2009
//    Store the variable with the working network.
//
834 835 836
//    John C. Anderson, Thu Jan 15 10:20:20 2009
//    Added annealing time for Discrete MIR.
//
837 838 839
//    Jeremy Meredith, Fri Feb 13 11:22:39 EST 2009
//    Added MIR iteration capability.
//
hrchilds's avatar
hrchilds committed
840
// ****************************************************************************
hrchilds's avatar
hrchilds committed
841

hrchilds's avatar
hrchilds committed
842
void
hrchilds's avatar
hrchilds committed
843 844
NetworkManager::StartNetwork(const string &format,
                             const string &filename,
hrchilds's avatar
hrchilds committed
845
                             const string &var,
hrchilds's avatar
hrchilds committed
846 847
                             int time,
                             const CompactSILRestrictionAttributes &atts,
hrchilds's avatar
hrchilds committed
848
                             const MaterialAttributes &matopts,
849
                             const MeshManagementAttributes &meshopts,
850 851
                             bool treatAllDBsAsTimeVarying,
                             bool ignoreExtents)
hrchilds's avatar
hrchilds committed
852
{
hrchilds's avatar
hrchilds committed
853 854
    // If the variable is an expression, we need to find a "real" variable
    // name to work with.
hrchilds's avatar
hrchilds committed
855
    string leaf = ParsingExprList::GetRealVariable(var);
hrchilds's avatar
hrchilds committed
856

hrchilds's avatar
hrchilds committed
857 858 859 860 861
    // Make empty strings behave as though no format was specified.
    const char *defaultFormat = 0;
    if(format.size() > 0)
        defaultFormat = format.c_str();

hrchilds's avatar
hrchilds committed
862 863
    // Start up the DataNetwork and add the database to it.
    workingNet = new DataNetwork;
864
    bool fileMayHaveUnloadedPlugin = false;
865
    NetnodeDB *netDB = GetDBFromCache(filename, time, defaultFormat,
866
                                      treatAllDBsAsTimeVarying, 
867 868
                                      fileMayHaveUnloadedPlugin,
                                      ignoreExtents);
hrchilds's avatar
hrchilds committed
869
    workingNet->SetNetDB(netDB);
870
    workingNet->SetVariable(leaf);
hrchilds's avatar
hrchilds committed
871
    netDB->SetDBInfo(filename, leaf, time);
hrchilds's avatar
hrchilds committed
872

hrchilds's avatar
hrchilds committed
873 874 875 876 877
    // Put an ExpressionEvaluatorFilter right after the netDB to handle
    // expressions that come up the pipe.
    avtExpressionEvaluatorFilter *f = new avtExpressionEvaluatorFilter();
    NetnodeFilter *filt = new NetnodeFilter(f, "ExpressionEvaluator");
    filt->GetInputNodes().push_back(netDB);
hrchilds's avatar
hrchilds committed
878
    f->GetOutput()->SetTransientStatus(false);
hrchilds's avatar
hrchilds committed
879

hrchilds's avatar
hrchilds committed
880 881
    // Push the ExpressionEvaluator onto the working list.
    workingNetnodeList.push_back(filt);
hrchilds's avatar
hrchilds committed
882

hrchilds's avatar
hrchilds committed
883
    workingNet->AddNode(filt);
hrchilds's avatar
hrchilds committed
884
    // Push the variable name onto the name stack.
hrchilds's avatar
hrchilds committed
885
    nameStack.push_back(var);
886
    debug4 << "NetworkManager::AddDB: Adding " << var.c_str()
hrchilds's avatar
hrchilds committed
887 888 889
           << " to the name stack" << endl;

    // Set up the data spec.
hrchilds's avatar
hrchilds committed
890
    avtSILRestriction_p silr =
891
        new avtSILRestriction(workingNet->GetNetDB()->GetDB()->
892
            GetSIL(time, treatAllDBsAsTimeVarying), atts);
hrchilds's avatar
hrchilds committed
893
    avtDataRequest *dataRequest = new avtDataRequest(var.c_str(), time, silr);
hrchilds's avatar
hrchilds committed
894 895

    // Set up some options from the data specification
hrchilds's avatar
hrchilds committed
896 897 898 899 900
    dataRequest->SetNeedMixedVariableReconstruction(matopts.GetForceMIR());
    dataRequest->SetNeedSmoothMaterialInterfaces(matopts.GetSmoothing());
    dataRequest->SetNeedCleanZonesOnly(matopts.GetCleanZonesOnly());
    dataRequest->SetNeedValidFaceConnectivity(matopts.GetNeedValidConnectivity());
    dataRequest->SetMIRAlgorithm(matopts.GetAlgorithm());
901 902 903
    dataRequest->SetMIRNumIterations(matopts.GetIterationEnabled() ?
                                     matopts.GetNumIterations() : 0);
    dataRequest->SetMIRIterationDamping(matopts.GetIterationDamping());
hrchilds's avatar
hrchilds committed
904 905 906
    dataRequest->SetSimplifyHeavilyMixedZones(matopts.GetSimplifyHeavilyMixedZones());
    dataRequest->SetMaxMaterialsPerZone(matopts.GetMaxMaterialsPerZone());
    dataRequest->SetIsovolumeMIRVF(matopts.GetIsoVolumeFraction());
907
    dataRequest->SetAnnealingTime(matopts.GetAnnealingTime());
hrchilds's avatar
hrchilds committed
908 909 910 911 912 913 914
    dataRequest->SetDiscTol(meshopts.GetDiscretizationTolerance()[0]);
    dataRequest->SetFlatTol(meshopts.GetDiscretizationTolerance()[1]);
    dataRequest->SetDiscMode(meshopts.GetDiscretizationMode());
    dataRequest->SetDiscBoundaryOnly(meshopts.GetDiscretizeBoundaryOnly());
    dataRequest->SetPassNativeCSG(meshopts.GetPassNativeCSG());
    workingNet->SetDataSpec(dataRequest);
    workingNet->SetTime(dataRequest->GetTimestep());
hrchilds's avatar
hrchilds committed
915 916 917 918 919 920 921 922 923 924 925 926 927 928 929

    // The plot starts out as NULL.
    workingNet->SetPlot(NULL);
}

// ****************************************************************************
// Method: NetworkManager::DefineDB
//
// Purpose: 
//   Defines a new database with the specified name and list of files.
//
// Arguments:
//    dbName   : The database name.
//    files    : The list of files that make up the database.
//    time     : The timestep that we want to examine.
hrchilds's avatar
hrchilds committed
930
//    format   : The file format type of the DB.
hrchilds's avatar
hrchilds committed
931 932 933 934 935 936 937 938 939 940
//   
// Programmer: Brad Whitlock
// Creation:   Tue Mar 25 13:41:08 PST 2003
//
// Modifications:
//   Brad Whitlock, Wed May 14 12:56:16 PDT 2003
//   I made it get the metadata and the SIL if the time is greater than 0.
//   This ensures that we pick up the metadata and SIL for the time state
//   that we're intersted in.
//
hrchilds's avatar
hrchilds committed
941 942 943
//   Hank Childs, Mon Jan  5 16:49:28 PST 2004
//   Account for databases in the cached lists that have been cleared.
//
hrchilds's avatar
hrchilds committed
944 945 946
//   Hank Childs, Mon Mar  1 08:48:26 PST 2004
//   Send the time to the database factory as well.
//
hrchilds's avatar
hrchilds committed
947 948
//   Hank Childs, Mon Mar 22 11:10:43 PST 2004
//   Send the file format type to the database factory.
hrchilds's avatar
hrchilds committed
949 950 951 952
//
//   Mark C. Miller, Tue Sep 28 19:57:42 PDT 2004
//   Added code to pass avtDatabaseMetaData to LoadBalancer->AddDatabase
//
hrchilds's avatar
hrchilds committed
953 954 955 956
//   Brad Whitlock, Tue Feb 22 12:17:27 PDT 2005
//   I changed the code so it an empty format string behaves as though no
//   format was specified.
//
hrchilds's avatar
hrchilds committed
957 958 959
//   Hank Childs, Sun Feb 27 12:30:17 PST 2005
//   Added avtDatabase argument to AddDatabase.
//
hrchilds's avatar
hrchilds committed
960 961 962
//   Hank Childs, Fri Oct  7 09:30:57 PDT 2005
//   Tell the database what its full name is.
//
hrchilds's avatar
hrchilds committed
963 964 965 966 967 968
//   Mark C. Miller, Wed Nov 16 10:46:36 PST 2005
//   Changed interface to lb->AddDatabase 
//
//   Hank Childs, Thu Jan 11 16:10:12 PST 2007
//   Added argument to DatabaseFactory calls.
//
969 970 971
//   Brad Whitlock, Tue Jun 24 15:48:27 PDT 2008
//   Pass the database plugin manager to the database factory.
//
hrchilds's avatar
hrchilds committed
972
// ****************************************************************************
hrchilds's avatar
hrchilds committed
973

hrchilds's avatar
hrchilds committed
974 975
void
NetworkManager::DefineDB(const string &dbName, const string &dbPath,
hrchilds's avatar
hrchilds committed
976
    const stringVector &files, int time, const string &format)
hrchilds's avatar
hrchilds committed
977 978 979 980 981 982 983 984 985 986 987 988 989 990
{
    //
    // We gotta have a load balancer
    //
    if (loadBalancer == NULL)
    {
        debug1 << "Internal error: A load balancer was never registered."
               << endl;
        EXCEPTION0(ImproperUseException);
    }

    // Prepend the path to the files.
    stringVector filesWithPath;
    filesWithPath.reserve(files.size());
991
    for(size_t i = 0; i < files.size(); ++i)
hrchilds's avatar
hrchilds committed
992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015
        filesWithPath.push_back(dbPath + files[i]);

    //
    // If the database is in the virtualDatabases map, then check the
    // new list of files against the old list of files.
    //
    StringVectorMap::const_iterator it = virtualDatabases.find(dbName);
    if(it != virtualDatabases.end())
    {
        // If the list of files is the same, return because we don't
        // need to change the list of files. If the list of files differ
        // then replace the list of files.
        if(filesWithPath == it->second)
        {
            debug3 << "NetworkManager::DefineDB: No need to change "
                   << "virtual database definition for "
                   << dbName.c_str() << endl;

            // The definition is the same so we don't need to change it
            // but we have to make sure that it exists in the database
            // cache or else we'll have to define it. It's possible that
            // a clear cache rpc could have purged it from the database
            // cache.
            bool found = false;
1016
            for(size_t i = 0; i < databaseCache.size() && !found; ++i)
hrchilds's avatar
hrchilds committed
1017 1018 1019
            {
                if (databaseCache[i] == NULL)
                    continue;
hrchilds's avatar
hrchilds committed
1020
                found = (databaseCache[i]->GetFilename() == dbName);
hrchilds's avatar
hrchilds committed
1021
            }
hrchilds's avatar
hrchilds committed
1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039

            // If the database was in the database cache, we can return.
            if(found)
                return;
        }
        else
        {
            debug3 << "NetworkManager::DefineDB: Changed "
                   << "virtual database definition for "
                   << dbName.c_str() << endl;
            virtualDatabases[dbName] = filesWithPath;
        }
    }

    //
    // Remove from the database cache databases that have the same name.
    //
    std::vector<NetnodeDB*> databaseBadMatches;
1040
    for (size_t i = 0; i < databaseCache.size(); i++)
hrchilds's avatar
hrchilds committed
1041
    {
hrchilds's avatar
hrchilds committed
1042 1043
        if (databaseCache[i] == NULL)
            continue;
hrchilds's avatar
hrchilds committed
1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055
        if (databaseCache[i]->GetFilename() != dbName)
            databaseBadMatches.push_back(databaseCache[i]);
    }
    databaseCache = databaseBadMatches;

    const char **names = 0;
    TRY
    {
        // Open the database
        avtDatabase *db = NULL;
        const char *dbName_c = dbName.c_str();

hrchilds's avatar
hrchilds committed
1056 1057 1058 1059 1060
        // Make empty strings behave as though no format was specified.
        const char *defaultFormat = 0;
        if(format.size() > 0)
            defaultFormat = format.c_str();

hrchilds's avatar
hrchilds committed
1061
        std::vector<std::string> plugins;  // unused
hrchilds's avatar
hrchilds committed
1062 1063 1064 1065 1066 1067 1068 1069
        if (filesWithPath.size() > 0)
        {
            // Make an array of pointers that we can pass to the database
            // factory so we can create a database based on a virtual
            // file.
            names = new const char *[filesWithPath.size()];
            for(int i = 0; i < filesWithPath.size(); ++i)
                names[i] = filesWithPath[i].c_str();
1070 1071
            db = avtDatabaseFactory::FileList(GetDatabasePluginManager(),
                  names, filesWithPath.size(), time, plugins, defaultFormat);
hrchilds's avatar
hrchilds committed
1072 1073 1074 1075 1076 1077 1078 1079 1080
            delete [] names;
            names = 0;

            // Add the virtual database to the virtual database map.
            virtualDatabases[dbName] = filesWithPath;
            debug3 << "NetworkManager::DefineDB: Added new virtual database "
                   << "definition for " << dbName.c_str() << endl;
        }
        else if (dbName.substr(dbName.length() - 6) == ".visit")
1081 1082 1083 1084
        {
            db = avtDatabaseFactory::VisitFile(GetDatabasePluginManager(),
                dbName_c, time, plugins, defaultFormat);
        }
hrchilds's avatar
hrchilds committed
1085
        else
1086 1087 1088 1089
        {
            db = avtDatabaseFactory::FileList(GetDatabasePluginManager(),
                &dbName_c, 1, time, plugins, defaultFormat);
        }
hrchilds's avatar
hrchilds committed
1090
        db->SetFullDBName(dbName);
hrchilds's avatar
hrchilds committed
1091 1092 1093

        // If we want to open the file at a later timestep, get the
        // metadata and the SIL so that it contains the right data.
hrchilds's avatar
hrchilds committed
1094 1095 1096
        if ((time > 0) ||
            (!db->MetaDataIsInvariant()) || 
            (!db->SILIsInvariant()))
hrchilds's avatar
hrchilds committed
1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108
        {
            debug2 << "NetworkManager::DefineDB: We were instructed to define "