Part V · Chapter 29 · Final chapter

Collaborative Workflows — IGW-NET in the Ecosystem

A groundwater model exists in three contexts. First, it's a specific tool for a specific question — a site investigation, a wellhead protection study, a regional water budget, an uncertainty analysis. Second, it's an input to the work of others — regulators who'll review it, researchers who'll extend it, managers who'll decide on it, students who'll learn from it. Third, it's a contribution to the shared knowledge of how water moves through a specific region, adding a piece to an ongoing collective effort. This chapter covers the second and third contexts. Individual modeling work — Parts I through IV of this manual — produces a useful model; collaborative work turns individual models into a shared learning system. This is the final chapter of the manual. It covers the MAGNET4WATER Observatory as the integrated information layer, the Model Publishing workflow for sharing completed models, the Global Model Network as a shared repository, team workflows for multi-user projects, DataNET for specialized data sharing, and cross-platform integration with the other four MAGNET4WATER platforms. The chapter closes — and the manual closes — with a reflection on what's held together throughout.

Reading time≈ 25 minutes
AudienceAll users — strategic context
TierCapstone
Sections8

The ecosystem at a glance

  • The Observatory is MAGNET4WATER's integrated information layer — approximately 43 countries and approximately 143 cities of water-resources context. Individual modeling work ties into this broader picture.
  • Model Publishing (Utilities → Model Publishing Options) lets you share a completed model with the Global Model Network — three images, one video animation, model name, model description.
  • The Global Model Network is the shared repository of published models. Discover models in your region; adapt them as starting points; contribute back when you complete new work.
  • Team workflows support multi-user modeling — shared model files, collaborative editing, role-based responsibilities, calibration and validation as team activities.
  • DataNET is the data-sharing platform (Ch. 23 §23.7) — transfer specialized datasets into a model, or publish datasets you've compiled for others to use.
  • Cross-platform integration connects IGW-NET to SwaNET (watershed), StormNET (stormwater), and ConduitNET (piped flow) for multi-domain water modeling. SwaNET handshake (Ch. 16 §16.6.3) is the most common link.
  • The manual's foundational principles span all chapters: structure-first, parser-backed truth, compute-render-discard, Global Base Model, hierarchy, three-layer reference system. §29.8 reflects on what has been built.

29.1 The Collaborative Dimension of IGW-NET

Most of this manual covers individual modeling — how one person builds, runs, and analyzes a model. But IGW-NET is also a collaborative platform. Understanding the collaborative dimension changes how you approach your own work.

29.1.1 Why collaborative matters

A model built in isolation has limited value beyond the immediate modeler. A model built with the collaborative ecosystem in mind has:

  • Discoverability — others can find it when working on related problems
  • Review — regulators and peers can inspect it at the model-file level
  • Reusability — future modelers can adapt it as a starting point rather than rebuilding from scratch
  • Accumulated value — each published model contributes to an ongoing collective understanding of groundwater systems in its region

The MAGNET4WATER vision — groundwater modeling becoming a shared, learning system rather than an atomistic series of one-off projects — depends on collaborative practices. IGW-NET's features support this vision: structured model files that others can read, integrated publishing workflow, shared data services, cross-platform coordination.

29.1.2 What this chapter covers

Four practical activities:

  • Understanding the Observatory — what it is, how to use it, how your work connects to it (§29.2)
  • Publishing — the mechanics and best practices for sharing completed models (§29.3)
  • Discovering — finding and adapting published models for your own work (§29.4)
  • Team and cross-platform workflows — working with collaborators and with the broader MAGNET4WATER ecosystem (§29.5-§29.7)

The chapter closes (§29.8) with a reflection on the foundational principles that span this manual.

29.2 The Observatory — Integrated Information Layer

The MAGNET4WATER Observatory is the ecosystem's integrated information layer. Understanding it helps orient your modeling work within the broader platform.

29.2.1 Scale and scope

The Observatory spans approximately 43 countries and approximately 143 cities, integrating:

  • Published models — IGW-NET models shared by other users, organized by region and topic
  • Datasets — curated spatial datasets (DEMs, K, recharge, hydrography) accessible through the Data Center (Ch. 23)
  • Workflow examples — case studies, tutorials, and published analyses showing how the platform has been used
  • Cross-platform context — how IGW-NET work relates to SwaNET, StormNET, ConduitNET, and DataNET activity in the same region

This isn't a passive catalog — it's a live integration. Model publications update the Observatory; new datasets expand the Data Center; new case studies appear as they're completed.

29.2.2 What the Observatory is useful for

Several typical uses:

  • Orientation before starting a model. Before building a new model, check the Observatory for your region. Is there an existing published model you can adapt? Are there datasets specific to your area? Has similar work been done nearby?
  • Strategic context. Understanding the ecosystem scope — approximately 43 countries, approximately 143 cities — helps communicate the value of individual work. Your model isn't just one model; it's a contribution to a larger collective effort.
  • Public engagement. The Observatory is the public face of MAGNET4WATER. For outreach to policymakers, educators, and non-technical stakeholders, the Observatory provides the framing that individual technical work alone cannot.
  • Discovery of related work. Browse published models to see what patterns and methods other modelers are using. Learning from peers is often more efficient than learning from reference documentation alone.

29.2.3 Accessing the Observatory

The Observatory is accessible from the main MAGNET4WATER site at https://www.magnet4water.net/observatory. It's also reachable from within the IGW-NET interface — Utilities and Analysis tools include pathways to relevant Observatory content. As you build and publish models, your work becomes part of what others discover through the Observatory.

29.3 Publishing a Model

Model Publishing is IGW-NET's feature for sharing completed models with the Global Model Network. This section covers the mechanics and the practices that make publishing valuable.

29.3.1 The Model Publishing dialog

Access via Utilities → Model Publishing Options. The dialog accepts:

FieldWhat to providePurpose
Model Name Concise, descriptive name including region and topic How the model appears in the Global Model Network
Model Description Clear explanation of setting, question addressed, key assumptions, limitations Helps discoverability and tells other users whether this model is relevant to their problem
Image 1 Model setup (domain, features, zones) Shows what the model looks like
Image 2 Simulation results (head contours, flow vectors) Shows what the model produces
Image 3 Specialized output (transport plume, capture zone, calibration fit, ensemble statistics) Shows the problem-specific key result
Video Animation Transient evolution or stochastic ensemble formation Demonstrates the time-dependent or stochastic behavior

29.3.2 Before you publish — quality checks

The Global Model Network is a shared learning resource. Published models should be ready for inspection. Before publishing, run these checks:

  • Structure-first check (Ch. 18 §18.1.3) — is the model structurally sound? BCs placed correctly? Layering appropriate? Features at right scale?
  • Mass balance check (Ch. 25 §25.4) — does the water budget close?
  • Calibration quality (Ch. 18) — if the model is calibrated, is the fit documented? Are multiple targets used to break non-uniqueness?
  • No obvious errors (Ch. 25) — no flooded domains, no unreasonable flow directions, no pattern inconsistent with the site understanding
  • Units verified — especially recharge (the 10×-rainfall pitfall, Ch. 14 §14.7)
  • Documentation completeness — the model description should cover what the model does, what it's for, what its limitations are

29.3.3 What makes a publication valuable

Publication value beyond the model file

The technical model file is only part of what makes a publication valuable. Equally important:

  • Clear question framing — what question does this model address? What decision does it support?
  • Transparent assumptions — what was held fixed, what was varied, what was unknown?
  • Honest limitations — what can this model not answer? Where should users not extrapolate?
  • Regional context — what's specific to the setting? What would need adjusting for a different site?
  • Reproducibility notes — what data sources were used? What calibration targets? What was the team structure?

A well-documented average model is more valuable than a poorly-documented excellent model.

29.3.4 What the Global Model Network does with your model

After publication:

  • Your model becomes searchable by name, description, region, and topic
  • Other users can load it as a starting point for their own work
  • The model contributes to the Observatory's regional context for your area
  • Reviewers (regulators, researchers, students) can inspect the model-file level details
  • Feedback and citations accumulate over time, making some published models benchmark references

You retain ownership of the work; publishing adds discoverability without transferring rights. Users who adapt your model typically acknowledge the source.

29.4 Discovering and Reusing Published Models

The flip side of publishing: using what others have published. The Global Model Network becomes more valuable as discoverability and adaptation workflows mature.

29.4.1 When to look for an existing model

Before building a new model, consider whether an existing one would help:

  • Same region, different question — another modeler's regional model for your area gives you the domain, grid, layering, and calibration as a starting point; you adapt for your specific question
  • Similar problem type, different region — a contaminated site study in a different region shows the pattern and structure you'd use; you transfer the setup approach and populate with your local data
  • Teaching or learning — published models are the best examples for seeing how experienced modelers structure specific kinds of problems
  • Benchmark or validation — a published model with extensive calibration can serve as a reference that your own work is consistent with

29.4.2 The discovery workflow

Through the IGW-NET interface or the Observatory:

  1. Search by region — find models within your geographic area of interest
  2. Search by topic — filter by problem type (contamination, water supply, coupled SW-GW, etc.)
  3. Inspect candidate models — read descriptions, view preview images, check the scope and approach
  4. Load promising models — open the model file to see the full configuration
  5. Adapt as starting point — use LoadModel to open; modify for your specific problem; keep or change structural elements as needed

29.4.3 Adaptation practices

When adapting a published model:

  • Understand before modifying. Take time to read the original description and inspect the structure before changing anything. Don't randomly tweak inputs on a model you don't understand.
  • Preserve the structural skeleton if it fits. Domain, grid, layers, BC placement — these are often well-chosen and worth keeping.
  • Refresh the parameters for your setting. K, recharge, observations, feature locations all need to match your specific site, not the source model's.
  • Re-calibrate as needed. A calibrated model for one site is a starting point for another, not an answer.
  • Acknowledge the source. When you publish adapted work, cite the original model that served as starting point.

29.5 Team Workflows — Multi-User Modeling

Many IGW-NET models are built by teams rather than individuals. Team workflows introduce coordination patterns beyond what single-user modeling requires.

29.5.1 Typical team structures

Some common patterns:

Team patternRolesCoordination pattern
Primary modeler + reviewer Modeler builds; reviewer inspects and critiques Sequential — build, review, revise, repeat
Distributed modeling team Multiple modelers each owning a portion (regional, submodel, specific features) Parallel with integration checkpoints; nested-model pattern (Ch. 13) often fits this well
Consulting project team Lead modeler + support + QC + client interface Lead owns the model; others contribute specific inputs; QC verifies; client interface communicates
Research collaboration Multiple investigators, each exploring different aspects Shared model evolves through parallel experimentation; version control critical

29.5.2 Practical team coordination

Practices that help:

  • Single source of truth. One definitive model file at any time; changes tracked with clear attribution. Avoid parallel divergent versions.
  • Shared documentation. Model description, assumptions, known issues all written down and accessible to the whole team.
  • Structural agreements upfront. Team decides on domain extent, layering, grid resolution, and BC strategy early; these don't change without team consensus.
  • Role clarity. Who owns the model state? Who can commit changes? Who reviews before commits?
  • Calibration as a team activity (Ch. 18). Target selection, weighting choices, and acceptance criteria benefit from team input, not just primary-modeler decisions.
  • Use nested modeling for natural division of labor (Ch. 13). Different team members can own different submodels; the 10-cell buffer rule naturally separates concerns.

29.5.3 When to split into submodels

For large multi-user modeling projects, the nested-model pattern (Ch. 13) is often the cleanest organizational fit:

  • Regional lead owns the parent model — domain, regional K, boundary conditions, overall water budget
  • Site-specific modelers own submodels for specific features (contaminated sites, well fields, coupled lake-aquifer details)
  • Integration checkpoints verify that submodel BCs from the parent remain consistent as the parent evolves

This matches the platform's architecture — nesting is how IGW-NET organizes computational resolution, and it also provides a natural way to organize team responsibilities.

29.6 DataNET for Specialized Data Sharing

DataNET is MAGNET4WATER's data services platform — the fifth platform in the ecosystem, covered briefly in Ch. 23 §23.7 and revisited here for its collaborative role.

29.6.1 What DataNET does

DataNET provides a structured way to share spatial datasets across the ecosystem:

  • Publish a dataset — make it discoverable for other modelers
  • Transfer into a model — pull a specific dataset into IGW-NET for use
  • Track provenance — DataNET imports are tagged in model files (filename prefix dataNetWCS or dataNetmWCS), so reviewers can see exactly what data source was used

This complements the Global Database (bundled defaults curated by the IGW-NET team) with user-driven data contributions. A researcher with a specialized transmissivity dataset for a specific aquifer can publish it through DataNET; other modelers working in the same aquifer can then use it without re-acquiring the raw data.

29.6.2 Typical DataNET use cases

  • Regional K compilations — pumping test results compiled across a specific aquifer
  • Site-specific borehole lithology — beyond the standard regional databases (Wellogic, etc.)
  • Specialized DEMs — LiDAR surveys or proprietary topographic data
  • Research-scale dataset integration — bridging published research datasets into IGW-NET-compatible formats

29.6.3 Why the filename prefix matters

When IGW-NET imports a DataNET-sourced raster, the filename begins with dataNetWCS or dataNetmWCS. This prefix is parser-detected and reported in model summaries. Reviewers inspecting a model can see at a glance which inputs came from DataNET transfers versus bundled Global Database defaults versus user-uploaded custom rasters. Data provenance becomes inspectable rather than hidden. See also Ch. 23 §23.7.2.

29.7 Cross-Platform Integration — IGW-NET and the Other Four

IGW-NET is one of five platforms in MAGNET4WATER. Groundwater is one system within the broader water cycle; meaningful water-resource analysis often requires coordination with the surface, stormwater, and piped-flow platforms.

29.7.1 The five platforms

PlatformFocusConnects to IGW-NET via
IGW-NET Groundwater (this manual)
SwaNET Watersheds, surface water, streamflow routing UTM handshake; SwaNET produces recharge for IGW-NET; IGW-NET produces baseflow contributions for SwaNET streams
StormNET Stormwater, urban runoff, green infrastructure Recharge contributions from infiltration; groundwater mounding under infiltration features
ConduitNET Piped flow networks (sewer, water distribution) Groundwater infiltration into sewers; water-supply well pumping as demand
DataNET Data services across all four modeling platforms Data transfers (§29.6)

29.7.2 The SwaNET–IGW-NET link

The most common cross-platform link is between IGW-NET and SwaNET — the surface-subsurface water cycle integration.

The handshake: both platforms use the UTM projection, enforced by IGW-NET's UTM Only setting in DomainAttr. Once coordinate systems match, data exchange becomes possible. See Ch. 16 §16.6.3.

The data flow: SwaNET-computed recharge (from overland flow, infiltration, soil moisture) transfers into IGW-NET as spatial recharge input. IGW-NET-simulated groundwater discharge to streams feeds back into SwaNET stream networks as baseflow contribution.

The memorable framing: "SwaNET sees basin; IGW-NET sees aquifer; surface truth meets subsurface truth." Each platform's domain expertise complements the other.

29.7.3 When to keep GW work in IGW-NET alone

Not every IGW-NET project needs cross-platform integration:

  • Site-scale contaminant investigations usually work entirely within IGW-NET; the watershed context is background
  • Wellhead protection studies are typically groundwater-only
  • Regional water budget models may use Data Center recharge rasters directly, without needing SwaNET's dynamic recharge output

Cross-platform integration adds complexity and coordination overhead. Use it when the problem genuinely needs it — when surface water dynamics directly affect groundwater outcomes, or when the groundwater-surface water interface is itself the object of study. See Ch. 16 for a detailed treatment of when IGW-NET's Watershed Solver suffices versus when SwaNET handoff is warranted.

29.7.4 The ecosystem vision

The five platforms together aim to provide an integrated water-modeling environment covering the full cycle — precipitation, overland flow, infiltration, subsurface flow, groundwater discharge, surface water routing, piped flow, stormwater management. No single platform covers the whole cycle; each platform handles its domain well and coordinates with the others through well-defined handshakes.

For individual modelers, the practical implication is that you have choices. You can work entirely within IGW-NET for groundwater-focused problems. You can coordinate with SwaNET when watershed context matters. You can engage with the broader ecosystem for multi-domain problems. The platform scales to the modeling question rather than forcing the modeling question to fit one platform's capabilities.

29.8 Closing — What This Manual Has Tried to Do

The final section of the final chapter. A reflection on what has been built across 29 chapters.

29.8.1 The foundational principles that span the manual

The chapters are organized by workflow, but certain principles show up repeatedly. A closing recap:

PrincipleFirst establishedRevisited in
Conceptual (xyz) vs. Numerical (ijk) models Ch. 1 §1.5 Ch. 7 (grid resolution), Ch. 13 (hierarchy), throughout
Global Base Model philosophy Ch. 1 §1.4 Ch. 5 §5.1.2 (accept defaults, refine progressively), Ch. 27 (platform switcher path)
Hierarchy as fundamental framework Ch. 13 Ch. 7 (brute-force NX trap), Ch. 29 §29.5.3 (team organization)
10-cell buffer rule Ch. 13 §13.3 Ch. 14 (SW BC placement), Ch. 18 (calibration boundary effects)
Water-table-as-top linearize-within / iterate-between Ch. 7 §7.4.3 Ch. 10 (sublayer mechanics), Ch. 20 (why NWT for strongly unconfined)
Three levels of SW representation Ch. 14 Ch. 15 (Level 3 coupled lakes), Ch. 16 (watershed dimension)
Structure-first, calibration-second Ch. 18 §18.1.3 Ch. 19 §19.8.3, Ch. 24 §24.6, Ch. 25 §25.5.2, Ch. 27 §27.4.3 (regulatory path), Ch. 29 §29.3.2
K-recharge non-uniqueness and multi-target calibration Ch. 18 §18.8 Ch. 19 (parameter uncertainty), Ch. 27 (researcher path)
Spatially correlated random fields Ch. 19 §19.2 Ch. 17 (T-PROGS as categorical case), Ch. 19 §19.3 (SGS as continuous case)
Compute-render-discard architecture Ch. 19 §19.6 Ch. 9 (transient as the first application), Ch. 19 (stochastic extension)
Multi-engine architecture Ch. 20 Ch. 24 (solver positions encoding), Ch. 27 §27.6 (platform-switcher path)
Parser-backed truth Ch. 22 §22.1 Ch. 23 (Data Center metadata gap), Ch. 24 (gmSolverID decoding), throughout the platform reference discussions
Three-layer reference system Ch. 22 §22.5.4 Ch. 26 §26.1.2, this chapter's ecosystem positioning

29.8.2 The through-line

What holds it together

Reading the principles above, a through-line emerges. IGW-NET's design philosophy is about managing complexity through structure rather than through raw computational power. Where traditional modeling often defaults to "make the grid finer, add more cells, run longer," IGW-NET's principles push instead toward: separate the conceptual model from numerics; refine hierarchically rather than uniformly; represent heterogeneity at appropriate scales; calibrate within sound structure; quantify uncertainty without storing ensembles; ground documentation in what the code actually does rather than what it seems to do.

These principles aren't arbitrary. Each responds to a specific failure mode of traditional approaches — brute-force grids that slow without improving accuracy; calibration that fits heads while hiding structural errors; uncertainty analysis that runs out of memory at useful realization counts; documentation that drifts from implementation. The principles collectively make groundwater modeling accessible to more people, at more scales, with more confidence in what the model is actually doing.

29.8.3 What the manual is for

This manual has one purpose: help you do good groundwater modeling work with IGW-NET. Good work is more than correct numerics — it's modeling grounded in physical reality, structured for the questions being asked, calibrated with honesty about uncertainty, documented for others to build on, and shared in ways that contribute to the collective understanding.

The chapters approach this from multiple angles: Parts I and II cover the basic workflow to get you productive; Part III covers the advanced features for the hard problems; Part IV catalogs the reference details you'll need during real work; Part V orients you to resources, paths, terminology, and the collaborative dimension. All 29 chapters answer the same question — how do I do good groundwater modeling with IGW-NET — at different levels and for different situations.

29.8.4 An invitation

Reading a manual is one step. The next step is modeling — building models that answer real questions, publishing models that others can learn from, reviewing models that others have built, contributing to the growing collective understanding that the MAGNET4WATER ecosystem supports. This manual ends here; your modeling work begins (or continues) from here.

If something in this manual is unclear, incorrect, or missing, the thumbs-down feedback button on every page tells the documentation team what to improve. If something is missing that should be here, consider writing a concept page or contributing a tutorial. If you publish a model that demonstrates principles in this manual particularly well, it becomes part of the teaching infrastructure for the next generation of IGW-NET users.

The manual is a tool. Your modeling work is what matters. Good modeling.

Related references