← Back to catalogue
Published

Clausen function

vr.tr.clausen-function · thing-q823290

Enable an agent to recognize Clausen-function expressions, resolve their conventions, and select justified symbolic or numerical operations.

Thing Registry Cross-cutting context XCT.QLT

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.

  1. Does the expression match sum_{k>=1} sin(k theta)/k^2, or does it introduce a different sign, scale, or order? definition
  2. 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.

  1. Does this source use Clausen function for Cl_2 alone, a sine family, or an order-dependent sine/cosine convention? definition
  2. 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.

  1. On what domain is the selected Fourier series convergent and equal to the intended Clausen function? boundary
  2. 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.

  1. Are the assumptions needed to replace Cl_2(theta) by Im Li_2(exp(i theta)) satisfied? action
  2. 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.

  1. How do the defining sine series establish oddness and 2*pi periodicity for classical Cl_2? definition
  2. 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.

  1. What limits and differentiability statements follow from the logarithmic integral at multiples of 2*pi? boundary
  2. 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.

  1. Does the selected routine evaluate classical Cl_2 or a generalized family with an explicit order parameter? definition
  2. 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.

  1. Is the uncertainty a rigorous bound, an implementation estimate, or agreement observed at increased precision? measurement
  2. 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.

  1. Which values at integer or rational multiples of pi have an established exact expression under this normalization? definition
  2. 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.

  1. Which substitution converts the target logarithmic-trigonometric integral to the adopted Cl_2 definition? action
  2. 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.

  1. 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.

  1. 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.

  1. 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.

  1. 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.

  1. 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

  1. Wikidata item Q823290: Clausen function - identity and sense of the item
  2. 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