From a45e043b0e002bc3e95d5e3ffc3f9316cc2ff42e Mon Sep 17 00:00:00 2001 From: gloges Date: Sat, 14 Nov 2026 17:48:15 -0500 Subject: [PATCH 1/7] basic structure --- .../SpaceAndTime/WaveVectorSpace/API-map.md | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 Physlib/SpaceAndTime/WaveVectorSpace/API-map.md diff --git a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md new file mode 100644 index 0000000000..110b5dbe02 --- /dev/null +++ b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md @@ -0,0 +1,27 @@ +# Wavevector space + +## Abstract (Alpha) + +## Content (Alpha) + +### Wavevectors and their basic structure + +A wavevector is identified by its $d$ real coordinates. [1] +Wavevector space has a distinguished zero and is a vector space over the reals: +wavevectors may be added, subtracted and multiplied by real numbers. [2] +It has both a norm and inner product structure with which it is isometric +to standard $d$-dimensional Euclidean space. [3] +It has an orthonormal set of basis vectors, and for each basis vector +there is a corresponding coordinate function given by orthogonal projection. [4] +Wavevectors carry units of inverse-length and are rescaled +under a change of inverse-length unit. [TODO] + +## Lean References + +1. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `WaveVectorSpace` +2. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `instZero`, `instRealModule` +3. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `instNormedAddCommGroup`, + `instInnerProductReal`, `equivEuclideanSpace` +4. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `basis`, `coord`, `coordCLM` + +## References From 8943d3a445aa526a987b6da93f26bb5954552e32 Mon Sep 17 00:00:00 2001 From: gloges Date: Sat, 14 Nov 2026 21:37:31 -0500 Subject: [PATCH 2/7] derivatives --- Physlib/SpaceAndTime/WaveVectorSpace/API-map.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md index 110b5dbe02..d163ef9e4b 100644 --- a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md +++ b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md @@ -16,6 +16,13 @@ there is a corresponding coordinate function given by orthogonal projection. [4] Wavevectors carry units of inverse-length and are rescaled under a change of inverse-length unit. [TODO] +### Derivatives + +Functions from wavevector space into a normed space can be differentiated along +the coordinate directions; the partial derivatives satisfy the usual linearity properties, +product rule and power rule. [5] +The gradient, divergence, laplacian and curl for functions of wavevector are defined. [TODO] + ## Lean References 1. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `WaveVectorSpace` @@ -23,5 +30,7 @@ under a change of inverse-length unit. [TODO] 3. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `instNormedAddCommGroup`, `instInnerProductReal`, `equivEuclideanSpace` 4. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `basis`, `coord`, `coordCLM` +5. Physlib/SpaceAndTime/WaveVectorSpace/Derivatives/Basic.lean — `deriv`, `deriv_add`, + `deriv_const_smul`, `deriv_smul`, `deriv_pow` ## References From a1bda6509c1b94f6d6f83655da6ec10791c9290f Mon Sep 17 00:00:00 2001 From: gloges Date: Sat, 14 Nov 2026 21:38:05 -0500 Subject: [PATCH 3/7] duality --- Physlib/SpaceAndTime/WaveVectorSpace/API-map.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md index d163ef9e4b..36bbc2bab9 100644 --- a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md +++ b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md @@ -23,6 +23,16 @@ the coordinate directions; the partial derivatives satisfy the usual linearity p product rule and power rule. [5] The gradient, divergence, laplacian and curl for functions of wavevector are defined. [TODO] +### Duality with Space + +There is a natural pairing of wavevector space with spatial displacements in Space {1}: +for a given wavevector $k$ and point in space $x$ the pairing $k\cdot x = \sum_i k_ix^i$ +gives the phase difference relative to some fixed reference point. [6] +Fixing a wavevector $k$ gives its dual functional $x \mapsto k\cdot x$ on space and similarly +fixing a displacement $x$ gives its dual functional $k \mapsto k\cdot x$ on wavevector space. [7] +Changing the reference point changes the phase at all points in space by the same amount. [TODO] + + ## Lean References 1. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `WaveVectorSpace` @@ -32,5 +42,9 @@ The gradient, divergence, laplacian and curl for functions of wavevector are def 4. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `basis`, `coord`, `coordCLM` 5. Physlib/SpaceAndTime/WaveVectorSpace/Derivatives/Basic.lean — `deriv`, `deriv_add`, `deriv_const_smul`, `deriv_smul`, `deriv_pow` +6. Physlib/SpaceAndTime/WaveVectorSpace/DualPairing.lean — `pairingCLM` +7. Physlib/SpaceAndTime/WaveVectorSpace/DualPairing.lean — `WaveVectorSpace.dual`, `Space.dual` ## References + +1. Space API map — Physlib/SpaceAndTime/Space/API-map.md From 5bb015863902a6b291a41d4ab93acb2369b97017 Mon Sep 17 00:00:00 2001 From: gloges Date: Sat, 14 Nov 2026 21:48:27 -0500 Subject: [PATCH 4/7] fourier --- Physlib/SpaceAndTime/WaveVectorSpace/API-map.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md index 36bbc2bab9..1c228eef2c 100644 --- a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md +++ b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md @@ -32,6 +32,15 @@ Fixing a wavevector $k$ gives its dual functional $x \mapsto k\cdot x$ on space fixing a displacement $x$ gives its dual functional $k \mapsto k\cdot x$ on wavevector space. [7] Changing the reference point changes the phase at all points in space by the same amount. [TODO] +### Fourier transforms + +The Fourier transform takes a suitably nice function of space to a function of wavevector, +resolving its spatial dependence into plane-wave components. The inverse Fourier transform +reconstructs the spatial function from those components. [8] +The transform and its inverse have a consistent choice of normalization, +and preserve inner products up to the corresponding normalization factor. [TODO] +The Fourier transform maps derivatives with respect to space to multiplication by wavevector +and *vice versa*, under suitable regularity and decay assumptions. [TODO] ## Lean References @@ -44,6 +53,7 @@ Changing the reference point changes the phase at all points in space by the sam `deriv_const_smul`, `deriv_smul`, `deriv_pow` 6. Physlib/SpaceAndTime/WaveVectorSpace/DualPairing.lean — `pairingCLM` 7. Physlib/SpaceAndTime/WaveVectorSpace/DualPairing.lean — `WaveVectorSpace.dual`, `Space.dual` +8. Physlib/SpaceAndTime/WaveVectorSpace/Fourier.lean — `fourierIntegral`, `fourierIntegralInv` ## References From 21b125827aeeec2005d59bfd879e0eb2d4097147 Mon Sep 17 00:00:00 2001 From: gloges Date: Sat, 14 Nov 2026 21:53:02 -0500 Subject: [PATCH 5/7] abstract --- Physlib/SpaceAndTime/WaveVectorSpace/API-map.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md index 1c228eef2c..89833a55b4 100644 --- a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md +++ b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md @@ -2,6 +2,14 @@ ## Abstract (Alpha) +A wavevector describes the spatial variation of a wave’s phase. +Wavevectors form a real vector space, equipped with a norm and an inner product, +in which functions of wavevector can be differentiated. +Physically, wavevector space is reciprocal to position space: +a wavevector pairs with a spatial displacement to give a phase difference. +This pairing connects wavevectors to plane waves and to the Fourier transform, +which expresses a spatial field in terms of its wavevector components. + ## Content (Alpha) ### Wavevectors and their basic structure @@ -21,7 +29,7 @@ under a change of inverse-length unit. [TODO] Functions from wavevector space into a normed space can be differentiated along the coordinate directions; the partial derivatives satisfy the usual linearity properties, product rule and power rule. [5] -The gradient, divergence, laplacian and curl for functions of wavevector are defined. [TODO] +The gradient, divergence, laplacian and curl are defined for functions of wavevector. [TODO] ### Duality with Space From 9d8ebd6817e2fcabb8d7f2e6900106144dba5858 Mon Sep 17 00:00:00 2001 From: gloges Date: Sat, 14 Nov 2026 22:01:05 -0500 Subject: [PATCH 6/7] fix instance names --- Physlib/SpaceAndTime/WaveVectorSpace/API-map.md | 4 ++-- Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md index 89833a55b4..aa82806bd3 100644 --- a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md +++ b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md @@ -53,9 +53,9 @@ and *vice versa*, under suitable regularity and decay assumptions. [TODO] ## Lean References 1. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `WaveVectorSpace` -2. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `instZero`, `instRealModule` +2. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `instZero`, `instModuleReal` 3. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `instNormedAddCommGroup`, - `instInnerProductReal`, `equivEuclideanSpace` + `instInnerProductSpaceReal`, `equivEuclideanSpace` 4. Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean — `basis`, `coord`, `coordCLM` 5. Physlib/SpaceAndTime/WaveVectorSpace/Derivatives/Basic.lean — `deriv`, `deriv_add`, `deriv_const_smul`, `deriv_smul`, `deriv_pow` diff --git a/Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean b/Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean index f088719b0e..f356025cbb 100644 --- a/Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean +++ b/Physlib/SpaceAndTime/WaveVectorSpace/Basic.lean @@ -108,7 +108,7 @@ instance : Subsingleton (WaveVectorSpace 0) where ### B.3. Zero -/ -instance : Zero (WaveVectorSpace d) where +instance instZero : Zero (WaveVectorSpace d) where zero := ⟨0⟩ @[simp] From e5b2d2df32ff5e28fdd328ad5c8cd01d699a93a0 Mon Sep 17 00:00:00 2001 From: gloges Date: Mon, 16 Nov 2026 09:42:09 -0500 Subject: [PATCH 7/7] minor changes --- Physlib/SpaceAndTime/WaveVectorSpace/API-map.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md index aa82806bd3..57dbaf982a 100644 --- a/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md +++ b/Physlib/SpaceAndTime/WaveVectorSpace/API-map.md @@ -43,9 +43,9 @@ Changing the reference point changes the phase at all points in space by the sam ### Fourier transforms The Fourier transform takes a suitably nice function of space to a function of wavevector, -resolving its spatial dependence into plane-wave components. The inverse Fourier transform +resolving its spatial dependence into plane-wave components; the inverse Fourier transform reconstructs the spatial function from those components. [8] -The transform and its inverse have a consistent choice of normalization, +The transform and its inverse have a consistent choice of normalization and preserve inner products up to the corresponding normalization factor. [TODO] The Fourier transform maps derivatives with respect to space to multiplication by wavevector and *vice versa*, under suitable regularity and decay assumptions. [TODO]