NetworkManager.C 215 KB
Newer Older
hrchilds's avatar
hrchilds committed
1 2
/*****************************************************************************
*
brugger's avatar
 
brugger committed
3
* Copyright (c) 2000 - 2011, 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-442911
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>
51
#include <ConstructDataBinningAttributes.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>
72
#include <avtApplyDataBinningExpression.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>
99 100
#include <avtDataBinning.h>
#include <avtDataBinningConstructor.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 ref_ptr<avtDatabase> GetDatabase(void *, const std::string &,
                                        int, const char *);
142
static avtDataBinning *GetDataBinningCallbackBridge(void *arg, const char *name);
bonnell's avatar
bonnell committed
143
static bool OnlyRootNodeHasData(avtImage_p &);
144
static void BroadcastImage(avtImage_p &, bool, int);
145
#ifdef PARALLEL
146
static bool IsBlankImage(avtImage_p img);
147 148
static std::vector<int> BuildBlankImageVector(avtImage_p img);
#endif
hrchilds's avatar
hrchilds committed
149

hrchilds's avatar
hrchilds committed
150 151 152 153 154 155 156 157 158 159
//
// 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
160 161 162 163 164 165 166 167 168
// ****************************************************************************
//  Method: NetworkManager default constructor
//
//  Programmer: Jeremy Meredith
//  Creation:   September 29, 2000
//
//  Modifications:
//
//    Kathleen Bonnell, Tue Nov 20 12:35:54 PST 2001
169
//    Initialize requireOriginalCells.
hrchilds's avatar
hrchilds committed
170
//
hrchilds's avatar
hrchilds committed
171 172 173
//    Hank Childs, Mon Jan  5 16:04:57 PST 2004
//    Initialize uniqueNetworkId.
//
hrchilds's avatar
hrchilds committed
174 175 176
//    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
177 178 179
//    Mark C. Miller, Thu Apr 29 16:15:25 PDT 2004
//    Added missing initialization of dumpRenders
//
hrchilds's avatar
hrchilds committed
180 181 182
//    Mark C. Miller, Tue May 25 20:44:10 PDT 2004
//    Removed unnecessary scope. Set annotationAttributes data member
//
183 184
//    Kathleen Bonnell, Wed Jun  2 09:48:29 PDT 2004
//    Initialize requireOriginalNodes.
hrchilds's avatar
hrchilds committed
185
//
hrchilds's avatar
hrchilds committed
186 187 188 189
//    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
190 191 192
//    Mark C. Miller, Wed Jan  5 10:14:21 PST 2005
//    Added call to NewVisWindow
//
hrchilds's avatar
hrchilds committed
193 194 195
//    Hank Childs, Mon Feb 28 16:56:20 PST 2005
//    Initialize inQueryMode.
//
hrchilds's avatar
hrchilds committed
196 197 198
//    Hank Childs, Fri Aug 26 15:44:48 PDT 2005
//    Register a callback to get databases.
//
hrchilds's avatar
hrchilds committed
199 200 201
//    Hank Childs, Sat Feb 18 11:31:23 PST 2006
//    Added a call back for the apply ddf expression.
//
202 203 204
//    Cyrus Harrison, Tue Feb 19 08:42:51 PST 2008
//    Removed dumpRenders (now controled by avtDebugDumpOptions)
//
205 206 207
//    Brad Whitlock, Tue Jun 24 15:40:29 PDT 2008
//    Added plugin managers.
//
fogal1's avatar
fogal1 committed
208 209 210
//    Tom Fogal, Wed Dec  9 14:10:01 MST 2009
//    Remove creation of window 0; we'll do it dynamically when needed.
//
211 212 213
//    Hank Childs, Sat Aug 21 14:35:47 PDT 2010
//    Rename DDF to DataBinning.
//
hrchilds's avatar
hrchilds committed
214 215 216 217 218 219
// ****************************************************************************
NetworkManager::NetworkManager(void) : virtualDatabases()
{
    workingNet = NULL;
    loadBalancer = NULL;
    requireOriginalCells = false;
hrchilds's avatar
hrchilds committed
220
    requireOriginalNodes = false;
hrchilds's avatar
hrchilds committed
221
    inQueryMode = false;
hrchilds's avatar
hrchilds committed
222
    uniqueNetworkId = 0;
hrchilds's avatar
hrchilds committed
223

hrchilds's avatar
hrchilds committed
224
    avtCallback::RegisterGetDatabaseCallback(GetDatabase, this);
225 226 227
    avtApplyDataBinningExpression::RegisterGetDataBinningCallback(GetDataBinningCallbackBridge, this);
    avtExpressionEvaluatorFilter::RegisterGetDataBinningCallback(
                                                  GetDataBinningCallbackBridge, this);
228 229 230 231

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

// ****************************************************************************
//  Method: NetworkManager destructor
//
//  Programmer: Jeremy Meredith
//  Creation:   September 29, 2000
//
//  Modifications:
hrchilds's avatar
hrchilds committed
241 242 243 244 245 246
//    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
247
//
hrchilds's avatar
hrchilds committed
248 249 250
//    Mark C. Miller, Tue Jan  4 10:23:19 PST 2005
//    Added code to delete VisWindow objects
//
hrchilds's avatar
hrchilds committed
251 252 253
//    Hank Childs, Mon Feb 13 23:14:23 PST 2006
//    Delete the DDFs.
//
254 255 256
//    Brad Whitlock, Tue Jun 24 15:41:08 PDT 2008
//    Added plugin managers.
//
257 258 259
//    Hank Childs, Sat Aug 21 14:35:47 PDT 2010
//    Rename DDF to DataBinning.
//
260 261 262 263
//    David Camp, Thu Jan 13 11:15:00 PST 2011
//    Added the call to DeleteInstance of the avtColorTables. 
//    Help debug memory leaks.
//
hrchilds's avatar
hrchilds committed
264
// ****************************************************************************
265

hrchilds's avatar
hrchilds committed
266 267
NetworkManager::~NetworkManager(void)
{
268
    for (size_t i = 0; i < networkCache.size(); i++)
hrchilds's avatar
hrchilds committed
269 270
        if (networkCache[i] != NULL)
            delete networkCache[i];
hrchilds's avatar
hrchilds committed
271 272 273 274

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

276 277
    for (size_t d = 0 ; d < dataBinnings.size() ; d++)
        delete dataBinnings[d];
278 279 280 281

    delete databasePlugins;
    delete operatorPlugins;
    delete plotPlugins;
282 283

    avtColorTables::Instance()->DeleteInstance();
284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346
}

// ****************************************************************************
// 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
347 348 349 350 351 352 353 354 355 356 357 358
}

// ****************************************************************************
//  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
359 360 361 362 363
//    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
364
//
hrchilds's avatar
hrchilds committed
365 366 367
//    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
368
//
hrchilds's avatar
hrchilds committed
369 370 371
//    Brad Whitlock, Thu Feb 26 11:58:58 PDT 2004
//    I replaced the commented out cerr with debug3.
//
hrchilds's avatar
hrchilds committed
372 373 374 375 376
//    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
377 378 379 380
//    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
381 382 383 384
//    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
385 386 387
//    Mark C. Miller, Tue Jan  4 10:23:19 PST 2005
//    Added code to delete VisWindow objects
//
hrchilds's avatar
hrchilds committed
388 389 390
//    Hank Childs, Thu Mar  2 10:06:33 PST 2006
//    Added support for image based plots.
//
hrchilds's avatar
hrchilds committed
391 392 393 394
// ****************************************************************************
void
NetworkManager::ClearAllNetworks(void)
{
hrchilds's avatar
hrchilds committed
395
    debug3 << "NetworkManager::ClearAllNetworks(void)" << endl;
hrchilds's avatar
hrchilds committed
396

397
    for (size_t i = 0; i < networkCache.size(); i++)
hrchilds's avatar
hrchilds committed
398 399 400 401 402 403
    {
        if (networkCache[i] != NULL)
            delete networkCache[i];
        networkCache[i] = NULL;
    }

404
    for (size_t i = 0; i < databaseCache.size(); i++)
hrchilds's avatar
hrchilds committed
405 406 407 408 409 410
    {
        if (databaseCache[i] != NULL)
            delete databaseCache[i];
        databaseCache[i] = NULL;
    }

411
    for (size_t i = 0 ; i < globalCellCounts.size() ; i++)
hrchilds's avatar
hrchilds committed
412
    {
hrchilds's avatar
hrchilds committed
413
        globalCellCounts[i] = -1;
hrchilds's avatar
hrchilds committed
414
    }
hrchilds's avatar
hrchilds committed
415 416 417 418 419 420

    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
421
        it->second.imageBasedPlots.clear();
hrchilds's avatar
hrchilds committed
422 423 424 425
        delete it->second.viswin;
    }
    viswinMap.clear();
    NewVisWindow(0);
hrchilds's avatar
hrchilds committed
426 427 428 429 430 431 432 433 434 435 436 437 438 439
}

// ****************************************************************************
//  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
440 441 442 443
//  Modifications:
//    Brad Whitlock, Thu Feb 26 11:58:58 PDT 2004
//    I replaced the commented out cerr with debug3.
//
hrchilds's avatar
hrchilds committed
444 445 446
//    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
447 448 449 450
//
//    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
451 452 453
//
//    Mark C. Miller, Tue Jan  4 10:23:19 PST 2005
//    Modified for viswinMap object
hrchilds's avatar
hrchilds committed
454 455 456 457
// ****************************************************************************
void
NetworkManager::ClearNetworksWithDatabase(const std::string &db)
{
hrchilds's avatar
hrchilds committed
458
    debug3 << "NetworkManager::ClearNetworksWithDatabase()" << endl;
hrchilds's avatar
hrchilds committed
459

460
    //
hrchilds's avatar
hrchilds committed
461 462 463
    // Clear out the networks before the databases.  This is because if we
    // delete the databases first, the networks will have dangling pointers.
    //
464
    for (size_t i = 0; i < networkCache.size(); i++)
hrchilds's avatar
hrchilds committed
465 466 467 468 469 470 471 472
    {
        if (networkCache[i] != NULL)
        {
            NetnodeDB *ndb = networkCache[i]->GetNetDB();
            if (ndb != NULL)
            {
                if (ndb->GetFilename() == db)
                {
hrchilds's avatar
hrchilds committed
473
                    DoneWithNetwork(i);
hrchilds's avatar
hrchilds committed
474 475 476 477
                }
            }
        }
    }
hrchilds's avatar
hrchilds committed
478

479
    for (size_t i = 0; i < databaseCache.size(); i++)
hrchilds's avatar
hrchilds committed
480 481 482 483 484 485 486 487 488 489
    {
        if (databaseCache[i] != NULL)
        {
            if (databaseCache[i]->GetFilename() == db)
            {
                delete databaseCache[i];
                databaseCache[i] = NULL;
            }
        }
    }
hrchilds's avatar
hrchilds committed
490 491 492
}

// ****************************************************************************
hrchilds's avatar
hrchilds committed
493
//  Method: NetworkManager::GetDBFromCache
hrchilds's avatar
hrchilds committed
494 495
//
//  Purpose:
hrchilds's avatar
hrchilds committed
496 497 498 499 500 501 502 503 504 505 506 507 508
//      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
509 510 511 512
//    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
513 514 515
//    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
516 517 518
//    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
519 520 521
//    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
522 523 524
//    Hank Childs, Mon Mar  1 08:48:26 PST 2004
//    Send the time to the database factory as well.
//
hrchilds's avatar
hrchilds committed
525 526 527
//    Hank Childs, Mon Mar 22 11:10:43 PST 2004
//    Allow for the DB type to be explicitly specified.
//
hrchilds's avatar
hrchilds committed
528 529 530 531 532
//    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
533
//
hrchilds's avatar
hrchilds committed
534 535 536
//    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
537 538 539 540 541 542 543
//    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
544 545
//    Mark C. Miller, Wed Nov 16 10:46:36 PST 2005
//    Changed interface to lb->AddDatabase 
hrchilds's avatar
hrchilds committed
546 547 548 549
//
//    Hank Childs, Thu Jan 11 16:10:12 PST 2007
//    Added argument to DatabaseFactory calls.
//
550 551
//    Mark C. Miller, Thu Jun 14 10:26:37 PDT 2007
//    Added support to treat all databases as time varying
552 553 554
//
//    Mark C. Miller, Wed Aug 22 20:16:59 PDT 2007
//    Added treatAllDBsAsTimeVarying to GetSIL call
555 556 557 558
//
//    Hank Childs, Fri Feb  1 15:45:28 PST 2008
//    Added argument for loading database plugins.
//
559 560
//    Mark C. Miller, Tue Jun 10 22:36:25 PDT 2008
//    Added support for ignoring bad extents from dbs.
561 562 563 564
//
//    Brad Whitlock, Tue Jun 24 15:45:43 PDT 2008
//    Pass the database plugin manager to the factory.
//
hrchilds's avatar
hrchilds committed
565
// ****************************************************************************
hrchilds's avatar
hrchilds committed
566

hrchilds's avatar
hrchilds committed
567
NetnodeDB *
hrchilds's avatar
hrchilds committed
568
NetworkManager::GetDBFromCache(const string &filename, int time,
569
    const char *format, bool treatAllDBsAsTimeVarying, 
570
    bool fileMayHaveUnloadedPlugin, bool ignoreExtents)
hrchilds's avatar
hrchilds committed
571 572 573 574
{
    // If we don't have a load balancer, we're dead.
    if (loadBalancer == NULL)
    {
hrchilds's avatar
hrchilds committed
575 576
        debug1 << "Internal error: A load balancer was never registered." 
               << endl;
hrchilds's avatar
hrchilds committed
577 578 579
        EXCEPTION0(ImproperUseException);
    }

hrchilds's avatar
hrchilds committed
580 581
    // Find a matching database 
    NetnodeDB* cachedDB = NULL;
582
    for (size_t i = 0; i < databaseCache.size(); i++)
hrchilds's avatar
hrchilds committed
583
    {
hrchilds's avatar
hrchilds committed
584 585
        if (databaseCache[i] == NULL)
            continue;
hrchilds's avatar
hrchilds committed
586
        if (databaseCache[i]->GetFilename() == filename)
hrchilds's avatar
hrchilds committed
587
        {
hrchilds's avatar
hrchilds committed
588 589
            cachedDB = databaseCache[i];
            break;
hrchilds's avatar
hrchilds committed
590
        }
hrchilds's avatar
hrchilds committed
591 592
    }

593 594 595 596
    // use of these makes calls to GetMetaData a little clearer
    const bool forceReadAllCyclesAndTimes = false;
    const bool forceReadThisCycleAndTime  = false;

hrchilds's avatar
hrchilds committed
597 598 599 600 601
    // 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
602
        if (treatAllDBsAsTimeVarying ||
603
            !cachedDB->GetDB()->MetaDataIsInvariant() ||
hrchilds's avatar
hrchilds committed
604
            !cachedDB->GetDB()->SILIsInvariant())
hrchilds's avatar
hrchilds committed
605
        {
606
            cachedDB->GetDB()->GetMetaData(time,
607 608 609
                                           forceReadAllCyclesAndTimes,
                                           forceReadThisCycleAndTime,
                                           treatAllDBsAsTimeVarying);
610
            cachedDB->GetDB()->GetSIL(time, treatAllDBsAsTimeVarying);
hrchilds's avatar
hrchilds committed
611
        }
hrchilds's avatar
hrchilds committed
612 613

        return cachedDB;
hrchilds's avatar
hrchilds committed
614 615 616 617 618 619
    }

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

hrchilds's avatar
hrchilds committed
623 624 625
        avtDatabase *db = NULL;
        NetnodeDB *netDB = NULL;
        const char *filename_c = filename.c_str();
hrchilds's avatar
hrchilds committed
626
        std::vector<std::string> plugins;  // unused
hrchilds's avatar
hrchilds committed
627 628
        if (filename.length() >= 6 &&
            filename.substr(filename.length() - 6) == ".visit")
629 630 631 632 633 634 635 636
        {
            db = avtDatabaseFactory::VisitFile(
                GetDatabasePluginManager(),
                filename_c,
                time,
                plugins,
                format);
        }
hrchilds's avatar
hrchilds committed
637
        else
638 639 640 641 642 643 644 645 646 647
        {
            db = avtDatabaseFactory::FileList(
                GetDatabasePluginManager(),
                &filename_c,
                1,
                time,
                plugins, 
                format);
        }

hrchilds's avatar
hrchilds committed
648
        db->SetFullDBName(filename);
649
        db->SetIgnoreExtents(ignoreExtents);
hrchilds's avatar
hrchilds committed
650 651

        // If we want to open the file at a later timestep, get the
hrchilds's avatar
hrchilds committed
652 653
        // SIL so that it contains the right data.
        if ((time > 0) ||
654
            treatAllDBsAsTimeVarying ||
hrchilds's avatar
hrchilds committed
655 656
            (!db->MetaDataIsInvariant()) ||
            (!db->SILIsInvariant()))
hrchilds's avatar
hrchilds committed
657 658 659
        {
            debug2 << "NetworkManager::AddDB: We were instructed to open "
                   << filename.c_str() << " at timestate=" << time
hrchilds's avatar
hrchilds committed
660
                   << " so we're reading the SIL early."
hrchilds's avatar
hrchilds committed
661
                   << endl;
662
            db->GetMetaData(time,
663 664 665
                            forceReadAllCyclesAndTimes,
                            forceReadThisCycleAndTime,
                            treatAllDBsAsTimeVarying);
666
            db->GetSIL(time, treatAllDBsAsTimeVarying);
hrchilds's avatar
hrchilds committed
667 668 669 670 671 672
        }

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

        netDB->SetDBInfo(filename, "", time);
hrchilds's avatar
hrchilds committed
673
        loadBalancer->AddDatabase(filename, db, time);
hrchilds's avatar
hrchilds committed
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 700 701 702 703 704 705 706 707 708 709
      
        // 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
710 711 712 713 714 715 716 717 718 719 720 721 722 723 724
    }
    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
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 761 762 763 764 765 766 767 768 769 770
//
//  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
771 772 773 774 775 776
//    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
777
//
hrchilds's avatar
hrchilds committed
778 779 780
//    Jeremy Meredith, Wed Jul 30 10:45:45 PDT 2003
//    Added the check for requiring full connectivity.
//
hrchilds's avatar
hrchilds committed
781 782 783
//    Jeremy Meredith, Fri Sep  5 15:23:13 PDT 2003
//    Added a flag for the new MIR algorithm.
//
hrchilds's avatar
hrchilds committed
784 785 786
//    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
787 788 789
//    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
790 791 792 793
//    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
794 795 796
//    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
797 798 799
//    Mark C. Miller, Thu Aug 19 10:28:45 PDT 2004
//    Removed #ifdef 0 code block
//
hrchilds's avatar
hrchilds committed
800 801 802 803 804 805
//    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
806 807 808 809
//    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
810 811 812
//    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
813 814 815
//    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
816 817 818
//    Jeremy Meredith, Thu Aug 18 17:54:51 PDT 2005
//    Added a new isovolume algorithm, with adjustable VF cutoff.
//
hrchilds's avatar
hrchilds committed
819 820
//    Mark C. Miller, Wed Nov 16 10:46:36 PST 2005
//    Added mesh management attributes 
hrchilds's avatar
hrchilds committed
821 822 823
//
//    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
824 825 826 827 828
//
//    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.
//
829 830
//    Mark C. Miller, Thu Jun 14 10:26:37 PDT 2007
//    Added support to treat all databases as time varying
831 832 833
//
//    Mark C. Miller, Wed Aug 22 20:16:59 PDT 2007
//    Added treatAllDBsAsTimeVarying to GetSIL call.
834 835 836 837
//
//    Hank Childs, Fri Feb  1 15:48:01 PST 2008
//    Add new Boolean argument to GetDBFromCache. 
//
838 839
//    Mark C. Miller, Tue Jun 10 22:36:25 PDT 2008
//    Added support for ignoring bad extents from dbs.
840 841 842 843
//
//    Hank Childs, Fri Jan 16 15:30:15 PST 2009
//    Store the variable with the working network.
//
844 845 846
//    John C. Anderson, Thu Jan 15 10:20:20 2009
//    Added annealing time for Discrete MIR.
//
847 848 849
//    Jeremy Meredith, Fri Feb 13 11:22:39 EST 2009
//    Added MIR iteration capability.
//
hrchilds's avatar
hrchilds committed
850
// ****************************************************************************
hrchilds's avatar
hrchilds committed
851

hrchilds's avatar
hrchilds committed
852
void
hrchilds's avatar
hrchilds committed
853 854
NetworkManager::StartNetwork(const string &format,
                             const string &filename,
hrchilds's avatar
hrchilds committed
855
                             const string &var,
hrchilds's avatar
hrchilds committed
856 857
                             int time,
                             const CompactSILRestrictionAttributes &atts,
hrchilds's avatar
hrchilds committed
858
                             const MaterialAttributes &matopts,
859
                             const MeshManagementAttributes &meshopts,
860 861
                             bool treatAllDBsAsTimeVarying,
                             bool ignoreExtents)
hrchilds's avatar
hrchilds committed
862
{
hrchilds's avatar
hrchilds committed
863 864
    // If the variable is an expression, we need to find a "real" variable
    // name to work with.
hrchilds's avatar
hrchilds committed
865
    string leaf = ParsingExprList::GetRealVariable(var);
hrchilds's avatar
hrchilds committed
866

hrchilds's avatar
hrchilds committed
867 868 869 870 871
    // 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
872 873
    // Start up the DataNetwork and add the database to it.
    workingNet = new DataNetwork;
874
    bool fileMayHaveUnloadedPlugin = false;
875
    NetnodeDB *netDB = GetDBFromCache(filename, time, defaultFormat,
876
                                      treatAllDBsAsTimeVarying, 
877 878
                                      fileMayHaveUnloadedPlugin,
                                      ignoreExtents);
hrchilds's avatar
hrchilds committed
879
    workingNet->SetNetDB(netDB);
880
    workingNet->SetVariable(leaf);
hrchilds's avatar
hrchilds committed
881
    netDB->SetDBInfo(filename, leaf, time);
hrchilds's avatar
hrchilds committed
882

hrchilds's avatar
hrchilds committed
883 884 885 886 887
    // 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
888
    f->GetOutput()->SetTransientStatus(false);
hrchilds's avatar
hrchilds committed
889

hrchilds's avatar
hrchilds committed
890 891
    // Push the ExpressionEvaluator onto the working list.
    workingNetnodeList.push_back(filt);
hrchilds's avatar
hrchilds committed
892

hrchilds's avatar
hrchilds committed
893
    workingNet->AddNode(filt);
hrchilds's avatar
hrchilds committed
894
    // Push the variable name onto the name stack.
hrchilds's avatar
hrchilds committed
895
    nameStack.push_back(var);
896
    debug4 << "NetworkManager::AddDB: Adding " << var.c_str()
hrchilds's avatar
hrchilds committed
897 898 899
           << " to the name stack" << endl;

    // Set up the data spec.
hrchilds's avatar
hrchilds committed
900
    avtSILRestriction_p silr =
901
        new avtSILRestriction(workingNet->GetNetDB()->GetDB()->
902
            GetSIL(time, treatAllDBsAsTimeVarying), atts);
hrchilds's avatar
hrchilds committed
903
    avtDataRequest *dataRequest = new avtDataRequest(var.c_str(), time, silr);
hrchilds's avatar
hrchilds committed
904 905

    // Set up some options from the data specification
hrchilds's avatar
hrchilds committed
906 907 908 909 910
    dataRequest->SetNeedMixedVariableReconstruction(matopts.GetForceMIR());
    dataRequest->SetNeedSmoothMaterialInterfaces(matopts.GetSmoothing());
    dataRequest->SetNeedCleanZonesOnly(matopts.GetCleanZonesOnly());
    dataRequest->SetNeedValidFaceConnectivity(matopts.GetNeedValidConnectivity());
    dataRequest->SetMIRAlgorithm(matopts.GetAlgorithm());
911 912 913
    dataRequest->SetMIRNumIterations(matopts.GetIterationEnabled() ?
                                     matopts.GetNumIterations() : 0);
    dataRequest->SetMIRIterationDamping(matopts.GetIterationDamping());
hrchilds's avatar
hrchilds committed
914 915 916
    dataRequest->SetSimplifyHeavilyMixedZones(matopts.GetSimplifyHeavilyMixedZones());
    dataRequest->SetMaxMaterialsPerZone(matopts.GetMaxMaterialsPerZone());
    dataRequest->SetIsovolumeMIRVF(matopts.GetIsoVolumeFraction());
917
    dataRequest->SetAnnealingTime(matopts.GetAnnealingTime());
hrchilds's avatar
hrchilds committed
918 919 920 921 922 923 924
    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
925 926 927 928 929 930 931 932 933 934 935 936 937 938 939

    // 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
940
//    format   : The file format type of the DB.
hrchilds's avatar
hrchilds committed
941 942 943 944 945 946 947 948 949 950
//   
// 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
951 952 953
//   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
954 955 956
//   Hank Childs, Mon Mar  1 08:48:26 PST 2004
//   Send the time to the database factory as well.
//
hrchilds's avatar
hrchilds committed
957 958
//   Hank Childs, Mon Mar 22 11:10:43 PST 2004
//   Send the file format type to the database factory.
hrchilds's avatar
hrchilds committed
959 960 961 962
//
//   Mark C. Miller, Tue Sep 28 19:57:42 PDT 2004
//   Added code to pass avtDatabaseMetaData to LoadBalancer->AddDatabase
//
hrchilds's avatar
hrchilds committed
963 964 965 966
//   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
967 968 969
//   Hank Childs, Sun Feb 27 12:30:17 PST 2005
//   Added avtDatabase argument to AddDatabase.
//
hrchilds's avatar
hrchilds committed
970 971 972
//   Hank Childs, Fri Oct  7 09:30:57 PDT 2005
//   Tell the database what its full name is.
//
hrchilds's avatar
hrchilds committed
973 974 975 976 977 978
//   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.
//
979 980 981
//   Brad Whitlock, Tue Jun 24 15:48:27 PDT 2008
//   Pass the database plugin manager to the database factory.
//
hrchilds's avatar
hrchilds committed
982
// ****************************************************************************
hrchilds's avatar
hrchilds committed
983

hrchilds's avatar
hrchilds committed
984 985
void
NetworkManager::DefineDB(const string &dbName, const string &dbPath,
hrchilds's avatar
hrchilds committed
986
    const stringVector &files, int time, const string &format)
hrchilds's avatar
hrchilds committed
987 988 989 990 991 992 993 994 995 996 997 998 999 1000
{
    //
    // 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());
1001
    for(size_t i = 0; i < files.size(); ++i)
hrchilds's avatar
hrchilds committed
1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025
        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;
1026
            for(size_t i = 0; i < databaseCache.size() && !found; ++i)
hrchilds's avatar
hrchilds committed
1027 1028 1029
            {
                if (databaseCache[i] == NULL)
                    continue;
hrchilds's avatar
hrchilds committed
1030
                found = (databaseCache[i]->GetFilename() == dbName);
hrchilds's avatar
hrchilds committed
1031
            }
hrchilds's avatar
hrchilds committed
1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049

            // 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;
1050
    for (size_t i = 0; i < databaseCache.size(); i++)
hrchilds's avatar
hrchilds committed
1051
    {
hrchilds's avatar
hrchilds committed
1052 1053
        if (databaseCache[i] == NULL)
            continue;
hrchilds's avatar
hrchilds committed
1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065
        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
1066 1067 1068 1069 1070
        // 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
1071
        std::vector<std::string> plugins;  // unused
hrchilds's avatar
hrchilds committed
1072 1073 1074 1075 1076 1077 1078 1079
        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();
1080 1081
            db = avtDatabaseFactory::FileList(GetDatabasePluginManager(),
                  names, filesWithPath.size(), time, plugins, defaultFormat);
hrchilds's avatar
hrchilds committed
1082 1083 1084 1085 1086 1087 1088 1089 1090
            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")
1091 1092 1093 1094
        {
            db = avtDatabaseFactory::VisitFile(GetDatabasePluginManager(),
                dbName_c, time, plugins, defaultFormat);
        }
hrchilds's avatar
hrchilds committed
1095
        else
1096 1097 1098 1099
        {
            db = avtDatabaseFactory::FileList(GetDatabasePluginManager(),
                &dbName_c, 1, time, plugins, defaultFormat);
        }
hrchilds's avatar
hrchilds committed
1100
        db->SetFullDBName(dbName);
hrchilds's avatar
hrchilds committed
1101 1102 1103

        // If we want to open the file at a later timestep, get the
        // metadata and the SIL so that it contains the right data.