{"id":21677961,"url":"https://github.com/pnnl/mass1","last_synced_at":"2026-01-04T22:08:57.622Z","repository":{"id":84372893,"uuid":"95044420","full_name":"pnnl/mass1","owner":"pnnl","description":"Modular Aquatic Simulation System 1D (MASS1)","archived":false,"fork":false,"pushed_at":"2020-04-17T17:23:37.000Z","size":66361,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-01-25T10:27:46.534Z","etag":null,"topics":["estuary","hydraulics","one-dimensional","open-channel","preissman-scheme","river","temperature","total-dissolved-gas","transport","water-quality"],"latest_commit_sha":null,"homepage":"https://store.pnnl.gov/content/modular-aquatic-simulation-system-1d-mass1","language":"Fortran","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pnnl.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-06-21T20:42:58.000Z","updated_at":"2024-08-30T02:24:37.000Z","dependencies_parsed_at":"2023-07-08T00:52:30.337Z","dependency_job_id":null,"html_url":"https://github.com/pnnl/mass1","commit_stats":{"total_commits":372,"total_committers":9,"mean_commits":"41.333333333333336","dds":0.6317204301075269,"last_synced_commit":"a8c4de41a8263769fd8402fdeb8fc3778572f6fa"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pnnl%2Fmass1","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pnnl%2Fmass1/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pnnl%2Fmass1/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pnnl%2Fmass1/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pnnl","download_url":"https://codeload.github.com/pnnl/mass1/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244591477,"owners_count":20477707,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["estuary","hydraulics","one-dimensional","open-channel","preissman-scheme","river","temperature","total-dissolved-gas","transport","water-quality"],"created_at":"2024-11-25T14:23:53.626Z","updated_at":"2026-01-04T22:08:57.548Z","avatar_url":"https://github.com/pnnl.png","language":"Fortran","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Modular Aquatic Simulation System in One Dimension (MASS1)\n\nCopyright (c) 2017 Battelle Memorial Institute\nLicensed under modified BSD License. A copy of this license can be\nfound in the [LICENSE](LICENSE) file in the top level directory of this\ndistribution.\n\nHome Page: http://mass1.pnnl.gov\nGithub repository: https://github.com/pnnl/mass1\n\n## Description\n\nMASS1 is a one-dimensional unsteady hydrodynamic and water quality\nmodel capable of simulating open channel flows, water surface\nelevations, dissolved gas, and water temperature. The model is\napplicable to any branched channel system. Because MASS1 uses\ncross-section averaging, only single values of water surface\nelevation, velocity, discharge, and temperature are produced at each\ncross-section location along the river course. Lateral (i.e., across\nthe river channel) and vertical variations of these quantities are not\nsimulated.  \n\nMASS1 was developed by Pacific Northwest National Laboratory\n(PNNL). It is a research code, written for applications and computer\nplatforms specific to the developers.  Others may, or may not,\nfind it useful.  \n\n## Obtaining the Code\n\nThe MASS1 source code is currently hosted on PNNL's internal Git\nrepository.  MASS1 shares some code with other applications, which is\nincluded in MASS1 as a Git sub-module.  Do the following to check out\nthe code:\n\n```\ngit clone https://stash.pnnl.gov/scm/~d3g096/mass1.git\ncd mass1\ngit submodule update --init\n```\n\n## Requirements\n\nMASS1 has been used primarily on UNIX, Linux, and Mac OS X\nsystems. The following describes how to build MASS1 on those\nplatforms.  It has been built and used on Windows systems, but rarely.\nThe following should work on Windows if [Cygwin](https://cygwin.com/)\nor [MinGW](http://www.mingw.org/) is utilized.  A native Windows build\nmay be available in the future. \n\n### Fortran 90/95 compiler\n\nMASS1 is a relatively portable, vanilla Fortran 90/95 code.  It has\nbeen built and used on UNIX, Linux, Mac OS X, and Windows.  A Fortran\n90/95 compiler is required.  MASS1 is currently developed and tested\non Mac OS X and Linux using the following compilers:\n\n* [GNU Fortran](https://gcc.gnu.org/fortran/), Version 4.1 or higher\n\n* [Intel Fortran](https://software.intel.com/en-us/fortran-compilers),\n  Version 10 or higher\n\nIn general, the Intel compiler produces a faster executable, but for\nmost applications, this is not noticable. In the past, Fortran\ncompilers from [NAG](https://www.nag.com/nag-compiler),\n[Absoft](https://www.absoft.com/),\n[IBM](http://www-03.ibm.com/software/products/en/xlfortran-linux), and\nothers have worked.  \n\n### Perl\n\nSeveral optional [Perl](https://www.perl.org/) pre/post-processing\nscripts are provided.  These use the following\n[Perl](https://www.perl.org/) modules:\n\n* `Date::Manip`\n\n* `PDL`\n\n* `PDL::Graphics::PGPLOT::Window`\n\nWhen MASS1 code is configured, the system's\n[Perl](https://www.perl.org/) installation is queried to see if the\nscripts can be used. If not, the scripts are not configured or\ninstalled.  \n\n### Python\n\nIn addition to the Perl scripts, some optional\n[Python](https://www.python.org/) pre/post-processing scripts are also\nprovided.  \n\n### R\n\nThere is an optional [R](https://www.r-project.org/) script for\nreading MASS1 time series output and boundary condition files. \n\n## Configure and Build\n\nMASS1 uses the [GNU Build System](https://en.wikipedia.org/wiki/GNU_Build_System) \nto build MASS1.  The `configure` script is used to query the system\nand determine if the compiler has sufficient capability to compile\nMASS1.  On most systems, simply executing the `configure` script is\nsufficient, but sometimes options are required. To get a list of\noptions, \n\n```\n./configure --help\n```\n\nA typical way to require the GNU Fortran compiler and trapping of\nfloating point errors:\n\n```\n./configure FC=gfortran FCFLAGS=\"-O2 -ffpe-trap=invalid,zero,overflow\"\n```\n\nSimilarly, for the Intel Fortran compiler:\n\n```\n./configure FC=ifort FCFLAGS=\"-O3 -fpe0\"\n```\n\n## Usage\n\nMASS1 is a *command line* application. There is no graphical user\ninterface.  All [input and output](doc/README.md) are plain text files.\nThere is very little [documentation](doc/README.md), other than the\ncode itself.  \n\nThe first step in a MASS1 application is to define the topology of the\nriver system to be simulated. The topological definition defines how\nthe channel system is connected as well as the location and type of\nhydraulic control structures. The domain into a set of *links*, each\nrepresenting a single river reach. The ends of each link either\nrepresent a boundary, at which river conditions are specified, or\nconnect to one or more other links. Each link is further divided into\nseries of computational points, where the hydrodynamic and transport\nequations are discretized.  \n\n\nWhen run, MASS1 expects to find a\n[configuration file](doc/configuration.md) named `mass1.cfg`.  \n\n## Citation\n\nIf you use MASS1, please cite \n\n   Richmond, M.C., Perkins, W.A., 2009. Efficient calculation of\n   dewatered and entrapped areas using hydrodynamic modeling and\n   GIS. *Environmental Modelling \u0026 Software* 24,\n   1447–1456. doi:10.1016/j.envsoft.2009.06.001 \n\nFor examples of MASS1 use, see the [bibliography](doc/bibliography.md). \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpnnl%2Fmass1","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpnnl%2Fmass1","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpnnl%2Fmass1/lists"}