Skip to content

thchr/Neumann.jl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Neumann.jl

Documentation (development) Build status Coverage

This package provides a single function neumann which applies Neumann's principle to determine the forbidden and allowed components of a response tensor of arbitrary order, subject to a finite set of point group symmetry constraints.

Installation

The package can be installed via Julia's package prompt (entered by typing ] at the REPL) and subsequently imported by calling:

pkg> add https://github.com/thchr/Neumann.jl
julia> using Neumann

Theory

Neumann's principle states that any physical property must exhibit at least the symmetry of the underlying system.[1] Equivalently, any macroscopic response tensor must transform into itself under all microscopic (isogonal) point group symmetries $P$ of the underlying system (i.e., the response tensor must be invariant under the elements of $P$).

[1] See e.g., S. Bhagavantam & P.V. Pantulu, Generalized symmetry and Neumann’s principle, Proc. Indian Acad. Sci. 66, 33 (1967) or the International Tables of Crystallography, Volume A (2016), Section 3.2.2.1.1.

This package considers response tensors $A_{ij\ldots k}$ of order $N$ connecting an induced response $w_i$ to the product of $N-1$ perturbations ${v_j^{(1)}, \ldots, v_k^{(N-1)}}$, i.e.:

$$w_i = A_{ij\ldots k}v_j^{(1)}\cdots v_k^{(N-1)}.$$

Under a symmetry operation $g$, the response tensor transforms according to:

$$ gA_{ij\ldots k} = g_{il} g_{mj}^{-1} \cdots g_{nk}^{-1} A_{lm\ldots n}. $$

If $g$ is provided in an orthonormal basis we have $g^{-1} = g^{\mathrm{T}}$, and the transformation rule simplifies to $gA_{ij\ldots k} = g_{il}g_{jm}\cdots g_{kn} A_{lm\ldots n}$.

Neumann's principle simply requires that $gA_{ij\ldots k} = A_{ij\ldots k}$ for every element $g$ in the isogonal point group $P$ of the underlying system.

Examples

Neumann.jl exports a single function, neumann, which satisfies the linear relations imposed by Neumann's principle by solving for the null space of the associated equation system. The null space imposes relations between certain components of the response tensor and forbids (i.e., requires vanishing value of) other components.

As an example, any odd-rank tensor vanishes completely under inversion symmetry:

julia> using Neumann
julia> inversion = [-1 0 0; 0 -1 0; 0 0 -1]
julia> N = 3 # tensor order (e.g., corresponding to second-harmonic generation)
julia> neumann(inversion, N)
1-element Vector{String}:
 "xxx = yxx = zxx = xyx = yyx = z"  102 bytes  "yz = zyz = xzz = yzz = zzz = 0"

As a more complicated example, we can consider the constraints imposed by 4-fold rotation symmetry (4 in Hermann-Mauguin notation; $C_4$ in Schoenflies notation). For convenience, we can load the relevant generators of the group from Crystalline.jl:

julia> using Crystalline
julia> ops_C₄ = generators("4", PointGroup{3}) # generators of the group C₄ (4)
julia> neumann(ops_C₄, N)
8-element Vector{String}:
 "zxx = zyy"
 "zyx = -zxy"
 "xzx = yzy"
 "yzx = -xzy"
 "xxz = yyz"
 "yxz = -xyz"
 "zzz"
 "xxx = yxx = xyx = yyx = zzx = x"  23 bytes  "zzy = zxz = zyz = xzz = yzz = 0"

In the present example, the symmetry operations are already returned in a Cartesian basis. For several symmetry settings of interest, this is not usually the case. In such cases, we suggest that the generators returned by Crystalline first be converted to a Cartesian setting. As an example, we may consider the case of 3-fold rotation symmetry (3 in Hermann-Mauguin notation; $C_3$ in Schoenflies notation):

julia> ops_C₃ = generators("3", PointGroup{3}) # generators of the group C₃ (3)
julia> Rs = crystal(1,1,1/2/2,2π/3)        # a conventional coordinate system for hexagonal systems
julia> ops_C₃′ = cartesianize.(ops_C₃, Ref(Rs))
julia> neumann(ops_C₃′, N)
10-element Vector{String}:
 "xxx = -yyx = -yxy = -xyy"
 "yxx = xyx = xxy = -yyy"
 "zxx = zyy"
 "zyx = -zxy"
 "xzx = yzy"
 "yzx = -xzy"
 "xxz = yyz"
 "yxz = -xyz"
 "zzz"
 "zzx = zzy = zxz = zyz = xzz = yzz = 0"

Additional information is available in the documentation of neumann (accessible by typing ?neumann at the Julia REPL).

Kleinman symmetry

For low-frequency harmonic generation, a response tensor may additionally exhibit Kleinman symmetry. For e.g., second-harmonic generation, this implies that the response tensor exhibits the index permutation symmetry $A_{ijk}(\omega_3; \omega_1+\omega_2) = A_{ikj}(\omega_3; \omega_1+\omega_2)$ with $\omega_3 = \omega_1+\omega_2$ and $\omega_{1,2,3}$ assumed small relative to any intrinsic frequency scales of the material. More generally, we may consider Kleinman-like permutation symmetries of the form $A_{ij\ldots k} = A_{i P(j\ldots k)}$ with $P(j\ldots k)$ denoting any permutation of the indices $j\ldots k$.

To incorporate Kleinman symmetry, the kleinman = true keyword argument can be passed to neumann. For instance, in $C_4$, the addition of Kleinman symmetry reduces the number of independent components from 7 to 4:

julia> neumann(ops_C₄, N; kleinman = true)  # C₄ symmetry + Kleinman symmetry
5-element Vector{String}:
 "zxx = zyy"
 "xzx = yzy = xxz = yyz"
 "yzx = -xzy = yxz = -xyz"
 "zzz"
 "xxx = yxx = xyx = yyx = zyx = z"  35 bytes  "zzy = zxz = zyz = xzz = yzz = 0"

While, in $C_3$, Kleinman symmetry reduces the number of independent components from 9 to 6:

julia> neumann(ops_C₃′, N; kleinman = true) # C₃ symmetry + Kleinman symmetry
7-element Vector{String}:
 "xxx = -yyx = -yxy = -xyy"
 "yxx = xyx = xxy = -yyy"
 "zxx = zyy"
 "xzx = yzy = xxz = yyz"
 "yzx = -xzy = yxz = -xyz"
 "zzz"
 "zyx = zzx = zxy = zzy = zxz = zyz = xzz = yzz = 0"

About

Symmetry analysis of response tensors.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages