Update dependency HPCLinearAlgebra → HPCSparseArrays

Author: Sebastien Loisel

Project.toml

@@ -1,4 +1,4 @@
-name = "MultiGridBarrierMPI"
+name = "HPCMultiGridBarrier"
 uuid = "abf18f27-d12f-4566-94ed-07bf0c385f70"
 authors = ["S. Loisel"]
 version = "0.1.1"
@@ -8,7 +8,7 @@ BenchmarkTools = "6e4b80f9-dd63-53aa-95a3-0cdb28fa8baf"
 CUDA = "052768ef-5323-5732-b1bb-66c8b64840ba"
 CUDSS_jll = "4889d778-9329-5762-9fec-0578a5d30366"
 LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
-HPCLinearAlgebra = "537374f1-5608-4525-82fb-641dce542540"
+HPCSparseArrays = "537374f1-5608-4525-82fb-641dce542540"
 MPI = "da04e1cc-30fd-572f-bb4f-1f8673147195"
 MPIPreferences = "3da0fdf6-3ccc-4f1b-acd9-58baa6c99267"
 Metal = "dde4c033-4e86-420c-a63e-0dd931031962"
@@ -20,13 +20,13 @@ StaticArrays = "90137ffa-7385-5640-81b9-e52037218182"
 Statistics = "10745b16-79ce-11e8-11f9-7d13ad32a3b2"
 
 [sources]
-HPCLinearAlgebra = {path = "../HPCLinearAlgebra.jl"}
+HPCSparseArrays = {path = "../HPCSparseArrays.jl"}
 
 [compat]
 BenchmarkTools = "1.6"
 CUDA = "5.9.6"
 CUDSS_jll = "0.7.1"
-HPCLinearAlgebra = "0.1"
+HPCSparseArrays = "0.1"
 MPI = "0.20"
 MPIPreferences = "0.1.11"
 Metal = "1.9.1"

README.md

@@ -1,23 +1,23 @@
-# MultiGridBarrierMPI.jl
+# HPCMultiGridBarrier.jl
 
-[![Stable](https://img.shields.io/badge/docs-stable-blue.svg)](https://sloisel.github.io/MultiGridBarrierMPI.jl/stable/)
-[![Dev](https://img.shields.io/badge/docs-dev-blue.svg)](https://sloisel.github.io/MultiGridBarrierMPI.jl/dev/)
-[![Build Status](https://github.com/sloisel/MultiGridBarrierMPI.jl/actions/workflows/CI.yml/badge.svg?branch=main)](https://github.com/sloisel/MultiGridBarrierMPI.jl/actions/workflows/CI.yml?query=branch%3Amain)
-[![codecov](https://codecov.io/gh/sloisel/MultiGridBarrierMPI.jl/branch/main/graph/badge.svg)](https://codecov.io/gh/sloisel/MultiGridBarrierMPI.jl)
+[![Stable](https://img.shields.io/badge/docs-stable-blue.svg)](https://sloisel.github.io/HPCMultiGridBarrier.jl/stable/)
+[![Dev](https://img.shields.io/badge/docs-dev-blue.svg)](https://sloisel.github.io/HPCMultiGridBarrier.jl/dev/)
+[![Build Status](https://github.com/sloisel/HPCMultiGridBarrier.jl/actions/workflows/CI.yml/badge.svg?branch=main)](https://github.com/sloisel/HPCMultiGridBarrier.jl/actions/workflows/CI.yml?query=branch%3Amain)
+[![codecov](https://codecov.io/gh/sloisel/HPCMultiGridBarrier.jl/branch/main/graph/badge.svg)](https://codecov.io/gh/sloisel/HPCMultiGridBarrier.jl)
 
 **Author:** S. Loisel
 
-A Julia package that bridges MultiGridBarrier.jl and HPCLinearAlgebra.jl for distributed multigrid barrier computations using native MPI types.
+A Julia package that bridges MultiGridBarrier.jl and HPCSparseArrays.jl for distributed multigrid barrier computations using native MPI types.
 
 ## Overview
 
-MultiGridBarrierMPI.jl extends the MultiGridBarrier.jl package to work with HPCLinearAlgebra.jl's distributed matrix and vector types. This enables efficient parallel computation of multigrid barrier methods across multiple MPI ranks without requiring PETSc.
+HPCMultiGridBarrier.jl extends the MultiGridBarrier.jl package to work with HPCSparseArrays.jl's distributed matrix and vector types. This enables efficient parallel computation of multigrid barrier methods across multiple MPI ranks without requiring PETSc.
 
 ## Key Features
 
 - **1D, 2D, and 3D Support**: Full support for 1D, 2D triangular, and 3D hexahedral finite elements
 - **Seamless Integration**: Drop-in replacement for MultiGridBarrier's native types
-- **Pure Julia MPI**: Uses HPCLinearAlgebra.jl for distributed linear algebra (no external libraries required)
+- **Pure Julia MPI**: Uses HPCSparseArrays.jl for distributed linear algebra (no external libraries required)
 - **Type Conversion**: Easy conversion between native Julia arrays and MPI distributed types
 - **MPI-Aware**: All operations correctly handle MPI collective requirements
 - **MUMPS Solver**: Uses MUMPS direct solver for accurate Newton iterations
@@ -30,14 +30,14 @@ Solve a 2D p-Laplace problem with distributed MPI types:
 using MPI
 MPI.Init()
 
-using MultiGridBarrierMPI
-using HPCLinearAlgebra
+using HPCMultiGridBarrier
+using HPCSparseArrays
 
 # Solve with MPI distributed types (L=3 refinement levels)
-sol_mpi = fem2d_mpi_solve(Float64; L=3, p=1.0, verbose=false)
+sol_hpc = fem2d_hpc_solve(Float64; L=3, p=1.0, verbose=false)
 
 # Convert to native types for visualization
-sol_native = mpi_to_native(sol_mpi)
+sol_native = hpc_to_native(sol_hpc)
 
 # Only rank 0 creates the plot
 rank = MPI.Comm_rank(MPI.COMM_WORLD)
@@ -60,21 +60,21 @@ mpiexec -n 4 julia --project example.jl
 
 ```julia
 using Pkg
-Pkg.add(url="https://github.com/sloisel/MultiGridBarrierMPI.jl")
+Pkg.add(url="https://github.com/sloisel/HPCMultiGridBarrier.jl")
 ```
 
 Or for development:
 
 ```bash
-git clone https://github.com/sloisel/MultiGridBarrierMPI.jl
-cd MultiGridBarrierMPI.jl
+git clone https://github.com/sloisel/HPCMultiGridBarrier.jl
+cd HPCMultiGridBarrier.jl
 julia --project -e 'using Pkg; Pkg.instantiate()'
 ```
 
 ## Running Tests
 
 ```bash
-cd MultiGridBarrierMPI.jl
+cd HPCMultiGridBarrier.jl
 mpiexec -n 2 julia --project test/runtests.jl
 ```
 
@@ -92,7 +92,7 @@ julia --project make.jl
 This package is part of a larger ecosystem:
 
 - **[MultiGridBarrier.jl](https://github.com/sloisel/MultiGridBarrier.jl)**: Core multigrid barrier method implementation
-- **[HPCLinearAlgebra.jl](https://github.com/sloisel/HPCLinearAlgebra.jl)**: Pure Julia distributed linear algebra with MPI
+- **[HPCSparseArrays.jl](https://github.com/sloisel/HPCSparseArrays.jl)**: Pure Julia distributed linear algebra with MPI
 - **MPI.jl**: Julia MPI bindings for distributed computing
 
 ## Requirements

docs/Project.toml

@@ -1,7 +1,7 @@
 [deps]
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 DocumenterTools = "35a29f4d-8980-5a13-9543-d66fff28ecb8"
-HPCLinearAlgebra = "537374f1-5608-4525-82fb-641dce542540"
+HPCSparseArrays = "537374f1-5608-4525-82fb-641dce542540"
 MultiGridBarrier = "9e2c1f1d-9131-4ad4-b32f-bd2a0b0ecd1e"
-MultiGridBarrierMPI = "abf18f27-d12f-4566-94ed-07bf0c385f70"
+HPCMultiGridBarrier = "abf18f27-d12f-4566-94ed-07bf0c385f70"
 

docs/make.jl

@@ -1,18 +1,18 @@
 using Documenter
-using MultiGridBarrierMPI
+using HPCMultiGridBarrier
 using Pkg
 
 # Compute version dynamically
-version = string(pkgversion(MultiGridBarrierMPI))
+version = string(pkgversion(HPCMultiGridBarrier))
 
 makedocs(;
-    modules=[MultiGridBarrierMPI],
+    modules=[HPCMultiGridBarrier],
     authors="Sebastien Loisel and contributors",
-    sitename="MultiGridBarrierMPI.jl $version",
+    sitename="HPCMultiGridBarrier.jl $version",
     format=Documenter.HTML(;
         prettyurls=get(ENV, "CI", "false") == "true",
-        canonical="https://sloisel.github.io/MultiGridBarrierMPI.jl",
-        repolink="https://github.com/sloisel/MultiGridBarrierMPI.jl",
+        canonical="https://sloisel.github.io/HPCMultiGridBarrier.jl",
+        repolink="https://github.com/sloisel/HPCMultiGridBarrier.jl",
         assets=String[],
     ),
     pages=[
@@ -21,11 +21,11 @@ makedocs(;
         "User Guide" => "guide.md",
         "API Reference" => "api.md",
     ],
-    repo=Documenter.Remotes.GitHub("sloisel", "MultiGridBarrierMPI.jl"),
+    repo=Documenter.Remotes.GitHub("sloisel", "HPCMultiGridBarrier.jl"),
     warnonly=true,  # Don't fail on warnings during development
 )
 
 deploydocs(;
-    repo="github.com/sloisel/MultiGridBarrierMPI.jl",
+    repo="github.com/sloisel/HPCMultiGridBarrier.jl",
     devbranch="main",
 )

docs/src/api.md

@@ -1,6 +1,6 @@
 # API Reference
 
-This page provides detailed documentation for all exported functions in MultiGridBarrierMPI.jl.
+This page provides detailed documentation for all exported functions in HPCMultiGridBarrier.jl.
 
 !!! note "All Functions Are Collective"
     All functions documented here are **MPI collective operations**. Every MPI rank must call these functions together with the same parameters. Failure to do so will result in deadlock.
@@ -12,32 +12,32 @@ These functions provide the simplest interface for solving problems with MPI typ
 ### 1D Problems
 
 ```@docs
-fem1d_mpi
-fem1d_mpi_solve
+fem1d_hpc
+fem1d_hpc_solve
 ```
 
 ### 2D Problems
 
 ```@docs
-fem2d_mpi
-fem2d_mpi_solve
+fem2d_hpc
+fem2d_hpc_solve
 ```
 
 ### 3D Problems
 
 ```@docs
-fem3d_mpi
-fem3d_mpi_solve
+fem3d_hpc
+fem3d_hpc_solve
 ```
 
 ## Type Conversion API
 
 These functions convert between native Julia types and MPI distributed types.
-The `mpi_to_native` function dispatches on type, handling `Geometry`, `AMGBSOL`, and `ParabolicSOL` objects.
+The `hpc_to_native` function dispatches on type, handling `Geometry`, `AMGBSOL`, and `ParabolicSOL` objects.
 
 ```@docs
-native_to_mpi
-mpi_to_native
+native_to_hpc
+hpc_to_native
 ```
 
 ## Type Mappings Reference
@@ -104,12 +104,12 @@ The `AMGBSOL` type from MultiGridBarrier contains the complete solution:
 
 ## MPI and IO Utilities
 
-### HPCLinearAlgebra.io0()
+### HPCSparseArrays.io0()
 
 Returns an IO stream that only writes on rank 0:
 
 ```julia
-using HPCLinearAlgebra
+using HPCSparseArrays
 
 println(io0(), "This prints once from rank 0")
 ```
@@ -131,23 +131,23 @@ nranks = MPI.Comm_size(MPI.COMM_WORLD)  # Total number of ranks
 using MPI
 MPI.Init()
 
-using MultiGridBarrierMPI
-using HPCLinearAlgebra
+using HPCMultiGridBarrier
+using HPCSparseArrays
 using MultiGridBarrier
 using LinearAlgebra
 
 # Create native geometry
 g_native = fem2d(; L=2)
 
 # Convert to MPI
-g_mpi = native_to_mpi(g_native)
+g_hpc = native_to_hpc(g_native)
 
 # Solve with MPI types
-sol_mpi = amgb(g_mpi; p=2.0)
+sol_hpc = amgb(g_hpc; p=2.0)
 
 # Convert back to native
-sol_native = mpi_to_native(sol_mpi)
-g_back = mpi_to_native(g_mpi)
+sol_native = hpc_to_native(sol_hpc)
+g_back = hpc_to_native(g_hpc)
 
 # Verify round-trip accuracy
 @assert norm(g_native.x - g_back.x) < 1e-10
@@ -162,8 +162,8 @@ g_native = fem2d(; L=2)
 id_native = g_native.operators[:id]  # SparseMatrixCSC
 
 # MPI geometry
-g_mpi = native_to_mpi(g_native)
-id_mpi = g_mpi.operators[:id]  # HPCSparseMatrix
+g_hpc = native_to_hpc(g_native)
+id_mpi = g_hpc.operators[:id]  # HPCSparseMatrix
 
 # Convert back if needed
 id_back = SparseMatrixCSC(id_mpi)  # SparseMatrixCSC
@@ -177,7 +177,7 @@ All MultiGridBarrier functions work seamlessly with MPI types:
 using MultiGridBarrier: amgb
 
 # Create MPI geometry
-g = fem2d_mpi(Float64; L=3)
+g = fem2d_hpc(Float64; L=3)
 
 # Use MultiGridBarrier functions directly
 sol = amgb(g; p=1.0, verbose=true)