History of foodweb_ulanowicz
The changes to the source code of this entry in the repository, newest first, each with the differences it made to the entry's files. They are also listed on GitLab.
[entries] Remove superfluous details of the upstream distribution from the descriptions dc07aa0
The descriptions mentioned incidental details of how the upstream data are made available: the file formats (CSV, JSON, XML, GEXF, SBML, HIF, Pajek, UCINET, ...), file names, where the files were published or obtained from (Zenodo, figshare, Kaggle, the Pajek datasets page, the Internet Archive), and that some networks are only available in the gt format. These are left out; caveats about the data themselves are kept, referring to "the data" instead of "the file". The description of sp_baboons now lists its properties instead of the upstream columns, and says that events without a recipient are left out.
diff --git a/entries/foodweb_ulanowicz/__init__.py b/entries/foodweb_ulanowicz/__init__.py
index 44a2d65..473db01 100644
--- a/entries/foodweb_ulanowicz/__init__.py
+++ b/entries/foodweb_ulanowicz/__init__.py
@@ -19,7 +19,7 @@
from .. import *
title = 'Ulanowicz ecosystem flow networks (1989-2002)'
-description = """Ecosystem networks of carbon flows (food webs) among the compartments of several aquatic and wetland ecosystems, selected from R. E. Ulanowicz's collection of ecosystem networks (Chesapeake Biological Laboratory, University of Maryland; version of July 22, 2002) and from the ATLSS project (Network Analysis of Trophic Dynamics in South Florida Ecosystems). The original data in SCOR format were converted into Pajek format by V. Batagelj (2003, 2004). Nodes are compartments: living compartments (taxa or groups of taxa), other non-living compartments (e.g. detritus and dissolved or particulate organic carbon), and three special nodes representing the inputs (imports and primary production sources), the outputs (exports) and respiration of the ecosystem. A directed edge points from a donor to a recipient compartment, and is weighted by the flow of carbon between them. The units are those of the original studies (typically milligrams or grams of carbon per square meter, per day or per year), and differ between networks. Some networks have self-loops (flows within a compartment, e.g. cannibalism). The data were distributed in Pajek format on the Pajek datasets page of V. Batagelj and A. Mrvar, from which this version was obtained. The general collection's "Florida" network is not included separately, since it is identical to the ATLSS Florida Bay wet season network (`baywet`).
+description = """Ecosystem networks of carbon flows (food webs) among the compartments of several aquatic and wetland ecosystems, selected from R. E. Ulanowicz's collection of ecosystem networks (Chesapeake Biological Laboratory, University of Maryland; version of July 22, 2002) and from the ATLSS project (Network Analysis of Trophic Dynamics in South Florida Ecosystems). The networks were prepared from the original data by V. Batagelj (2003, 2004). Nodes are compartments: living compartments (taxa or groups of taxa), other non-living compartments (e.g. detritus and dissolved or particulate organic carbon), and three special nodes representing the inputs (imports and primary production sources), the outputs (exports) and respiration of the ecosystem. A directed edge points from a donor to a recipient compartment, and is weighted by the flow of carbon between them. The units are those of the original studies (typically milligrams or grams of carbon per square meter, per day or per year), and differ between networks. Some networks have self-loops (flows within a compartment, e.g. cannibalism). The general collection's "Florida" network is not included separately, since it is identical to the ATLSS Florida Bay wet season network (`baywet`).
- `chesapeake`: Chesapeake Bay mesohaline ecosystem, summer carbon flows (Baird and Ulanowicz, 1989).
- `ches_lower`: lower Chesapeake Bay in summer (Hagy, 2002).
[entries] Add the date when each entry was added, and remove icon_hash beff7c9
The dates are those of the commits that first added the entries' files (2020-08-11 for the entries of the initial commit); renamed entries keep the date of their first name. Changed: none
diff --git a/entries/foodweb_ulanowicz/__init__.py b/entries/foodweb_ulanowicz/__init__.py
index a94f023..44a2d65 100644
--- a/entries/foodweb_ulanowicz/__init__.py
+++ b/entries/foodweb_ulanowicz/__init__.py
@@ -58,8 +58,7 @@ citation = [('D. Baird, R. E. Ulanowicz, "The Seasonal Dynamics of The Chesapeak
('D. Baird, J. Luczkovich, R. R. Christian, "Assessment of Spatial and Temporal Variability in Ecosystem Attributes of the St Marks National Wildlife Refuge, Apalachee Bay, Florida." Estuarine, Coastal and Shelf Science 47(3), 329-349 (1998)', 'https://doi.org/10.1006/ecss.1998.0360'),
('R. E. Ulanowicz, J. J. Heymans, M. S. Egnotovich, "Network Analysis of Trophic Dynamics in South Florida Ecosystems, FY 99: The Graminoid Ecosystem." Technical Report CBL 00-0176, Chesapeake Biological Laboratory (2000)', 'https://www.cbl.umces.edu/~atlss/swgras701.html'),
('R. E. Ulanowicz, C. Bondavalli, M. S. Egnotovich, "Network Analysis of Trophic Dynamics in South Florida Ecosystem, FY 97: The Florida Bay Ecosystem." Technical Report CBL 98-123, Chesapeake Biological Laboratory (1998)', 'https://www.cbl.umces.edu/~atlss/FBay701.html')]
-icon_hash = ['5901f75962da632511870feb', '5901f79762da632511870fec', '5902c63f62da632511870fed', '5902c72662da632511870fef', '590be70b62da632511877edd', '590be76662da632511877ede',
- '584100bd8cf714f319c45415', '5902c69c62da632511870fee']
+date_added = '2026-10-25'
upstream_license = None
# The Pajek data site (vlado.fmf.uni-lj.si) is no longer reachable, so the
# files are obtained from the Internet Archive.
[entries] Prefix the properties in the descriptions with (Node), (Edge) or (Graph) bc3dbbd
The lists of properties at the end of the descriptions marked edge properties with "Edge" but left node properties unmarked, or grouped them in "Nodes: `a`, ...; `b`, ..." items, so the kind of a property was often unclear. Every item now starts with (Node), (Edge) or (Graph), followed by the property names, a colon and the explanation, one item per property or group of properties; qualifications (kinds of nodes, networks) follow the names in parentheses. Properties that were only named got a short explanation, and a few items that named the wrong kind of property were corrected.
diff --git a/entries/foodweb_ulanowicz/__init__.py b/entries/foodweb_ulanowicz/__init__.py
index 7e9e57b..a94f023 100644
--- a/entries/foodweb_ulanowicz/__init__.py
+++ b/entries/foodweb_ulanowicz/__init__.py
@@ -45,8 +45,10 @@ description = """Ecosystem networks of carbon flows (food webs) among the compar
The networks have the following properties:
-- Nodes: `name`, the name of the compartment; `type`, the type of compartment (1: living/producing compartment, 2: other compartment, 3: input, 4: output, 5: respiration); `biomass`, the biomass (standing stock) of the compartment (in the `maspalomas` and `rhode` networks, the source gives all biomasses as 1 or 0, i.e. they are not available).
-- Edges: `weight`, the flow of carbon from the donor to the recipient compartment."""
+- (Node) `name`: the name of the compartment.
+- (Node) `type`: the type of compartment (1: living/producing compartment, 2: other compartment, 3: input, 4: output, 5: respiration).
+- (Node) `biomass`: the biomass (standing stock) of the compartment (in the `maspalomas` and `rhode` networks, the source gives all biomasses as 1 or 0, i.e. they are not available).
+- (Edge) `weight`: the flow of carbon from the donor to the recipient compartment."""
tags = ['Biological', 'Food web', 'Weighted', 'Metadata']
url = 'https://web.archive.org/web/20040703075824/http://vlado.fmf.uni-lj.si/pub/networks/data/bio/foodweb/foodweb.htm'
citation = [('D. Baird, R. E. Ulanowicz, "The Seasonal Dynamics of The Chesapeake Bay Ecosystem." Ecological Monographs 59(4), 329-364 (1989)', 'https://doi.org/10.2307/1943071'),
[entries] New entry: foodweb_ulanowicz 9aa1cef
Replaces foodweb_baywet (KONECT), which is now the network `baywet` of this entry.
diff --git a/entries/foodweb_ulanowicz/__init__.py b/entries/foodweb_ulanowicz/__init__.py
new file mode 100644
index 0000000..7e9e57b
--- /dev/null
+++ b/entries/foodweb_ulanowicz/__init__.py
@@ -0,0 +1,103 @@
+#! /usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2020-2026 Tiago de Paula Peixoto <tiago@skewed.de>
+#
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+
+from .. import *
+
+title = 'Ulanowicz ecosystem flow networks (1989-2002)'
+description = """Ecosystem networks of carbon flows (food webs) among the compartments of several aquatic and wetland ecosystems, selected from R. E. Ulanowicz's collection of ecosystem networks (Chesapeake Biological Laboratory, University of Maryland; version of July 22, 2002) and from the ATLSS project (Network Analysis of Trophic Dynamics in South Florida Ecosystems). The original data in SCOR format were converted into Pajek format by V. Batagelj (2003, 2004). Nodes are compartments: living compartments (taxa or groups of taxa), other non-living compartments (e.g. detritus and dissolved or particulate organic carbon), and three special nodes representing the inputs (imports and primary production sources), the outputs (exports) and respiration of the ecosystem. A directed edge points from a donor to a recipient compartment, and is weighted by the flow of carbon between them. The units are those of the original studies (typically milligrams or grams of carbon per square meter, per day or per year), and differ between networks. Some networks have self-loops (flows within a compartment, e.g. cannibalism). The data were distributed in Pajek format on the Pajek datasets page of V. Batagelj and A. Mrvar, from which this version was obtained. The general collection's "Florida" network is not included separately, since it is identical to the ATLSS Florida Bay wet season network (`baywet`).
+
+- `chesapeake`: Chesapeake Bay mesohaline ecosystem, summer carbon flows (Baird and Ulanowicz, 1989).
+- `ches_lower`: lower Chesapeake Bay in summer (Hagy, 2002).
+- `ches_middle`: middle Chesapeake Bay in summer (Hagy, 2002).
+- `ches_upper`: upper Chesapeake Bay in summer (Hagy, 2002).
+- `crystal_control`: Crystal River Creek, Florida, control marsh (Homer and Kemp).
+- `crystal_delta`: Crystal River Creek, Florida, marsh exposed to the thermal effluent of a power plant (Homer and Kemp).
+- `everglades`: Everglades graminoid marshes (Ulanowicz et al., 2000), from the general collection.
+- `maspalomas`: Charca de Maspalomas, a coastal lagoon in Gran Canaria (Almunia et al., 1999).
+- `michigan`: Lake Michigan control network (Krause and Mason).
+- `mondego`: Mondego Estuary, Zostera site, Portugal (PatrÃcio).
+- `narragansett`: Narragansett Bay model (Monaco and Ulanowicz, 1997).
+- `rhode`: Rhode River watershed, water budget (Correll).
+- `stmarks`: St. Marks River estuary, Florida (Baird, Luczkovich and Christian, 1998).
+- `baydry`: Florida Bay, a shallow subtropical estuary in South Florida, dry season (Ulanowicz et al., 1998).
+- `baywet`: Florida Bay, wet season (Ulanowicz et al., 1998).
+- `cypdry`: cypress wetlands of South Florida, dry season (Ulanowicz et al., 1997).
+- `cypwet`: cypress wetlands of South Florida, wet season (Ulanowicz et al., 1997).
+- `gramdry`: Everglades graminoid marshes, dry season (Ulanowicz et al., 2000).
+- `gramwet`: Everglades graminoid marshes, wet season (Ulanowicz et al., 2000).
+- `mangdry`: mangrove estuary of South Florida, dry season (Ulanowicz et al., 1999).
+- `mangwet`: mangrove estuary of South Florida, wet season (Ulanowicz et al., 1999).
+
+The networks have the following properties:
+
+- Nodes: `name`, the name of the compartment; `type`, the type of compartment (1: living/producing compartment, 2: other compartment, 3: input, 4: output, 5: respiration); `biomass`, the biomass (standing stock) of the compartment (in the `maspalomas` and `rhode` networks, the source gives all biomasses as 1 or 0, i.e. they are not available).
+- Edges: `weight`, the flow of carbon from the donor to the recipient compartment."""
+tags = ['Biological', 'Food web', 'Weighted', 'Metadata']
+url = 'https://web.archive.org/web/20040703075824/http://vlado.fmf.uni-lj.si/pub/networks/data/bio/foodweb/foodweb.htm'
+citation = [('D. Baird, R. E. Ulanowicz, "The Seasonal Dynamics of The Chesapeake Bay Ecosystem." Ecological Monographs 59(4), 329-364 (1989)', 'https://doi.org/10.2307/1943071'),
+ ('J. D. Hagy, "Eutrophication, hypoxia and trophic transfer efficiency in Chesapeake Bay." PhD thesis, University of Maryland at College Park (2002)', 'https://web.archive.org/web/20040703075824/http://vlado.fmf.uni-lj.si/pub/networks/data/bio/foodweb/foodweb.htm'),
+ ('J. Almunia, G. Basterretxea, J. ArÃstegui, R. E. Ulanowicz, "Benthic-Pelagic Switching in a Coastal Subtropical Lagoon." Estuarine, Coastal and Shelf Science 49(3), 363-384 (1999)', 'https://doi.org/10.1006/ecss.1999.0503'),
+ ('M. E. Monaco, R. E. Ulanowicz, "Comparative ecosystem trophic structure of three U.S. mid-Atlantic estuaries." Marine Ecology Progress Series 161, 239-254 (1997)', 'https://doi.org/10.3354/meps161239'),
+ ('D. Baird, J. Luczkovich, R. R. Christian, "Assessment of Spatial and Temporal Variability in Ecosystem Attributes of the St Marks National Wildlife Refuge, Apalachee Bay, Florida." Estuarine, Coastal and Shelf Science 47(3), 329-349 (1998)', 'https://doi.org/10.1006/ecss.1998.0360'),
+ ('R. E. Ulanowicz, J. J. Heymans, M. S. Egnotovich, "Network Analysis of Trophic Dynamics in South Florida Ecosystems, FY 99: The Graminoid Ecosystem." Technical Report CBL 00-0176, Chesapeake Biological Laboratory (2000)', 'https://www.cbl.umces.edu/~atlss/swgras701.html'),
+ ('R. E. Ulanowicz, C. Bondavalli, M. S. Egnotovich, "Network Analysis of Trophic Dynamics in South Florida Ecosystem, FY 97: The Florida Bay Ecosystem." Technical Report CBL 98-123, Chesapeake Biological Laboratory (1998)', 'https://www.cbl.umces.edu/~atlss/FBay701.html')]
+icon_hash = ['5901f75962da632511870feb', '5901f79762da632511870fec', '5902c63f62da632511870fed', '5902c72662da632511870fef', '590be70b62da632511877edd', '590be76662da632511877ede',
+ '584100bd8cf714f319c45415', '5902c69c62da632511870fee']
+upstream_license = None
+# The Pajek data site (vlado.fmf.uni-lj.si) is no longer reachable, so the
+# files are obtained from the Internet Archive.
+upstream_prefix = 'https://web.archive.org/web/20130507081152id_/http://vlado.fmf.uni-lj.si/pub/networks/data/bio/FoodWeb'
+files = [('Webs_paj.zip:paj/Chesapeake.paj', 'chesapeake', None),
+ ('Webs_paj.zip:paj/ChesLower.paj', 'ches_lower', None),
+ ('Webs_paj.zip:paj/ChesMiddle.paj', 'ches_middle', None),
+ ('Webs_paj.zip:paj/ChesUpper.paj', 'ches_upper', None),
+ ('Webs_paj.zip:paj/CrystalC.paj', 'crystal_control', None),
+ ('Webs_paj.zip:paj/CrystalD.paj', 'crystal_delta', None),
+ ('Webs_paj.zip:paj/Everglades.paj', 'everglades', None),
+ ('Webs_paj.zip:paj/Maspalomas.paj', 'maspalomas', None),
+ ('Webs_paj.zip:paj/Michigan.paj', 'michigan', None),
+ ('Webs_paj.zip:paj/Mondego.paj', 'mondego', None),
+ ('Webs_paj.zip:paj/Narragan.paj', 'narragansett', None),
+ ('Webs_paj.zip:paj/Rhode.paj', 'rhode', None),
+ ('Webs_paj.zip:paj/StMarks.paj', 'stmarks', None),
+ ('ATLSS_paj.zip:baydry.paj', 'baydry', None),
+ ('ATLSS_paj.zip:baywet.paj', 'baywet', None),
+ ('ATLSS_paj.zip:cypdry.paj', 'cypdry', None),
+ ('ATLSS_paj.zip:cypwet.paj', 'cypwet', None),
+ ('ATLSS_paj.zip:gramdry.paj', 'gramdry', None),
+ ('ATLSS_paj.zip:gramwet.paj', 'gramwet', None),
+ ('ATLSS_paj.zip:mangdry.paj', 'mangdry', None),
+ ('ATLSS_paj.zip:mangwet.paj', 'mangwet', None)]
+
+def fetch_upstream(force=False):
+ return fetch_upstream_files(__name__.split(".")[-1], upstream_prefix, files,
+ force)
+
+@cache_network()
+@coerce_props(vforce={"biomass": "double"})
+@annotate()
+def parse(alts=None):
+ name = __name__.split(".")[-1]
+ for fname, alt, fmt in files:
+ if alts is not None and alt not in alts:
+ continue
+ items = load_pajek(name, fname)
+ g = pajek_graph(get_pajek_item(items, "network"))
+ set_pajek_partition(g, get_pajek_item(items, "partition"), "type")
+ set_pajek_partition(g, get_pajek_item(items, "vector"), "biomass", "double")
+ yield alt, g