PhyslibAlpha.ClassicalFieldTheory.Local.FirstOrder
First-order local field theory
i. Overview
This module provides a thin usability layer for first-order local field theory, i.e. the specialization of the local CFT stack to `k = 1`.
The definitions here do not introduce a new theory. They are aliases and projections for the existing coordinate-readout stack:
- first-order jet points are `JetPoint d m 1`,
- first-order lagrangians are `Lagrangian d m 1`,
- field values are still the zero-order jet coordinates,
- first derivatives are the coordinates indexed by `MultiIndex.increment 0 i`.
This keeps the general finite-order API as the source of truth while making the common first-order case easier to state in examples and later mechanics bridges.
ii. Key results
- `ClassicalFieldTheory.Local.FirstOrderJetPoint`
- `ClassicalFieldTheory.Local.FirstOrderLagrangian`
- `ClassicalFieldTheory.Local.firstDerivativeIndex`
- `ClassicalFieldTheory.Local.JetPoint.firstDerivCoord`
- `ClassicalFieldTheory.Local.firstOrderJetAt`
iii. Table of contents
- A. First-order aliases
- B. First derivative indices
- C. First-order jet projections
- D. First-order evaluation and variational API
iv. References
- J. Cortés and A. Haupt, *Lecture Notes on Mathematical Methods of Classical Physics*, arXiv:1612.03100v2, Chapter 5.
A. First-order aliases
B. First derivative indices
C. First-order jet projections
D. First-order evaluation and variational API
19 declarations
First-order jet coordinates for fields in dimensions
For a base manifold of dimension and a field with components, this defines the space of coordinate data for first-order jets (). These coordinates consist of the field values (where ) and their first-order partial derivatives (where ), for component indices and spatial indices . It is the specialization of the general -th order jet coordinates to the case .
First-order jet point () for and dimensions
For a classical field theory with independent variables (base manifold dimension) and dependent variables (field components), a **first-order jet point** is an element of the jet bundle of order . It represents the local data of a field at a point, consisting of the coordinates of the base manifold, the values of the fields, and their first-order partial derivatives.
First-order jet fiber data for fields in dimensions
Given a base manifold of dimension and a field space of dimension , this definition represents the fiber data of a first-order jet bundle (). It consists of the field values and their first-order partial derivatives at a point in the base manifold, serving as the configuration space for first-order classical field theories.
First-order local Lagrangian for fields in dimensions
For a field theory with spacetime dimensions and field components, a first-order local Lagrangian is defined as a Lagrangian of order . This represents a Lagrangian density that depends on the coordinates, the field values, and their first derivatives.
First-derivative multi-index
Given a dimension and a coordinate index , this function returns the multi-index of order 1 that represents a partial derivative in the -th direction. It is defined as the multi-index (where the -th component is 1 and all others are 0), treated as an element of the set of multi-indices .
The first-derivative index in direction equals the unit multi-index
For a given dimension and a coordinate index , the first-derivative multi-index of order 1 in the -th direction is equal to the unit multi-index , which is obtained by incrementing the -th component of the zero multi-index.
The order of the first-derivative multi-index is 1
For any dimension and coordinate index , let be the multi-index representing the first partial derivative in the -th direction (often denoted ). The order of this multi-index, defined as the sum of its components , is equal to .
First derivative coordinate of a jet point
Given a first-order jet point in a theory with independent variables and dependent variables, this function returns the jet coordinate . Here, denotes the direction of the partial derivative and denotes the field component index. This coordinate represents the value of the first-order partial derivative at the point represented by .
Vector of first-order partial derivatives in direction at a jet point
Given a first-order jet point (representing the local data of a field with independent and dependent variables) and a coordinate direction , this function returns the vector in the Euclidean space consisting of the first-order partial derivatives of all field components in that direction. Specifically, the -th component of the resulting vector is the jet coordinate , which represents the value of the partial derivative at the point .
The -th component of the first derivative vector in direction equals the coordinate
Let be a first-order jet point in a classical field theory with independent variables and field components. For any spatial direction index and field component index , the -th component of the vector of first-order partial derivatives in the direction (denoted as `firstDerivVector i`) is equal to the first derivative coordinate (denoted as `firstDerivCoord i a`).
The first derivative coordinate of a constructed jet point equals its input coordinate
Let be a base point and be a set of first-order jet coordinates (representing field values and first derivatives ). Let be the jet point constructed from and via `JetPoint.ofBaseCoordinates`. For any spatial direction and field component index , the first derivative coordinate of the jet point is equal to the entry in corresponding to the first-order multi-index and the field index . That is, where is the multi-index with in the -th position and elsewhere.
First-order jet of a field at
For a field and a base point , the **first-order jet of at **, denoted , is the jet point of order . It captures the local data of the field at , consisting of the base point , the field values , and the first-order partial derivatives for and .
The base point of is
For a field and a point , the base point component of the first-order jet is equal to .
The value of the first-order jet is
For a field and a point , the value component of the first-order jet of at , denoted , is equal to the value of the field at that point, .
The first derivative coordinates of the first-order jet are the partial derivatives
For a field , a point , a coordinate index , and a field component index , the first derivative coordinate of the first-order jet is equal to the partial derivative of the -th component of the field with respect to the -th coordinate evaluated at : where represents the -dimensional base space (typically ) and is the first-order jet of at .
First-order action density of a field for a Lagrangian
Given a first-order local Lagrangian (defined for field components in spacetime dimensions) and a field , the first-order action density is the scalar-valued function on the base space defined by evaluating at the first-order jet of the field at each point. For any point , the value is , where comprises the field values and their first-order partial derivatives .
First-order action
Given a first-order local Lagrangian (defined for field components in dimensions) and a field , the first-order action is the real number defined by the integral of the Lagrangian density evaluated at the first-order jet over the base space : where represents the first-order jet of the field at point , comprising the field values and their first-order partial derivatives.
First-order Euler-Lagrange operator
Given a first-order local Lagrangian (a Lagrangian of order ) and a field , the first-order Euler-Lagrange operator maps the field to a function . For each field component , the -th component of the operator's value at a point is given by the standard first-order Euler-Lagrange expression: where is the partial derivative of the Lagrangian with respect to the field value, is the partial derivative with respect to the first-order derivative , and denotes the total derivative with respect to the spatial coordinate .
Field is critical for a first-order Lagrangian iff
Consider a first-order local Lagrangian for field components in dimensions and a field . Suppose that the pair is admissible for the action functional (meaning is smooth and the action integral is finite) and that is smooth in its jet coordinates. Then, the field is a critical point for the action functional if and only if it satisfies the first-order Euler-Lagrange equations, i.e., where is the Euler-Lagrange operator whose components are given by for each field component .
