DOI: 10.5281/zenodo.6701695
title: Atlas of European Eel Distribution (Anguilla anguilla) in Portugal, Spain and France

description: <strong>DESCRIPTION</strong> <strong>----------------</strong> VERSIONS version1.0.1 fixes problem with functions version1.0.2 added table dbeel_rivers.rn_rivermouth with GEREM basin, distance to Gibraltar and link to CCM. version1.0.3 fixes problem with functions ---------------- The SUDOANG project aims at providing common tools to managers to support eel conservation in the SUDOE area (Spain, France and Portugal). VISUANG is the SUDOANG Interactive Web Application that host all these tools . The application consists of an eel distribution atlas (GT1), assessments of mortalities caused by turbines and an atlas showing obstacles to migration<br> (GT2), estimates of recruitment and exploitation rate (GT3) and escapement (chosen as a target by the EC for the Eel Management Plans) (GT4). In addition, it includes an interactive map showing sampling results from the pilot basin network produced by GT6. The eel abundance for the eel atlas and escapement has been obtained using the Eel Density Analysis model (EDA, GT4's product). EDA extrapolates the abundance of eel in sampled river segments to other segments taking into account how the abundance, sex and size of the eels change depending on different parameters. Thus, EDA requires two main data sources: those related to the river<br> characteristics and those related to eel abundance and characteristics. However, in both cases, data availability was uneven in the SUDOE area. In addition, this information was dispersed among several managers and in different formats due to different sampling sources: Water Framework Directive (WFD), Community Framework for the Collection, Management and Use of Data in the Fisheries Sector (EUMAP), Eel Management Plans, research groups, scientific<br> papers and technical reports. Therefore, the first step towards having eel abundance estimations including the whole SUDOE area, was to have a joint river and eel database. In this report we will describe the database corresponding to the river’s characteristics in the SUDOE area and the eel abundances and their characteristics. In the case of rivers, two types of information has been collected: <strong>River topology</strong> (RN table): a compilation of data on rivers and their topological and hydrographic characteristics in the three countries. <strong>River attributes</strong> (RNA table): contains physical attributes that have fed the SUDOANG models. The estimation of eel abundance and characteristic (size, biomass, sex-ratio and silver) distribution at different scales (river segment, basin, Eel Management Unit (EMU), and country) in the SUDOE area obtained with the implementation of the EDA2.3 model has been compiled in the <strong>RNE table (eel predictions)</strong>. <strong>CURRENT ACTIVE PROJECT</strong> The project is currently active here : gitlab forgemia <strong>TECHNICAL DESCRIPTION TO BUILD THE POSTGRES DATABASE</strong> <strong>1. Build the database in postgres.</strong> All tables are in ESPG:3035 (European LAEA). The format is postgreSQL database. You can download other formats (shapefiles, csv), here SUDOANG gt1 database. Initial command <pre><code class="language-bash"># open a shell with command CMD # Move to the place where you have downloaded the file using the following command cd c:/path/to/my/folder # note psql must be accessible, in windows you can add the path to the postgres #bin folder, otherwise you need to add the full path to the postgres bin folder see link to instructions below createdb -U postgres eda2.3 psql -U postgres eda2.3 # this will open a command with # where you can launch the commands in the next box </code></pre> Within the psql command <pre><code class="language-sql"> create extension "postgis"; create extension "dblink"; create extension "ltree"; create extension "tablefunc"; create schema dbeel_rivers; create schema france; create schema spain; create schema portugal; -- type \q to quit the psql shell</code></pre> Now the database is ready to receive the differents dumps. The dump file are large. You might not need the part including unit basins or waterbodies. All the tables except waterbodies and unit basins are described in the Atlas. You might need to understand what is inheritance in a database. https://www.postgresql.org/docs/12/tutorial-inheritance.html <strong>2. RN (riversegments)</strong> These layers contain the topology (see Atlas for detail) dbeel_rivers.rn france.rn spain.rn portugal.rn Columns (see Atlas) gid idsegment source target lengthm nextdownidsegment path isfrontier issource seaidsegment issea geom isendoreic isinternational country dbeel_rivers.rn_rivermouth seaidsegment geom (polygon) gerem_zone_3 gerem_zone_4 (used in EDA) gerem_zone_5 ccm_wso_id country emu_name_short geom_outlet (point) name_basin dist_from_gibraltar_km name_coast basin_name <pre><code class="language-bash"># dbeel_rivers.rn ! mandatory =&gt; table at the international level from which # the other table inherit # even if you don't want to use other countries # (In many cases you should ... there are transboundary catchments) download this first. # the rn network must be restored firt ! #table rne and rna refer to it by foreign keys. pg_restore -U postgres -d eda2.3 "dbeel_rivers.rn.backup" #france pg_restore -U postgres -d eda2.3 "france.rn.backup" # spain pg_restore -U postgres -d eda2.3 "spain.rn.backup" # portugal pg_restore -U postgres -d eda2.3 "portugal.rn.backup" # rivermouth and basins, this file contains GEREM basins, distance to Gibraltar, the link to CCM id for each basin flowing to the sea. pg_restore -U postgres -d eda2.3 "dbeel_rivers.rn_rivermouth.backup" # with the schema you will probably want to be able to use the functions, but launch this only after # restoring rna in the next step psql -U postgres -d eda2.3 -f "function_dbeel_rivers.sql"</code></pre> <strong>3. RNA (Attributes)</strong> This corresponds to tables dbeel_rivers.rna france.rna spain.rna portugal.rna Columns (See Atlas) idsegment altitudem distanceseam distancesourcem cumnbdam medianflowm3ps surfaceunitbvm2 surfacebvm2 strahler shreeve codesea name pfafriver pfafsegment basin riverwidthm temperature temperaturejan temperaturejul wettedsurfacem2 wettedsurfaceotherm2 lengthriverm emu cumheightdam riverwidthmsource slope dis_m3_pyr_riveratlas dis_m3_pmn_riveratlas dis_m3_pmx_riveratlas drought drought_type_calc Code : <pre><code class="language-bash">pg_restore -U postgres -d eda2.3 "dbeel_rivers.rna.backup" pg_restore -U postgres -d eda2.3 "france.rna.backup" pg_restore -U postgres -d eda2.3 "spain.rna.backup" pg_restore -U postgres -d eda2.3 "portugal.rna.backup" </code></pre> <strong>4. RNE (eel predictions)</strong> These layers contain eel data (see Atlas for detail) dbeel_rivers.rne france.rne spain.rne portugal.rne Columns (see Atlas) idsegment surfaceunitbvm2 surfacebvm2 delta gamma density neel beel peel150 peel150300 peel300450 peel450600 peel600750 peel750 nsilver bsilver psilver150300 psilver300450 psilver450600 psilver600750 psilver750 psilver pmale150300 pmale300450 pmale450600 pfemale300450 pfemale450600 pfemale600750 pfemale750 pmale pfemale sex_ratio cnfemale300450 cnfemale450600 cnfemale600750 cnfemale750 cnmale150300 cnmale300450 cnmale450600 cnsilver150300 cnsilver300450 cnsilver450600 cnsilver600750 cnsilver750 cnsilver delta_tr gamma_tr type_fit_delta_tr type_fit_gamma_tr density_tr density_pmax_tr neel_pmax_tr nsilver_pmax_tr density_wd neel_wd beel_wd nsilver_wd bsilver_wd sector_tr year_tr is_current_distribution_area is_pristine_distribution_area_1985 Code for restauration <pre><code class="language-bash">pg_restore -U postgres -d eda2.3 "dbeel_rivers.rne.backup" pg_restore -U postgres -d eda2.3 "france.rne.backup" pg_restore -U postgres -d eda2.3 "spain.rne.backup" pg_restore -U postgres -d eda2.3 "portugal.rne.backup"</code></pre> <strong>5. Unit basins</strong> Units basins are not described in the Altas. They correspond to the following tables : dbeel_rivers.basinunit_bu france.basinunit_bu spain.basinunit_bu portugal.basinunit_bu france.basinunitout_buo spain.basinunitout_buo portugal.basinunitout_buo The unit basins is the simple basin that surrounds a segment. It correspond to the topography unit from which unit segment have been calculated. ESPG 3035. Tables bu_unitbv, and bu_unitbvout inherit from dbeel_rivers.unit_bv. The first table intersects with a segment, the second table does not, it corresponds to basin polygons which do not have a riversegment. Source : Portugal https://sniambgeoviewer.apambiente.pt/Geodocs/gml/inspire/HY_PhysicalWaters_DrainageBasinGeoCod.ziphttps://sniambgeoviewer.apambiente.pt/Geodocs/gml/inspire/HY_PhysicalWaters_DrainageBasinGeoCod.zip France In france unit bv corresponds to the RHT (Pella et al., 2012) Spain http://www.mapama.gob.es/ide/metadatos/index.html?srv=metadata.show&uuid=898f0ff8-f06c-4c14-88f7-43ea90e48233 <pre><code class="language-bash">pg_restore -U postgres -d eda2.3 'dbeel_rivers.basinunit_bu.backup' # france pg_restore -U postgres -d eda2.3 "france.basinunit_bu.backup" pg_restore -U postgres -d eda2.3 "france.basinunitout_buo.backup" # spain pg_restore -U postgres -d eda2.3 "spain.basinunit_bu.backup" pg_restore -U postgres -d eda2.3 "spain.basinunit_bu.backup" # portugal pg_restore -U postgres -d eda2.3 "portugal.basinunit_bu.backup" pg_restore -U postgres -d eda2.3 "portugal.basinunitout_buo.backup" </code></pre> <strong>6- Waterbodies</strong> In these tables we have have kept the structure from the source table in WISE or from the bd_topage. dbeel_rivers.waterbody_unitbv portugal.waterbody_unitbv france.waterbody_unitbv spain.waterbody_unitbv In France, corresponds to the hydrographic surface from bd_topage. <br> <br> https://bdtopage.eaufrance.fr/page/documents-ressources In spain it corresponds to . Cuencas hidrográficas de los principales ríos definidos en el artículo 3 de la Directiva Marco del Agua (DMA), in Portugal to HY_PhysicalWaters_DrainageBasinMAgua. <pre><code class="language-bash">pg_restore -U postgres -d eda2.3 "dbeel_rivers.waterbody_unitbv.backup" pg_restore -U postgres -d eda2.3 "portugal.waterbody_unitbv.backup" pg_restore -U postgres -d eda2.3 "france.waterbody_unitbv.backup" </code></pre> <br> 7- functions The functions can be found in dbeel_rivers_functions.sql you can read the examples there and description of the functions, here is a quick example showing the functionalities. dbeel_rivers.get_path provides the path between two idsegments of the same basin : <pre><code class="language-sql">select dbeel_rivers.get_path (113670,114115,'FR') -- FR113618.FR114065.FR114053.FR114042</code></pre> dbeel_rivers.get_distance calculates the distance between two rivers segments (including the distance of the idsegments themselves) <pre><code class="language-sql">select dbeel_rivers.get_distance (113670,114115,'FR'); --12669</code></pre> dbeel_rivers.upstream_segments_rn(TEXT) takes an upstream segment and returns a vector of idsegments attention this function is slower than national counterparts, check in schema spain portugal and france for quicker functions. It is use for instance to calculate all eels coming from the upstream basin. <pre><code class="language-sql">SELECT dbeel_rivers.upstream_segments_rn('FR114042'); /* FR114042 FR114053 FR113982 FR114034 ... */</code></pre> dbeel_rivers.upstream_segments_rn_sti(TEXT) takes an upstream segment and a TABLE with idsegment, target, source, this in more convenient for later use of routing functions (like get path) which require source and target<br> dbeel_rivers.downstream_segments_rn(TEXT) takes a segment and returns the path to the sea. <pre><code class="language-sql">SELECT dbeel_rivers.downstream_segments_rn('SP227795');</code></pre>
description: License agreement The whole dataset is licensed under a Creative Commons Attribution 4.0 International License 4.0. The eel dataset is the work of the sudoang team, and we permit reuse of the data for any purpose including commercial. In cases where original licenses. By downloading and using the data the user agrees to the terms and conditions of these licenses. Disclaimer of warranty The sudoang database and any related materials contained therein are provided "as is" without warranty of any kind, either express or implied, including, but not limited to, the implied warranties of merchantability, fitness for a particular purpose, noninterference, system integration, or noninfringement. The entire risk of use of the data shall be with the user. The user expressly acknowledges that the data may contain some nonconformities, defects, or errors. The authors do not warrant that the data will meet the user's needs or expectations, that the use of the data will be uninterrupted, or that all nonconformities, defects, or errors can or will be corrected. The authors are not inviting reliance on these data, and the user should always verify actual data. Limitation of liability In no event shall the authors be liable for costs of procurement of substitute goods or services, lost profits, lost sales or business expenditures, investments, or commitments in connection with any business, loss of any goodwill, or for any direct, indirect, special, incidental, exemplary, or consequential damages arising out of the use of the sudoang database and any related materials, however caused, on any theory of liability, and whether or not the authors have been advised of the possibility of such damage. These limitations shall apply notwithstanding any failure of essential purpose of any exclusive remedy