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:
| Field | What to provide | Purpose |
|---|---|---|
| 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
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:
- Search by region — find models within your geographic area of interest
- Search by topic — filter by problem type (contamination, water supply, coupled SW-GW, etc.)
- Inspect candidate models — read descriptions, view preview images, check the scope and approach
- Load promising models — open the model file to see the full configuration
- 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 pattern | Roles | Coordination 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
dataNetWCSordataNetmWCS), 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
| Platform | Focus | Connects 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:
| Principle | First established | Revisited 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
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
- Chapter 1 — What IGW-NET Is — where the ecosystem was first introduced; closing the loop by revisiting it.
- Chapter 16 §16.6 — SwaNET handshaking — the most common cross-platform coordination.
- Chapter 23 §23.7 — Global Database vs DataNET.
- Chapter 26 — Help Resources.
- ← Return to the Contents.
- The MAGNET4WATER Observatory.
- MAGNET4WATER main site.