Fiber bundles #
Mathematically, a (topological) fiber bundle with fiber F
over a base B
is a space projecting on
B
for which the fibers are all homeomorphic to F
, such that the local situation around each
point is a direct product.
In our formalism, a fiber bundle is by definition the type Bundle.TotalSpace F E
where
E : B → Type*
is a function associating to x : B
the fiber over x
. This type
Bundle.TotalSpace F E
is a type of pairs ⟨proj : B, snd : E proj⟩
.
To have a fiber bundle structure on Bundle.TotalSpace F E
, one should
additionally have the following data:
F
should be a topological space;- There should be a topology on
Bundle.TotalSpace F E
, for which the projection toB
is a fiber bundle with fiberF
(in particular, each fiberE x
is homeomorphic toF
); - For each
x
, the fiberE x
should be a topological space, and the injection fromE x
toBundle.TotalSpace F E
should be an embedding; - There should be a distinguished set of bundle trivializations, the "trivialization atlas"
- There should be a choice of bundle trivialization at each point, which belongs to this atlas.
If all these conditions are satisfied, we register the typeclass FiberBundle F E
.
It is in general nontrivial to construct a fiber bundle. A way is to start from the knowledge of
how changes of local trivializations act on the fiber. From this, one can construct the total space
of the bundle and its topology by a suitable gluing construction. The main content of this file is
an implementation of this construction: starting from an object of type
FiberBundleCore
registering the trivialization changes, one gets the corresponding
fiber bundle and projection.
Similarly we implement the object FiberPrebundle
which allows to define a topological
fiber bundle from trivializations given as partial equivalences with minimum additional properties.
Main definitions #
Basic definitions #
FiberBundle F E
: Structure saying thatE : B → Type*
is a fiber bundle with fiberF
.
Construction of a bundle from trivializations #
Bundle.TotalSpace F E
is the type of pairs(proj : B, snd : E proj)
. We can use the extra argumentF
to construct topology on the total space.FiberBundleCore ι B F
: structure registering how changes of coordinates act on the fiberF
above open subsets ofB
, where local trivializations are indexed byι
.
Let Z : FiberBundleCore ι B F
. Then we define
Z.Fiber x
: the fiber abovex
, homeomorphic toF
(and defeq toF
as a type).Z.TotalSpace
: the total space ofZ
, defined asBundle.TotalSpace F Z.Fiber
with a custom topology.Z.proj
: projection fromZ.TotalSpace
toB
. It is continuous.Z.localTriv i
: fori : ι
, bundle trivialization above the setZ.baseSet i
, which is an open set inB
.FiberPrebundle F E
: structure registering a cover of prebundle trivializations and requiring that the relative transition maps are partial homeomorphisms.FiberPrebundle.totalSpaceTopology a
: natural topology of the total space, making the prebundle into a bundle.
Implementation notes #
Data vs mixins #
For both fiber and vector bundles, one faces a choice: should the definition state the existence of local trivializations (a propositional typeclass), or specify a fixed atlas of trivializations (a typeclass containing data)?
In their initial mathlib implementations, both fiber and vector bundles were defined
propositionally. For vector bundles, this turns out to be mathematically wrong: in infinite
dimension, the transition function between two trivializations is not automatically continuous as a
map from the base B
to the endomorphisms F →L[R] F
of the fiber (considered with the
operator-norm topology), and so the definition needs to be modified by restricting consideration to
a family of trivializations (constituting the data) which are all mutually-compatible in this sense.
The PRs https://github.com/leanprover-community/mathlib4/pull/13052 and https://github.com/leanprover-community/mathlib4/pull/13175 implemented this change.
There is still the choice about whether to hold this data at the level of fiber bundles or of vector
bundles. As of PR https://github.com/leanprover-community/mathlib4/pull/17505, the data is all held in FiberBundle
, with VectorBundle
a
(propositional) mixin stating fiberwise-linearity.
This allows bundles to carry instances of typeclasses in which the scalar field, R
, does not
appear as a parameter. Notably, we would like a vector bundle over R
with fiber F
over base B
to be a ChartedSpace (B × F)
, with the trivializations providing the charts. This would be a
dangerous instance for typeclass inference, because R
does not appear as a parameter in
ChartedSpace (B × F)
. But if the data of the trivializations is held in FiberBundle
, then a
fiber bundle with fiber F
over base B
can be a ChartedSpace (B × F)
, and this is safe for
typeclass inference.
We expect that this choice of definition will also streamline constructions of fiber bundles with similar underlying structure (e.g., the same bundle being both a real and complex vector bundle).
Core construction #
A fiber bundle with fiber F
over a base B
is a family of spaces isomorphic to F
,
indexed by B
, which is locally trivial in the following sense: there is a covering of B
by open
sets such that, on each such open set s
, the bundle is isomorphic to s × F
.
To construct a fiber bundle formally, the main data is what happens when one changes trivializations
from s × F
to s' × F
on s ∩ s'
: one should get a family of homeomorphisms of F
, depending
continuously on the base point, satisfying basic compatibility conditions (cocycle property).
Useful classes of bundles can then be specified by requiring that these homeomorphisms of F
belong to some subgroup, preserving some structure (the "structure group of the bundle"): then
these structures are inherited by the fibers of the bundle.
Given such trivialization change data (encoded below in a structure called
FiberBundleCore
), one can construct the fiber bundle. The intrinsic canonical
mathematical construction is the following.
The fiber above x
is the disjoint union of F
over all trivializations, modulo the gluing
identifications: one gets a fiber which is isomorphic to F
, but non-canonically
(each choice of one of the trivializations around x
gives such an isomorphism). Given a
trivialization over a set s
, one gets an isomorphism between s × F
and proj^{-1} s
, by using
the identification corresponding to this trivialization. One chooses the topology on the bundle that
makes all of these into homeomorphisms.
For the practical implementation, it turns out to be more convenient to avoid completely the
gluing and quotienting construction above, and to declare above each x
that the fiber is F
,
but thinking that it corresponds to the F
coming from the choice of one trivialization around x
.
This has several practical advantages:
- without any work, one gets a topological space structure on the fiber. And if
F
has more structure it is inherited for free by the fiber. - In the case of the tangent bundle of manifolds, this implies that on vector spaces the derivative
(from
F
toF
) and the manifold derivative (fromTangentSpace I x
toTangentSpace I' (f x)
) are equal.
A drawback is that some silly constructions will typecheck: in the case of the tangent bundle, one
can add two vectors in different tangent spaces (as they both are elements of F
from the point of
view of Lean). To solve this, one could mark the tangent space as irreducible, but then one would
lose the identification of the tangent space to F
with F
. There is however a big advantage of
this situation: even if Lean can not check that two basepoints are defeq, it will accept the fact
that the tangent spaces are the same. For instance, if two maps f
and g
are locally inverse to
each other, one can express that the composition of their derivatives is the identity of
TangentSpace I x
. One could fear issues as this composition goes from TangentSpace I x
to
TangentSpace I (g (f x))
(which should be the same, but should not be obvious to Lean
as it does not know that g (f x) = x
). As these types are the same to Lean (equal to F
), there
are in fact no dependent type difficulties here!
For this construction of a fiber bundle from a FiberBundleCore
, we should thus
choose for each x
one specific trivialization around it. We include this choice in the definition
of the FiberBundleCore
, as it makes some constructions more
functorial and it is a nice way to say that the trivializations cover the whole space B
.
With this definition, the type of the fiber bundle space constructed from the core data is
Bundle.TotalSpace F (fun b : B ↦ F)
, but the topology is not the product one, in general.
We also take the indexing type (indexing all the trivializations) as a parameter to the fiber bundle
core: it could always be taken as a subtype of all the maps from open subsets of B
to continuous
maps of F
, but in practice it will sometimes be something else. For instance, on a manifold, one
will use the set of charts as a good parameterization for the trivializations of the tangent bundle.
Or for the pullback of a FiberBundleCore
, the indexing type will be the same as
for the initial bundle.
Tags #
Fiber bundle, topological bundle, structure group
General definition of fiber bundles #
A (topological) fiber bundle with fiber F
over a base B
is a space projecting on B
for which the fibers are all homeomorphic to F
, such that the local situation around each point
is a direct product.
- totalSpaceMk_isInducing' (b : B) : Topology.IsInducing (Bundle.TotalSpace.mk b)
- trivializationAtlas' : Set (Trivialization F Bundle.TotalSpace.proj)
- trivializationAt' : B → Trivialization F Bundle.TotalSpace.proj
- mem_baseSet_trivializationAt' (b : B) : b ∈ (FiberBundle.trivializationAt' b).baseSet
- trivialization_mem_atlas' (b : B) : FiberBundle.trivializationAt' b ∈ FiberBundle.trivializationAtlas'
Instances
Alias of FiberBundle.totalSpaceMk_isInducing
.
Atlas of a fiber bundle.
Equations
- trivializationAtlas F E = FiberBundle.trivializationAtlas'
Instances For
Trivialization of a fiber bundle at a point.
Equations
Instances For
Given a type E
equipped with a fiber bundle structure, this is a Prop
typeclass
for trivializations of E
, expressing that a trivialization is in the designated atlas for the
bundle. This is needed because lemmas about the linearity of trivializations or the continuity (as
functions to F →L[R] F
, where F
is the model fiber) of the transition functions are only
expected to hold for trivializations in the designated atlas.
- out : e ∈ trivializationAtlas F E
Instances
The projection from a fiber bundle to its base is continuous.
The projection from a fiber bundle to its base is an open map.
The projection from a fiber bundle with a nonempty fiber to its base is a surjective map.
The projection from a fiber bundle with a nonempty fiber to its base is a quotient map.
Alias of FiberBundle.isQuotientMap_proj
.
The projection from a fiber bundle with a nonempty fiber to its base is a quotient map.
Alias of FiberBundle.totalSpaceMk_isEmbedding
.
Characterization of continuous functions (at a point, within a set) into a fiber bundle.
Characterization of continuous functions (at a point) into a fiber bundle.
If E
is a fiber bundle over a conditionally complete linear order,
then it is trivial over any closed interval.
Core construction for constructing fiber bundles #
Core data defining a locally trivial bundle with fiber F
over a topological
space B
. Note that "bundle" is used in its mathematical sense. This is the (computer science)
bundled version, i.e., all the relevant data is contained in the following structure. A family of
local trivializations is indexed by a type ι
, on open subsets baseSet i
for each i : ι
.
Trivialization changes from i
to j
are given by continuous maps coordChange i j
from
baseSet i ∩ baseSet j
to the set of homeomorphisms of F
, but we express them as maps
B → F → F
and require continuity on (baseSet i ∩ baseSet j) × F
to avoid the topology on the
space of continuous maps on F
.
- baseSet : ι → Set B
- isOpen_baseSet (i : ι) : IsOpen (self.baseSet i)
- indexAt : B → ι
- mem_baseSet_at (x : B) : x ∈ self.baseSet (self.indexAt x)
- coordChange : ι → ι → B → F → F
- continuousOn_coordChange (i j : ι) : ContinuousOn (fun (p : B × F) => self.coordChange i j p.1 p.2) ((self.baseSet i ∩ self.baseSet j) ×ˢ Set.univ)
Instances For
The index set of a fiber bundle core, as a convenience function for dot notation
Equations
- _Z.Index = ι
Instances For
The base space of a fiber bundle core, as a convenience function for dot notation
Equations
- _Z.Base = B
Instances For
The fiber of a fiber bundle core, as a convenience function for dot notation and typeclass inference
Equations
- x✝.Fiber _x = F
Instances For
Equations
- Z.topologicalSpaceFiber x = inst✝
The total space of the fiber bundle, as a convenience function for dot notation.
It is by definition equal to Bundle.TotalSpace F Z.Fiber
.
Equations
- Z.TotalSpace = Bundle.TotalSpace F Z.Fiber
Instances For
The projection from the total space of a fiber bundle core, on its base.
Equations
- Z.proj = Bundle.TotalSpace.proj
Instances For
Local homeomorphism version of the trivialization change.
Equations
- One or more equations did not get rendered due to their size.
Instances For
Associate to a trivialization index i : ι
the corresponding trivialization, i.e., a bijection
between proj ⁻¹ (baseSet i)
and baseSet i × F
. As the fiber above x
is F
but read in the
chart with index index_at x
, the trivialization in the fiber above x is by definition the
coordinate change from i to index_at x
, so it depends on x
.
The local trivialization will ultimately be a partial homeomorphism. For now, we only introduce the
partial equivalence version, denoted with a prime.
In further developments, avoid this auxiliary version, and use Z.local_triv
instead.
Equations
- One or more equations did not get rendered due to their size.
Instances For
The composition of two local trivializations is the trivialization change Z.triv_change i j.
Topological structure on the total space of a fiber bundle created from core, designed so that all the local trivialization are continuous.
Equations
- One or more equations did not get rendered due to their size.
Extended version of the local trivialization of a fiber bundle constructed from core, registering additionally in its type that it is a local bundle trivialization.
Equations
- One or more equations did not get rendered due to their size.
Instances For
Preferred local trivialization of a fiber bundle constructed from core, at a given point, as a bundle trivialization
Equations
- Z.localTrivAt b = Z.localTriv (Z.indexAt b)
Instances For
If an element of F
is invariant under all coordinate changes, then one can define a
corresponding section of the fiber bundle, which is continuous. This applies in particular to the
zero section of a vector bundle. Another example (not yet defined) would be the identity
section of the endomorphism bundle of a vector bundle.
A fiber bundle constructed from core is indeed a fiber bundle.
Equations
- One or more equations did not get rendered due to their size.
The inclusion of a fiber into the total space is a continuous map.
The projection on the base of a fiber bundle created from core is continuous
The projection on the base of a fiber bundle created from core is an open map
Prebundle construction for constructing fiber bundles #
This structure permits to define a fiber bundle when trivializations are given as local equivalences but there is not yet a topology on the total space. The total space is hence given a topology in such a way that there is a fiber bundle structure for which the partial equivalences are also partial homeomorphisms and hence local trivializations.
- pretrivializationAtlas : Set (Pretrivialization F Bundle.TotalSpace.proj)
- pretrivializationAt : B → Pretrivialization F Bundle.TotalSpace.proj
- mem_base_pretrivializationAt (x : B) : x ∈ (self.pretrivializationAt x).baseSet
- pretrivialization_mem_atlas (x : B) : self.pretrivializationAt x ∈ self.pretrivializationAtlas
- continuous_trivChange (e : Pretrivialization F Bundle.TotalSpace.proj) : e ∈ self.pretrivializationAtlas → ∀ e' ∈ self.pretrivializationAtlas, ContinuousOn (↑e ∘ ↑e'.symm) (e'.target ∩ ↑e'.symm ⁻¹' e.source)
- totalSpaceMk_isInducing (b : B) : Topology.IsInducing (↑(self.pretrivializationAt b) ∘ Bundle.TotalSpace.mk b)
Instances For
Topology on the total space that will make the prebundle into a bundle.
Equations
- a.totalSpaceTopology = ⨆ e ∈ a.pretrivializationAtlas, TopologicalSpace.coinduced e.setSymm instTopologicalSpaceSubtype
Instances For
Promotion from a Pretrivialization
to a Trivialization
.
Equations
- One or more equations did not get rendered due to their size.
Instances For
Make a FiberBundle
from a FiberPrebundle
. Concretely this means
that, given a FiberPrebundle
structure for a sigma-type E
-- which consists of a
number of "pretrivializations" identifying parts of E
with product spaces U × F
-- one
establishes that for the topology constructed on the sigma-type using
FiberPrebundle.totalSpaceTopology
, these "pretrivializations" are actually
"trivializations" (i.e., homeomorphisms with respect to the constructed topology).
Equations
- One or more equations did not get rendered due to their size.
Instances For
For a fiber bundle E
over B
constructed using the FiberPrebundle
mechanism,
continuity of a function TotalSpace F E → X
on an open set s
can be checked by precomposing at
each point with the pretrivialization used for the construction at that point.