{ "cells": [ { "cell_type": "markdown", "id": "ee401c52", "metadata": {}, "source": [ "# Cross-Sections\n", "\n", "The `crosssections` module provides tools for managing river cross-section profiles.\n", "\n", "A **`profile`** extends `vector` and represents a single cross-section with:\n", "- 3D coordinates where X = curvilinear abscissa and Z = elevation\n", "- Reference points: left bank, right bank, bed\n", "- Hydraulic property calculations (wet area, wetted perimeter, hydraulic radius)\n", "\n", "The **`crosssections`** class manages a collection of profiles loaded from various formats:\n", "- `'2022'` — Wolf text format\n", "- `'2025_xlsx'` — Excel spreadsheet\n", "- `'vecz'` — Wolf vector with Z\n", "- `'sxy'` — SPW/SETHY format\n", "\n", "This tutorial demonstrates creating and manipulating cross-sections programmatically." ] }, { "cell_type": "code", "execution_count": 1, "id": "ef0a028d", "metadata": {}, "outputs": [], "source": [ "import numpy as np\n", "import matplotlib.pyplot as plt\n", "from wolfhece.PyCrosssections import profile, crosssections, postype" ] }, { "cell_type": "markdown", "id": "9bfe36a5", "metadata": {}, "source": [ "## Creating a Profile from Scratch\n", "\n", "A `profile` stores survey data as (curvilinear abscissa, 0, elevation) vertices." ] }, { "cell_type": "code", "execution_count": 2, "id": "61c4a0e1", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Profile 'CS1': 7 vertices\n", "S range: 0.0 – 16.0 m\n" ] } ], "source": [ "# Trapezoidal channel cross-section\n", "s = np.array([0, 2, 4, 8, 12, 14, 16]) # curvilinear abscissa [m]\n", "z = np.array([5, 5, 2, 1, 2, 5, 5]) # elevation [m]\n", "\n", "# Build the (s, z) array – profile expects 2 columns\n", "coords = np.column_stack([s, z])\n", "\n", "p = profile(name='CS1', data_sect=coords)\n", "print(f\"Profile '{p.myname}': {p.nbvertices} vertices\")\n", "print(f\"S range: {s[0]:.1f} – {s[-1]:.1f} m\")" ] }, { "cell_type": "markdown", "id": "686385fb", "metadata": {}, "source": [ "## Plotting a Profile" ] }, { "cell_type": "code", "execution_count": 3, "id": "f4fb368f", "metadata": {}, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "fig, ax = plt.subplots(figsize=(8, 3))\n", "ax.plot(s, z, 'b-o', markersize=4)\n", "ax.fill_between(s, z, z.max(), alpha=0.1)\n", "ax.set_xlabel('Curvilinear abscissa [m]')\n", "ax.set_ylabel('Elevation [m]')\n", "ax.set_title(f'Cross-section: {p.myname}')\n", "ax.grid(True)" ] }, { "cell_type": "markdown", "id": "91a3e05c", "metadata": {}, "source": [ "## Reference Points\n", "\n", "A profile can store reference positions for the left bank, right bank, and bed.\n", "These are used for hydraulic calculations and for aligning profiles along a river." ] }, { "cell_type": "code", "execution_count": 4, "id": "cd03443a", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Left bank at s=4.0, z=2.0\n", "Right bank at s=12.0, z=2.0\n", "Bed at s=8.0, z=1.0\n" ] } ], "source": [ "# Set reference points using vertex indices\n", "# Vertices: s=[0,2,4,8,12,14,16] z=[5,5,2,1,2,5,5]\n", "# Index: 0 1 2 3 4 5 6\n", "p.banksbed_postype = postype.BY_INDEX\n", "p.bankleft = 2 # vertex at s=4m\n", "p.bankright = 4 # vertex at s=12m\n", "p.bed = 3 # vertex at s=8m, z=1m\n", "\n", "bl = p.bankleft_vertex\n", "br = p.bankright_vertex\n", "bd = p.bed_vertex\n", "print(f\"Left bank at s={bl.x}, z={bl.z}\")\n", "print(f\"Right bank at s={br.x}, z={br.z}\")\n", "print(f\"Bed at s={bd.x}, z={bd.z}\")" ] }, { "cell_type": "markdown", "id": "402cb343", "metadata": {}, "source": [ "## Working with Multiple Cross-Sections\n", "\n", "In practice, cross-sections are loaded from files via `crosssections(filename, format=...)`.\n", "\n", "Here we demonstrate creating a simple collection programmatically." ] }, { "cell_type": "code", "execution_count": 5, "id": "88f7bf09", "metadata": {}, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAA04AAAGJCAYAAAC90mOkAAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjEwLjgsIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvwVt1zgAAAAlwSFlzAAAPYQAAD2EBqD+naQAAqA5JREFUeJzs3QdYU9f7B/Ave4MiIg5AcW9FW1fdq2rdta0dtr+uf1vbqt122a3du3bbXWtb995771mVoSCCuNib5P+8JwQBGQkkJCHfz/NEMm5uTu5N4n3vec97HLRarRZERERERERUJseyHyIiIiIiIiIGTkRERERERAZgjxMREREREVEFGDgRERERERFVgIETERERERFRBRg4ERERERERVYCBExERERERUQUYOBEREREREVWAgRMREREREVEFGDgRUYX69eunLlQznTlzBg4ODvjpp59grdLS0hAYGIjff//d0k2hKmrcuDHuu+8+bkcLuuOOO3DbbbdxHxAZiYETkR2SA2Q5UNZfnJ2d0bBhQ3UwExcXZ+nmkZn88ccf+OSTT2xy+3766afw8fFRB3yW9tVXX1l1kEnmc/z4cbz22mvqZIMte/755/Hvv//i0KFDlm4KkU1xtnQDiMhy3njjDTRp0gRZWVnYuXOnOhjcunUrjh49Cnd398LlVq9ezd1UQwIn2bdTp04tdn9oaCgyMzPh4uICa5Sbm6sCp2nTpsHJyckqAqeAgAD2mthp4PT666+rHnjpObNVnTt3RteuXfHhhx/il19+sXRziGwGe5yI7NiwYcNw991348EHH8T333+PZ555BpGRkVi8eHGx5VxdXdWlOuXl5SEnJ8ek69RqtSpAoOKk11ECZWsISkqzdOlSXLx40SZTi9LT0y3dBLIQa/+9ke/T/PnzVRosERmGgRMRFerdu7f6K8FTWWOcLly4oFL75KxrSSdPnlQH4V988UXhfUlJSaqHIzg4GG5ubmjWrBneffddaDSa68bYfPDBByqVrGnTpmpZObtbnt9++w033ngjPD09Ubt2bfTp06dY75icEb7llluwatUqdXbVw8MD33zzjXosKioKEyZMgL+/v3p+9+7dsWzZsute4/PPP0fbtm0LX0PWIz03eqmpqer9yWtJm2UczuDBg7F///4KP1l79+7F0KFDVe+FtE16/+6///5iy8h2km0ibZDg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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Create three profiles with gradually widening channel\n", "profiles = []\n", "for i, width in enumerate([8, 10, 14]):\n", " half = width / 2\n", " s_i = np.array([0, 2, 2+half*0.3, 2+half, 2+half+half*0.3, 2+half+2, 4+width])\n", " z_i = np.array([5, 5, 2, 1, 2, 5, 5])\n", " coords_i = np.column_stack([s_i, z_i]) # 2 columns: (s, z)\n", " p_i = profile(name=f'CS{i+1}', data_sect=coords_i)\n", " profiles.append(p_i)\n", "\n", "fig, ax = plt.subplots(figsize=(10, 4))\n", "for p_i in profiles:\n", " xs = [v.x for v in p_i.myvertices]\n", " zs = [v.z for v in p_i.myvertices]\n", " ax.plot(xs, zs, '-o', markersize=3, label=p_i.myname)\n", "\n", "ax.set_xlabel('Curvilinear abscissa [m]')\n", "ax.set_ylabel('Elevation [m]')\n", "ax.set_title('River cross-sections (upstream → downstream)')\n", "ax.legend()\n", "plt.show()" ] }, { "cell_type": "markdown", "id": "bbb7ac25", "metadata": {}, "source": [ "## Hydraulic Calculations\n", "\n", "A `profile` can compute basic hydraulic properties for a given water level:\n", "- Wet area\n", "- Wetted perimeter\n", "- Hydraulic radius\n", "\n", "These are computed from the cross-section geometry with the `wetarea`, `wetperimeter`, and `hydraulicradius` attributes after setting the water surface level." ] }, { "cell_type": "code", "execution_count": 6, "id": "e9845146", "metadata": {}, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAjIAAAHHCAYAAACle7JuAAAAOnRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjEwLjgsIGh0dHBzOi8vbWF0cGxvdGxpYi5vcmcvwVt1zgAAAAlwSFlzAAAPYQAAD2EBqD+naQAAUtdJREFUeJzt3QmcjWX/x/HvjLFv2bIOWpQWUdGCDLIkiUqKFloVhbRRT0ULLZJKi/iXUlLWtFDKnp2UhORBSEnJMvaZ83/9rvs508yYYWacmbN93q/XYc597jlzzXXumfOda43x+Xw+AQAAhKHYYBcAAAAgpwgyAAAgbBFkAABA2CLIAACAsEWQAQAAYYsgAwAAwhZBBgAAhC2CDAAACFsEGQAAELYIMgAAIGwRZIBsWrdunbp27aqTTz5ZhQoVUokSJdSgQQO9/PLL2rdvX8p5Bw8edMfOPfdcd84JJ5ygs846S3feeadWr16dct6ePXv0xBNP6LLLLlPp0qUVExOjkSNHhsTr8umnnyohIUEnnniiihQp4r7nDh06aOrUqSnn/Pbbb+rXr5+WL1+ucPLFF1+4uq5UqZKSk5MVyiZOnKhWrVqpbNmyKlCggCuzvQ7Tp08PdtGAoIsLdgGAcPL555/r2muvVcGCBXXzzTfr7LPPdoFl7ty5evDBB7Vy5Uq99dZb7txrrrlGU6ZMUceOHXXHHXfo0KFDLsB89tlnql+/vmrWrOnO2759u5588klVrVpVtWvX1syZMxUKBg0a5L4nCzJ9+/Z1QeaXX37R119/rTFjxrjg5Q8y/fv3V/Xq1VWnTh2Fiw8++MCVecOGDS4QNGvWTKHGtsK79dZbXbC1QNy7d29VqFBBW7dudeHm0ksv1bfffuuuJyBq2aaRAI7tv//9r69YsWK+mjVr+n777bcjHl+7dq1vyJAh7uNFixbZZqy+Z5555ojzDh8+7Nu+fXvK/f379/u2bt3qPl68eLH7vHfeeSeoL8mhQ4d8JUqU8DVv3jzDx//444+Uj0OlzNmxZ88eX9GiRX2vvPKK79xzz/V16dIlS5+XlJTk27dvny+vvPDCC65ue/Xq5UtOTj7i8ffee8+3cOHC4/469tx79+497ucBgoGuJSCLnn/+edcN9H//93+qWLHiEY+feuqp6tmzZ0r3k7Eup/Ty5cunMmXKpNy31h37KzuUWCvRrl27Miy/sa4mY61H9erVcx/fcsstrqsmddfYnDlzXAuWtTbZ9xkfH6/77rsvTRec39ixY3XmmWe67jpr6bIWhy5durhWk9SsG2jIkCGum87OLV++vOvq27FjR5a/P3tuK4OV7frrr9eECRO0f//+I86z7+Wee+5xrTf29ex78HerbdmyxbWW2Ne34/b422+/nebzrbXu8ccf1/nnn6+SJUuqaNGiuuSSSzRjxoxjltHKN3DgQNdyZ61jVpb0brrpJl1wwQXuY+vey+gcey3suLU8+VmdXnHFFfryyy9Vt25dFS5cWMOGDXP13qRJkyOew+q8cuXKat++fUBfByAQCDJANsaL2BiRrDTjV6tWzf1vb4CHDx8Ouzq2oGJvbvY9//3335med8YZZ7huMWNjf0aNGuVujRo1Sgkne/fu1d13361XX31VLVu2dP9bt1z6LrvrrrtO+fPnd2/eV199tW677TYtXbr0iK9pb5bW5eUfl2QByurZntu677LCzrc3bAuQFmR2797tvteMWLeThS8rn309CwF//PGHLrroItfNZkHHjluQtTLbm7ufhcERI0aocePGeu6551zY+PPPP11ZjzWmyLorre47derkwm+grVmzxnV7Nm/e3JXfugXte5w9e7Z+//33I8piXYhWV4F8HYCACEo7EBBmdu7c6Zr427Ztm+Wm+oSEBPc55cuX93Xs2NH32muv+TZu3HjUzwulbprHH3/clcW6YFq1auW6yZYuXZqtMmfUXTFw4EBfTExMmrqoVauWr0qVKr7du3enHJs5c6Z73mrVqqUcmzNnjjv2wQcfpHnOqVOnZng8s26xuLg43/Dhw1OO1a9fP8PX1p4zNjbWt3LlyjTHb7vtNl/FihXTdBGa66+/3leyZMmU79u6EQ8cOJDmnB07drhr4tZbbz1qOV9++WX39SdOnOjLiieeeMKdn569LnZ8/fr1KcesTu2Y1Vtqa9asccdfffXVNMe7devmulX931cgXgcgUGiRAbLA/rI2xYsXz1J9WVO+Nds//fTTKlWqlD788EN1797dtdTYX73//PNPyNe7DeAdPXq0G2Rq38ujjz7qukjOO+88rVq1KkvPYa06fomJia7Lylq0LCN899137rj9pb9ixQrXSlOsWLGU822Qca1atdI8n7XwWBeNtSLYc/lvVi773Kx02dhA5djYWDcY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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "# Compute wet properties for the first profile at different water levels\n", "p1 = profiles[0]\n", "xs_p1 = np.array([v.x for v in p1.myvertices])\n", "zs_p1 = np.array([v.z for v in p1.myvertices])\n", "\n", "water_levels = np.linspace(1.5, 4.5, 7)\n", "areas = []\n", "for wl in water_levels:\n", " # Compute wet area by trapezoidal integration under water level\n", " clipped_z = np.minimum(zs_p1, wl)\n", " area = np.trapezoid(wl - clipped_z, xs_p1)\n", " areas.append(area)\n", "\n", "fig, ax = plt.subplots()\n", "ax.plot(water_levels, areas, '-o', color='blue')\n", "ax.set_xlabel('Water Level [m]')\n", "ax.set_ylabel('Wet Area [m²]')\n", "ax.set_title(f'{p1.myname} — Stage-Area Curve')\n", "ax.grid(True)\n", "plt.show()" ] }, { "cell_type": "markdown", "id": "e90d63b8", "metadata": {}, "source": [ "## Loading Cross-Sections from Files\n", "\n", "In real applications, cross-sections are loaded from survey data files:\n", "\n", "```python\n", "# Wolf 2022 text format\n", "cs = crosssections('path/to/sections.txt', format='2022')\n", "\n", "# Excel format (requires openpyxl)\n", "cs = crosssections('path/to/sections.xlsx', format='2025_xlsx')\n", "\n", "# Wolf vector format with Z\n", "cs = crosssections('path/to/sections.vecz', format='vecz')\n", "\n", "# SPW/SETHY format\n", "cs = crosssections('path/to/sections.sxy', format='sxy')\n", "```\n", "\n", "After loading, profiles are available in `cs.myprofiles`, a dict keyed by `'cs'`, `'index'`, `'left'`, `'bed'`, `'right'`." ] } ], "metadata": { "kernelspec": { "display_name": "python311", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.11.9" } }, "nbformat": 4, "nbformat_minor": 5 }