Merge pull request #7 from awslabs/sjg/release-0.11.0

Release v0.11.0

Author: sebastiangrimberg

CHANGELOG.md

@@ -11,8 +11,9 @@ The format of this changelog is based on
 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to
 [Semantic Versioning](https://semver.org/).
 
-## In progress
+## [0.11.0] - 2023-01-26
 
+  - Initial public release on GitHub.
   - Added support for anisotropic materials through the use of `"MaterialAxes"` under
     `"Materials"`. These material axes allow for specifying symmetric material property
     tensors through a sum of weighted outer products of normal vectors. This can be used in
@@ -43,7 +44,7 @@ The format of this changelog is based on
     to check a provided configuration file against the schema.
   - Added optional interface to GSLIB library which enables `"Probe"` functionality to
     sample the computed electric and magnetic fields at points in space.
-  - Added support for builds using Spack. This includes an option in the build system for
+  - Prepared to support builds using Spack. This includes an option in the build system for
     user-supplied dependencies as an alternative to the superbuild configuration.
   - Updated submodules for superbuild, fixing a bug in SuperLU_DIST solver causing
     communication hangs for certain numbers of processors.
@@ -140,8 +141,8 @@ The format of this changelog is based on
   - Added finite conductivity surface impedance boundary condition, with optional thickness
     correction.
   - Added dielectric loss calculation specializations for metal-air, metal-substrate, and
-    substrate-air interfaces in accordance with [this paper]
-    (https://aip.scitation.org/doi/10.1063/1.3637047).
+    substrate-air interfaces in accordance with
+    [this paper](https://aip.scitation.org/doi/10.1063/1.3637047).
   - Changed implementation of frequency domain linear algebra to eliminate the use of PETSc
     matrix types, relying instead on wrappers of the real and imaginary Hypre matrices
     making up a complex operator.

CMakeLists.txt

@@ -14,7 +14,7 @@ if("${CMAKE_SOURCE_DIR}" STREQUAL "${CMAKE_BINARY_DIR}")
 endif()
 
 # Initialize the project
-project(palace-superbuild LANGUAGES CXX C VERSION 0.10.0)
+project(palace-superbuild LANGUAGES CXX C VERSION 0.11.0)
 
 # Define build settings and defaults
 set(PALACE_WITH_64BIT_INT OFF CACHE BOOL "Use 64 bit integers")

README.md

@@ -10,9 +10,9 @@ SPDX-License-Identifier: Apache-2.0
 [![](https://img.shields.io/badge/docs-dev-blue.svg)](https://awslabs.github.io/palace/dev)
 
 *Palace*, for **PA**rallel **LA**rge-scale **C**omputational **E**lectromagnetics, is an
-open-source parallel finite element code for full-wave 3D electromagnetic simulations in
-the frequency or time domain, using the [MFEM](http://mfem.org) finite element
-discretization library.
+open-source, parallel finite element code for full-wave 3D electromagnetic simulations in
+the frequency or time domain, using the
+[MFEM finite element discretization library](http://mfem.org).
 
 ## Key features
 
@@ -37,7 +37,7 @@ discretization library.
 
 ## Getting started
 
-*Palace* can be installed using the [Spack](https://spack.io/) HPC package manager, with the
+*Palace* can be installed using the [Spack HPC package manager](https://spack.io/), with the
 command `spack install palace`. Run `spack info palace` to get more information about the
 available configuration options and dependencies.
 

cmake/extern/ExternalGitTags.cmake

@@ -35,7 +35,7 @@ set(EXTERN_METIS_GIT_TAG
   "Git tag for external METIS build"
 )
 set(EXTERN_MUMPS_GIT_TAG
-  "38bf3b3f598d983a630cb7d62561c140c27e7019" CACHE STRING  # 01/26/2023
+  "e478370809c46add2a8f148d83ab4881154c0809" CACHE STRING  # 01/26/2023
   "Git tag for external MUMPS build"
 )
 set(EXTERN_PARMETIS_GIT_TAG

docs/make.jl

@@ -45,4 +45,9 @@ makedocs(
     ]
 )
 
-deploydocs(repo="github.com/awslabs/palace.git", devbranch="main", push_preview=true)
+deploydocs(
+    repo="github.com/awslabs/palace.git",
+    devbranch="main",
+    push_preview=true,
+    forcepush=true
+)

docs/src/index.md

@@ -6,9 +6,9 @@
 # Palace: 3D Finite Element Solver for Computational Electromagnetics
 
 *Palace*, for **PA**rallel **LA**rge-scale **C**omputational **E**lectromagnetics, is an
-open-source parallel finite element code for full-wave 3D electromagnetic simulations in
-the frequency or time domain, using the [MFEM](http://mfem.org) finite element
-discretization library.
+open-source, parallel finite element code for full-wave 3D electromagnetic simulations in
+the frequency or time domain, using the [MFEM finite element discretization library]
+(http://mfem.org).
 
 ## Key features
 

docs/src/install.md

@@ -5,8 +5,8 @@
 
 # Installation
 
-*Palace* can be built and installed using the [Spack](https://spack.io/) HPC package
-manager, following the instructions in the [Build using Spack]
+*Palace* can be built and installed using the [Spack HPC package manager]
+(https://spack.io/), following the instructions in the [Build using Spack]
 (#Build-using-Spack) section. Alternatively, compiling from source using [CMake]
 (https://cmake.org/download) is described in [Build from source](#Build-from-source).
 
@@ -146,7 +146,7 @@ as the standard parallelization in approach in *Palace* is to use pure MPI paral
 
 ## Dependencies
 
-*Palace* leverages the [MFEM](http://mfem.org) finite element discretization library. It
+*Palace* leverages the [MFEM finite element discretization library](http://mfem.org). It
 always configures and builds its own installation of MFEM internally in order to support
 the most up to date features and patches. In addition, *Palace* uses:
 

examples/cpw/cpw_lumped_adaptive.json

@@ -26,7 +26,7 @@
       },
       {
         "Attributes": [1],  // Sapphire
-        "Permeability": [ 0.99999975, 0.99999975, 0.99999979],
+        "Permeability": [0.99999975, 0.99999975, 0.99999979],
         "Permittivity": [9.3, 9.3, 11.5],
         "LossTan": [3.0e-5, 3.0e-5, 8.6e-5],
         "MaterialAxes": [[0.8, 0.6, 0.0], [-0.6, 0.8, 0.0], [0.0, 0.0, 1.0]]

examples/cpw/cpw_lumped_uniform.json

@@ -26,7 +26,7 @@
       },
       {
         "Attributes": [1],  // Sapphire
-        "Permeability": [ 0.99999975, 0.99999975, 0.99999979],
+        "Permeability": [0.99999975, 0.99999975, 0.99999979],
         "Permittivity": [9.3, 9.3, 11.5],
         "LossTan": [3.0e-5, 3.0e-5, 8.6e-5],
         "MaterialAxes": [[0.8, 0.6, 0.0], [-0.6, 0.8, 0.0], [0.0, 0.0, 1.0]]

examples/cpw/cpw_wave_adaptive.json

@@ -26,7 +26,7 @@
       },
       {
         "Attributes": [1],  // Sapphire
-        "Permeability": [ 0.99999975, 0.99999975, 0.99999979],
+        "Permeability": [0.99999975, 0.99999975, 0.99999979],
         "Permittivity": [9.3, 9.3, 11.5],
         "LossTan": [3.0e-5, 3.0e-5, 8.6e-5],
         "MaterialAxes": [[0.8, 0.6, 0.0], [-0.6, 0.8, 0.0], [0.0, 0.0, 1.0]]

examples/cpw/cpw_wave_uniform.json

@@ -26,7 +26,7 @@
       },
       {
         "Attributes": [1],  // Sapphire
-        "Permeability": [ 0.99999975, 0.99999975, 0.99999979],
+        "Permeability": [0.99999975, 0.99999975, 0.99999979],
         "Permittivity": [9.3, 9.3, 11.5],
         "LossTan": [3.0e-5, 3.0e-5, 8.6e-5],
         "MaterialAxes": [[0.8, 0.6, 0.0], [-0.6, 0.8, 0.0], [0.0, 0.0, 1.0]]

extern/mumps

@@ -43,10 +43,10 @@ index 5a83b9b..037f707 100644
 -include(cmake/install.cmake)
 diff --git a/cmake/FindLAPACK.cmake b/cmake/FindLAPACK.cmake
 deleted file mode 100644
-index 2016c7c..0000000
+index 35395c6..0000000
 --- a/cmake/FindLAPACK.cmake
 +++ /dev/null
-@@ -1,571 +0,0 @@
+@@ -1,591 +0,0 @@
 -# Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
 -# file Copyright.txt or https://cmake.org/licensing for details.
 -
@@ -302,14 +302,34 @@ index 2016c7c..0000000
 -
 -function(aocl_libs)
 -
+-set(_names flame)
+-if(WIN32)
+-  if(BUILD_SHARED_LIBS)
+-    list(APPEND _names AOCL-LibFlame-Win-MT-dll AOCL-LibFlame-Win-dll)
+-  else()
+-    list(APPEND _names AOCL-LibFlame-Win-MT AOCL-LibFlame-Win)
+-  endif()
+-endif()
+-
 -find_library(LAPACK_LIBRARY
--NAMES flame AOCL-LibFLAME-Win-MT-dll AOCL-LibFLAME-Win
+-NAMES ${_names}
+-NAMES_PER_DIR
 -PATH_SUFFIXES LP64
 -DOC "LAPACK Flame library"
 -)
 -
+-set(_names blis-mt blis)
+-if(WIN32)
+-  if(BUILD_SHARED_LIBS)
+-    list(APPEND _names AOCL-LibBlis-Win-MT-dll AOCL-LibBlis-Win-dll)
+-  else()
+-    list(APPEND _names AOCL-LibBlis-Win-MT AOCL-LibBlis-Win)
+-  endif()
+-endif()
+-
 -find_library(BLAS_LIBRARY
--NAMES blis-mt blis AOCL-LibBlis-Win-MT-dll
+-NAMES ${_names}
+-NAMES_PER_DIR
 -PATH_SUFFIXES LP64
 -DOC "BLAS Blis library"
 -)
@@ -620,10 +640,10 @@ index 2016c7c..0000000
 -mark_as_advanced(LAPACK_LIBRARY LAPACK_INCLUDE_DIR)
 diff --git a/cmake/FindSCALAPACK.cmake b/cmake/FindSCALAPACK.cmake
 deleted file mode 100644
-index 47543a1..0000000
+index e93337f..0000000
 --- a/cmake/FindSCALAPACK.cmake
 +++ /dev/null
-@@ -1,301 +0,0 @@
+@@ -1,315 +0,0 @@
 -# Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
 -# file Copyright.txt or https://cmake.org/licensing for details.
 -
@@ -810,6 +830,37 @@ index 47543a1..0000000
 -
 -endfunction(scalapack_mkl)
 -
+-
+-function(scalapack_lib)
+-
+-if(BUILD_SHARED_LIBS)
+-  set(_s shared)
+-else()
+-  set(_s static)
+-endif()
+-list(APPEND _s openmpi/lib mpich/lib)
+-
+-find_library(SCALAPACK_LIBRARY
+-NAMES scalapack scalapack-openmpi scalapack-mpich
+-NAMES_PER_DIR
+-PATH_SUFFIXES ${_s}
+-DOC "SCALAPACK library"
+-)
+-
+-# some systems have libblacs as a separate file, instead of being subsumed in libscalapack.
+-if(NOT DEFINED BLACS_ROOT)
+-  get_filename_component(BLACS_ROOT ${SCALAPACK_LIBRARY} DIRECTORY)
+-endif()
+-
+-find_library(BLACS_LIBRARY
+-NAMES blacs
+-NO_DEFAULT_PATH
+-HINTS ${BLACS_ROOT}
+-DOC "BLACS library"
+-)
+-
+-endfunction(scalapack_lib)
+-
 -# === main
 -
 -set(scalapack_cray false)
@@ -855,24 +906,7 @@ index 47543a1..0000000
 -elseif(scalapack_cray)
 -  # Cray PE has Scalapack build into LibSci. Use Cray compiler wrapper.
 -else()
--
--  find_library(SCALAPACK_LIBRARY
--  NAMES scalapack scalapack-openmpi scalapack-mpich
--  NAMES_PER_DIR
--  PATH_SUFFIXES openmpi/lib mpich/lib
--  DOC "SCALAPACK library"
--  )
--
--  # some systems have libblacs as a separate file, instead of being subsumed in libscalapack.
--  get_filename_component(BLACS_ROOT ${SCALAPACK_LIBRARY} DIRECTORY)
--
--  find_library(BLACS_LIBRARY
--  NAMES blacs
--  NO_DEFAULT_PATH
--  HINTS ${BLACS_ROOT}
--  DOC "BLACS library"
--  )
--
+-  scalapack_lib()
 -endif()
 -
 -if(STATIC IN_LIST SCALAPACK_FIND_COMPONENTS)
@@ -926,7 +960,7 @@ index 47543a1..0000000
 -
 -mark_as_advanced(SCALAPACK_LIBRARY SCALAPACK_INCLUDE_DIR)
 diff --git a/cmake/lapack.cmake b/cmake/lapack.cmake
-index a01dbf9..4e2c75e 100644
+index d4e6336..e565d0e 100644
 --- a/cmake/lapack.cmake
 +++ b/cmake/lapack.cmake
 @@ -2,38 +2,13 @@
@@ -968,7 +1002,7 @@ index a01dbf9..4e2c75e 100644
 -endif()
 +set(CMAKE_REQUIRED_LIBRARIES ${LAPACK_LIBRARIES})
 
- if(BUILD_DOUBLE AND BLAS_HAVE_GEMMT)
+ if(BUILD_DOUBLE)
  check_fortran_source_compiles(
 diff --git a/cmake/options.cmake b/cmake/options.cmake
 index 57572cd..29ae9a3 100644

extern/patch/mumps/patch_build.diff

@@ -19,7 +19,7 @@ set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_EXTENSIONS OFF)
 
 # Initialize the project
-project(palace LANGUAGES CXX VERSION 0.10.0)
+project(palace LANGUAGES CXX VERSION 0.11.0)
 
 # Define build settings and defaults
 set(PALACE_WITH_OPENMP OFF CACHE BOOL "Use OpenMP")