Clausen function
Enable an agent to recognize Clausen-function expressions, resolve their conventions, and select justified symbolic or numerical operations.
Bundle → Layer → Finding → Questions Filled
6 bundles · 11 layers · 15 findings · 25 questions
Identity and conventions Determine exactly which function a Clausen label denotes.
Classical definition
Establish the identifying formula and normalization of Cl_2.
Defining formula
Record the formula that establishes identity, including order, sign, argument scaling, and normalization.
- Does the expression match sum_{k>=1} sin(k theta)/k^2, or does it introduce a different sign, scale, or order? definition
- Which reference establishes the adopted definition and normalization? provenance
Generalized notation
Resolve higher-order and sine-versus-cosine naming conventions.
Family membership
Treat broader Clausen terminology as a scope decision requiring a defining formula.
- Does this source use Clausen function for Cl_2 alone, a sine family, or an order-dependent sine/cosine convention? definition
- Should the cited generalization be represented within this entry or linked to a separately registered concept? boundary
Representations and validity Connect interchangeable formulas while preserving their mathematical conditions.
Series and integral
Specify convergence and logarithm conventions for real-variable definitions.
Real representation conditions
Capture the argument interval, convergence justification, and treatment of logarithmic endpoints.
- On what domain is the selected Fourier series convergent and equal to the intended Clausen function? boundary
- When extending the logarithmic integral beyond its initial interval, is an absolute value or another explicit convention required? definition
Dilogarithm connection
Control use of unit-circle polylogarithm representations.
Continuation and branches
Separate the real-argument imaginary-part identity from a proposed complex continuation.
- Are the assumptions needed to replace Cl_2(theta) by Im Li_2(exp(i theta)) satisfied? action
- If the argument is complex, which analytic expression, branches, and cuts define the continuation? definition
Real-argument behavior Describe transformations and local behavior relevant to real Cl_2 arguments.
Symmetry and reduction
Establish periodicity and reflection rules from the adopted definition.
Argument equivalence
Record the derivation and sign bookkeeping for equivalent real arguments.
- How do the defining sine series establish oddness and 2*pi periodicity for classical Cl_2? definition
- Which reduced argument and sign preserve the requested value while improving evaluation? action
Logarithmic endpoints
Distinguish finite function values from singular derivative behavior.
Endpoint regularity
Require separate evidence for continuity, differentiability, and local approximations near multiples of 2*pi.
- What limits and differentiability statements follow from the logarithmic integral at multiples of 2*pi? boundary
- Which local expansion and remainder control should be used near an endpoint? measurement
Numerical evaluation Make computed Clausen values reproducible and assessable.
Method selection
Choose an evaluator compatible with the function convention and argument regime.
Evaluator contract
Record the implementation, precision, input interpretation, and supported function member.
- Does the selected routine evaluate classical Cl_2 or a generalized family with an explicit order parameter? definition
- Which method meets the error target for this argument, especially near zeros or after reducing a very large angle? action
Error and cross-checks
Distinguish reported digits from verified accuracy.
Accuracy evidence
Attach meaningful error information and independent checks to evaluated values.
- Is the uncertainty a rigorous bound, an implementation estimate, or agreement observed at increased precision? measurement
- Do independent representations agree within the claimed absolute error, including at symmetry-related arguments? measurement
Symbolic use and special values Support exact transformations and use in larger mathematical expressions.
Special-value evidence
Record exact values and relations at distinguished arguments.
Exact versus approximate
Keep proofs, symbolic representations, and decimal evaluations distinguishable.
- Which values at integer or rational multiples of pi have an established exact expression under this normalization? definition
- What derivation or reference proves each claimed relation to a named constant? provenance
Integral transformations
Use the logarithmic-integral representation in a surrounding calculation.
Substitution conditions
Preserve integration limits, scale factors, additive constants, and logarithm conventions.
- Which substitution converts the target logarithmic-trigonometric integral to the adopted Cl_2 definition? action
- What interval restrictions, endpoint limits, and integration constants must accompany the resulting expression? boundary
Evidence and external alignment What the world already says about this thing, gathered so the model can be checked against it.
Reported evidence
Findings from the breadth pass, kept separate from the structural claims.
Check these first
Recalled without web access and unsourced; every item is a lead to verify.
- Which of these check these first hold for the sense of Clausen function this model covers, and on what evidence? provenance
Kinds and varieties
Recalled without web access and unsourced; every item is a lead to verify.
- Which of these kinds and varieties hold for the sense of Clausen function this model covers, and on what evidence? provenance
Real-world use
Recalled without web access and unsourced; every item is a lead to verify.
- Which of these real-world use hold for the sense of Clausen function this model covers, and on what evidence? provenance
Failure modes and hazards
Recalled without web access and unsourced; every item is a lead to verify.
- Which of these failure modes and hazards hold for the sense of Clausen function this model covers, and on what evidence? provenance
Neighbouring kinds and how to tell them apart
Recalled without web access and unsourced; every item is a lead to verify.
- Which of these neighbouring kinds and how to tell them apart hold for the sense of Clausen function this model covers, and on what evidence? provenance
Classifiers Filled
- Family
- Thing Registry
- Category
- Cross-cutting context
- Entry kind
- thing
- Plane
- XCT
- Domain
- XCT.QLT
What it is Filled
The Clausen function usually denotes the real, odd, 2π-periodic special function Cl₂(θ) = Σₙ₌₁∞ sin(nθ)/n², equivalently the imaginary part of the dilogarithm Li₂(eⁱθ).
In scope
- Identification of the classical Cl_2 function and its defining normalization
- Fourier-series, logarithmic-integral, and dilogarithm representations
- Real-argument domains, periodicity, symmetry, and endpoint behavior
- Evaluation methods, error requirements, and validation identities
- Notation and scope decisions for generalized Clausen functions
Out of scope
- The general theory of polylogarithms and dilogarithms
- Clausen's hypergeometric identities
- Independent models of Catalan's constant and other special values
- Full models of physical or geometric problems using Clausen functions
- General-purpose numerical-library architecture
Why it exists Filled
Enable an agent to recognize Clausen-function expressions, resolve their conventions, and select justified symbolic or numerical operations.
Distinguishing features Filled
- For real theta, the classical function has the identifying series Cl_2(theta) = sum_{k>=1} sin(k theta)/k^2; record both the sine numerator and order-two denominator. See [mpmath definitions](https://mpmath.org/doc/current/functions/zeta.html#clsin).
- On 0 < theta < 2*pi, it equals -integral_0^theta log(2*sin(t/2)) dt, with normalization Cl_2(0)=0. See [GSL Clausen functions](https://www.gnu.org/software/gsl/doc/html/specfunc.html#clausen-functions).
- For real theta, it is Im Li_2(exp(i theta)), rather than the full complex dilogarithm. See [GSL Clausen functions](https://www.gnu.org/software/gsl/doc/html/specfunc.html#clausen-functions).
- A generalized sine function, a complementary cosine function, and the classical Cl_2 require explicit differentiation by formula and order. See [mpmath Clausen functions](https://mpmath.org/doc/current/functions/zeta.html#clsin).
What robots and AI may and may not do Filled
Must not
- Present an unverified identity involving the function as proven.
- Use a slowly converging series without error bounds in a result others rely on.
- Confuse the two-index Clausen functions or the standard and alternate notations.
Only with a human decision
- Publishing a new result about the function under a person's name.
May
- Evaluate and explain the Clausen function, its series and its relation to the dilogarithm.
- Check numerical values against reliable references.
Moral aspects Filled
- Accurate attribution and verified results matter in mathematical work.
Who is affected
- Students
- Mathematicians
- Physicists using its values
Owners Filled
Steward
Nobody owns it; it is a mathematical function.
Links to other meta-models Filled
parent
- Q11348 - registry parent class
- Q134326403 - registry parent class
What else AI and robots need to interact with it Filled
Identity and identifiers required Filled
- Vercy registry: vr.tr.clausen-function
- Wikidata: Q823290 (https://www.wikidata.org/wiki/Q823290)
Direct properties not applicable Not applicable
- Function convention: classical Cl_2; generalized sine; generalized cosine; other explicitly sourced convention
- Order: dimensionless; 2 for the classical function; otherwise explicitly specified
- Argument: real angle in radians; complex argument only under a declared continuation
- Representation: Fourier series; logarithmic integral; polylogarithmic expression; numerical approximation
- Continuation convention: real-domain definition; specified complex branch; unresolved
- Evaluation accuracy: absolute error; relative error where meaningful; working precision
- Defining authority: reference or implementation documenting the exact convention
Plane XCT: no invented physical properties.
Recognition optional Filled
- Written Cl2 of theta, a periodic wave-like curve that is zero at multiples of pi.
Capabilities and actions required Filled
- Recognize a Clausen expression from its formula and resolve ambiguous notation.
- Convert between representations after checking argument and branch conditions.
- Reduce real arguments using justified symmetry and periodicity.
- Evaluate a specified function member to a declared error target.
- Validate computed values against independent representations and special cases.
- Express suitable logarithmic-trigonometric integrals using Cl_2 with explicit substitutions and limits.
Hazards and failure modes required Filled
- Truncated series give inaccurate values near the peaks.
Standards and interfaces not applicable Not applicable
Not applicable
No specific standard, law or official classification applies to this mathematical function.
Context of use required Filled
- The Clausen function occurs in special-function theory, Fourier analysis and evaluations of definite integrals.
- It helps express results involving dilogarithms on the unit circle, with the order and convention checked before symbolic or numerical evaluation.
Sources Filled
- Wikidata item Q823290: Clausen function - identity and sense of the item
- Wikipedia: Clausen function - general description of the item
Open questions
- Does the registry's intended source identify this entry with classical Cl_2 alone or the broader Clausen family?
- Which higher-order naming convention should be canonical when references use different sine/cosine conventions?
- Should complex continuations be owned by this model, and which branch convention would be authoritative?
- Which independently verified special values, identities, and numerical error guarantees are sufficient for publication?
- Does an existing Vercy world model already cover this concept and require this registry entry to link to it?
Machine files
Provenance
thing registry research (pass 2) · unreviewed
Built from: models/things/publications/thing-q823290/spec.json