Skip to content

Commit e882bc9

Browse files
committed
Minor code improvements in the documentation
1 parent 7823dcb commit e882bc9

7 files changed

Lines changed: 16 additions & 37 deletions

File tree

experimental/FTheoryTools/docs/src/g4.md

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -25,12 +25,9 @@ subject to **quantization**, **transversality**, and several additional consiste
2525

2626
1. **Quantization (cf. [Witten 1997](@cite Wit97)):** ``G_4 + \frac{1}{2} c_2(\widehat{Y}_4) \in H^4(\widehat{Y}_4, \mathbb{Z})``
2727

28-
2. **Transversality:** The flux must be orthogonal to both the base and the fiber in a precise cohomological
29-
sense.
28+
2. **Transversality:** The flux must be orthogonal to both the base and the fiber in a precise cohomological sense.
3029

31-
3. Additional constraints, such as **D3-tadpole cancellation**, **self-duality**, and **primitivity**, are also
32-
typically imposed. One often requires that the ``G_4``-flux preserves the non-abelian gauge symmetry encoded in
33-
the fibration.
30+
3. Additional constraints, such as **D3-tadpole cancellation**, **self-duality**, and **primitivity**, are also typically imposed. One often requires that the ``G_4``-flux preserves the non-abelian gauge symmetry encoded in the fibration.
3431

3532
These conditions ensure compatibility with fundamental physical principles like anomaly cancellation and D3-brane
3633
charge quantization.

experimental/FTheoryTools/docs/src/hypersurface.md

Lines changed: 2 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -28,15 +28,8 @@ following ingredients:
2828

2929
- A **base space** ``B``, over which the elliptic fibration is defined.
3030
- A **fiber ambient space** ``F``, in which the elliptic fiber appears as a hypersurface.
31-
- Two divisor classes ``D_1`` and ``D_2`` in ``\text{Cl}(B)``, and a choice of two
32-
homogeneous coordinates of the fiber ambient space ``F``. These two coordinates transform
33-
over the base ``B`` as sections of the line bundles associated to ``D_1`` and ``D_2``,
34-
respectively. All remaining homogeneous coordinates of ``F`` transform as sections of the
35-
trivial line bundle over ``B``.
36-
- A hypersurface equation defining the total space of the elliptic fibration as a section
37-
of the anti-canonical bundle ``\overline{K}_A`` of the full ambient space ``A``, which
38-
combines both the fiber ambient space ``F`` and the base space ``B``. This ensures that
39-
the hypersurface equation is Calabi–Yau.
31+
- Two divisor classes ``D_1`` and ``D_2`` in ``\text{Cl}(B)``, and a choice of two homogeneous coordinates of the fiber ambient space ``F``. These two coordinates transform over the base ``B`` as sections of the line bundles associated to ``D_1`` and ``D_2``, respectively. All remaining homogeneous coordinates of ``F`` transform as sections of the trivial line bundle over ``B``.
32+
- A hypersurface equation defining the total space of the elliptic fibration as a section of the anti-canonical bundle ``\overline{K}_A`` of the full ambient space ``A``, which combines both the fiber ambient space ``F`` and the base space ``B``. This ensures that the hypersurface equation is Calabi–Yau.
4033

4134
It is worth noting that any elliptic fibration, for which the fiber ambient space is toric,
4235
can be cast into this form [KM-POPR15](@cite). Consequently, this approach allows for a

experimental/FTheoryTools/docs/src/tate.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -226,13 +226,8 @@ In F-theory, the standard approach to handling singular geometries is to replace
226226
**crepant resolutions**. This process preserves the Calabi–Yau condition and ensures the correct encoding of physical
227227
data. However, several important caveats apply:
228228

229-
- Not all singularities admit crepant resolutions, rather some singularities are obstructed from being resolved without
230-
violating the Calabi–Yau condition. No algorithm is known to the authors that determines whether a given singularity
231-
admits a crepant resolution.
232-
- Likewise, no general algorithm is known for computing a crepant resolution of a given singular geometry. In practice,
233-
one applies all known resolution techniques, guided by mathematical structure and physical expectations. A particularly
234-
prominent strategy is a sequence of **blowups**. We discuss the available blowup functionality in
235-
[Functionality for all F-theory models](@ref).
229+
- Not all singularities admit crepant resolutions, rather some singularities are obstructed from being resolved without violating the Calabi–Yau condition. No algorithm is known to the authors that determines whether a given singularity admits a crepant resolution.
230+
- Likewise, no general algorithm is known for computing a crepant resolution of a given singular geometry. In practice, one applies all known resolution techniques, guided by mathematical structure and physical expectations. A particularly prominent strategy is a sequence of **blowups**. We discuss the available blowup functionality in [Functionality for all F-theory models](@ref).
236231

237232
After applying a resolution strategy, one obtains a **partially resolved** model. For the reasons stated above, OSCAR
238233
does not currently verify whether the model has been fully resolved—i.e., whether all resolvable singularities have been

experimental/FTheoryTools/docs/src/weierstrass.md

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -206,13 +206,8 @@ In F-theory, the standard approach to handling singular geometries is to replace
206206
via **crepant resolutions**. This process preserves the Calabi–Yau condition and ensures the correct encoding
207207
of physical data. However, several important caveats apply:
208208

209-
- Not all singularities admit crepant resolutions, rather some singularities are obstructed from being resolved
210-
without violating the Calabi–Yau condition. No algorithm is known to the authors that determines whether a
211-
given singularity admits a crepant resolution.
212-
- Likewise, no general algorithm is known for computing a crepant resolution of a given singular geometry.
213-
In practice, one applies all known resolution techniques, guided by mathematical structure and physical
214-
expectations. A particularly prominent strategy is a sequence of **blowups**. We discuss the available blowup
215-
functionality in [Functionality for all F-theory models](@ref).
209+
- Not all singularities admit crepant resolutions, rather some singularities are obstructed from being resolved without violating the Calabi–Yau condition. No algorithm is known to the authors that determines whether a given singularity admits a crepant resolution.
210+
- Likewise, no general algorithm is known for computing a crepant resolution of a given singular geometry. In practice, one applies all known resolution techniques, guided by mathematical structure and physical expectations. A particularly prominent strategy is a sequence of **blowups**. We discuss the available blowup functionality in [Functionality for all F-theory models](@ref).
216211

217212
After applying a resolution strategy, one obtains a **partially resolved** model. For the reasons stated above,
218213
OSCAR does not currently verify whether the model has been fully resolved—i.e., whether all resolvable

experimental/FTheoryTools/src/FamilyOfG4Fluxes/constructors.jl

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ identify ambient space candidates of G4-fluxes. In terms of these
1010
candidates, we can define a family of G4-fluxes as:
1111
- ``\mathbb{Z}``-linear combinations, provided by a matrix ``\text{mat}_{\text{int}}``,
1212
- ``\mathbb{Q}``-linear combinations, provided by a matrix ``\text{mat}_{\text{rat}}``,
13-
- a shift ``---``resembling the appearance of ``\frac{1}{2} \cdot c_2`` in the flux quantization condition``---`` provided by a vector ``\text{offset}``.
13+
- a shiftresembling the appearance of ``\frac{1}{2} \cdot c_2`` in the flux quantization conditionprovided by a vector ``\text{offset}``.
1414
1515
For convenience we also allow to only provide ``\text{mat}_{\text{int}}``or ``\text{mat}_{\text{rat}}``. In this case, the shift is taken to be zero.
1616

experimental/FTheoryTools/src/G4Fluxes/auxiliary.jl

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -400,7 +400,7 @@ and ``b``-th toric variables defines a cohomology class on the ambient toric var
400400
``H^{2,2}(X_\Sigma, \mathbb{Q})`` to ``\widehat{Y}_4``.
401401
402402
This symbolic representation can be used to reconstruct cohomology class generators
403-
via Cox ring monomials. For the actual cohomology class generators, see ``gens_of_h22_hypersurface``.
403+
via Cox ring monomials. For the actual cohomology class generators, see `gens_of_h22_hypersurface`.
404404
405405
Use `check = false` to skip completeness and simplicity verification.
406406
@@ -502,10 +502,10 @@ to linear combinations of generators of ``S \subseteq H^{2,2}(\widehat{Y}_4, \ma
502502
where ``\widehat{Y}_4`` is the (smooth) hypersurface associated to the F-theory model and
503503
``S`` the restriction of ``H^{2,2}(X_\Sigma, \mathbb{Q})`` to ``\widehat{Y}_4``.
504504
505-
The generating set of ``S`` is the one returned by ``gens_of_h22_hypersurface``,
505+
The generating set of ``S`` is the one returned by `gens_of_h22_hypersurface`,
506506
and this converter enables expressing any ambient class in terms of these restricted generators.
507507
508-
For the analogous map in the ambient toric variety, see ``converter_dict_h22_ambient``.
508+
For the analogous map in the ambient toric variety, see `converter_dict_h22_ambient`.
509509
510510
Use `check = false` to skip completeness and simplicity verification.
511511
@@ -548,10 +548,10 @@ end
548548
Given an F-theory model `m` defined as a hypersurface in a simplicial and
549549
complete toric space ``X_\Sigma``, this method computes a basis of
550550
``H^{2,2}(X_\Sigma, \mathbb{Q})`` (using the method `basis_of_h22`) and then
551-
filters out ``---``based on fairly elementary, sufficent but not necessary checks``---``
552-
basis elements whose restriction to the hypersurface in question is non-trivial. The
553-
list of these basis elements ---``cast into G4-flux ambient space candidates``---
554-
is then returned by this method.
551+
filters outbased on fairly elementary, sufficent but not necessary checks—basis
552+
elements whose restriction to the hypersurface in question is non-trivial. The
553+
list of these basis elementscast into ``G_4``-flux ambient space candidates—is then
554+
returned by this method.
555555
556556
Use `check = false` to skip completeness and simplicity verification.
557557

experimental/FTheoryTools/src/TateModels/methods.jl

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ Determine the fiber of a (singular) global Tate model over a particular base loc
55
66
!!! warning
77
This method may run for very long time and is currently not tested as part of the regular OSCAR CI due to its excessive run times.
8-
```
98
"""
109
function analyze_fibers(model::GlobalTateModel, centers::Vector{<:Vector{<:Integer}})
1110

0 commit comments

Comments
 (0)