Polaris

User's guide

  • Quick Start for Users
  • Tasks
  • Config Files
  • Suites
  • Mesh component
  • E3SM Initial Condition Component
  • Ocean component
  • Sea ice component
  • Machines

Developer's guide

  • Quick Start for Developers
  • Overview
  • Command-line interface
  • Organization of Tasks
  • E3SM initial condition (e3sm/init) component
  • Mesh component
  • Ocean component
  • Sea ice component
  • Framework
  • Machines
  • Benchmarking a branch against a baseline
  • Troubleshooting
  • Documentation
  • Building the Documentation
  • Previewing the Documentation
  • How Conda and Spack Work Together in Polaris
  • Updating Deployment Dependencies
  • Updating Shared Spack Environments
  • API reference
    • Components
    • polaris framework
      • Command-line interface
      • Base Classes
      • analysis
      • config
      • io
      • job
      • logging
      • constants
      • mesh
        • polaris.mesh.info.is_planar
        • polaris.mesh.info.is_spherical
        • polaris.mesh.planar.compute_planar_hex_nx_ny
        • polaris.mesh.connectivity.active_edge_masks
        • polaris.mesh.connectivity.count_active_edges
        • polaris.mesh.connectivity.has_active_vertex
        • polaris.mesh.connectivity.transport_link_mask
        • polaris.mesh.connectivity.connected_to_seeds
        • polaris.mesh.connectivity.seed_mask_from_points
        • polaris.mesh.spherical.SphericalBaseStep
        • polaris.mesh.spherical.SphericalBaseStep.setup
        • polaris.mesh.spherical.SphericalBaseStep.run
        • polaris.mesh.spherical.SphericalBaseStep.save_and_plot_cell_width
        • polaris.mesh.QuasiUniformSphericalMeshStep
        • polaris.mesh.QuasiUniformSphericalMeshStep.setup
        • polaris.mesh.QuasiUniformSphericalMeshStep.run
        • polaris.mesh.QuasiUniformSphericalMeshStep.build_cell_width_lat_lon
        • polaris.mesh.QuasiUniformSphericalMeshStep.make_jigsaw_mesh
        • polaris.mesh.IcosahedralMeshStep
        • polaris.mesh.IcosahedralMeshStep.setup
        • polaris.mesh.IcosahedralMeshStep.run
        • polaris.mesh.IcosahedralMeshStep.make_jigsaw_mesh
        • polaris.mesh.IcosahedralMeshStep.build_subdivisions_cell_width_lat_lon
        • polaris.mesh.IcosahedralMeshStep.get_subdivisions
        • polaris.mesh.IcosahedralMeshStep.get_cell_width
      • Spherical Base Meshes
      • model_step
      • build
      • mpas
      • parallel
      • namelist
      • provenance
      • remap
      • resolution
      • streams
      • validate
      • viz
      • yaml
  • Design Documents

Tutorials

  • Developer Tutorial: Adding a New Category of Tasks

Glossary

  • Glossary
Polaris
  • API reference
  • polaris.mesh.connectivity.transport_link_mask
  • View page source

polaris.mesh.connectivity.transport_link_mask

polaris.mesh.connectivity.transport_link_mask(ds_mesh, cell_mask)[source]

Find the active edges across which a B-grid can move sea ice.

The velocity used to move ice across an edge is built from the velocities at the edge’s two vertices, so an edge whose vertices are both inactive carries no flux and does not connect the cells it separates, even though they share an edge.

Parameters:
  • ds_mesh (xarray.Dataset) – An MPAS mesh with cellsOnCell and nEdgesOnCell

  • cell_mask (numpy.ndarray or xarray.DataArray) – A boolean mask on cells that is True for cells in the domain

Returns:

link_mask (numpy.ndarray) – A boolean array of shape (nCells, maxEdges) that is True for active edges with at least one active vertex

Previous Next

© Copyright 2026, Energy Exascale Earth System Model Project.

Built with Sphinx using a theme provided by Read the Docs.