Oakfield API Documentation 1.0.0
Numerical core APIs
Loading...
Searching...
No Matches
loggamma.h File Reference

Complex log-gamma helpers for Riemann zeta/xi evaluation. More...

#include <stddef.h>
#include "oakfield/field.h"
Include dependency graph for loggamma.h:

Go to the source code of this file.

Classes

struct  SimLogGammaResult
 Principal log-gamma value with error estimate and diagnostic metadata. More...
 

Macros

#define SIM_LOG_GAMMA_FLAG_USED_REFLECTION   0x1u
 

Typedefs

typedef enum SimLogGammaStatus SimLogGammaStatus
 Status values returned by complex log-gamma evaluators.
 
typedef struct SimLogGammaResult SimLogGammaResult
 Principal log-gamma value with error estimate and diagnostic metadata.
 

Enumerations

enum  SimLogGammaStatus { SIM_LOG_GAMMA_STATUS_OK = 0 , SIM_LOG_GAMMA_STATUS_SINGULAR , SIM_LOG_GAMMA_STATUS_INVALID_ARGUMENT , SIM_LOG_GAMMA_STATUS_NUMERIC_FAILURE }
 Status values returned by complex log-gamma evaluators. More...
 

Functions

const char * sim_log_gamma_status_string (SimLogGammaStatus status)
 Human-readable description of a log-gamma status value.
 
SimLogGammaResult sim_log_gamma_eval (SimComplexDouble z)
 Evaluate the principal-branch complex log-gamma function.
 
SimComplexDouble sim_log_gamma_value (SimComplexDouble z)
 Convenience wrapper returning only the complex log-gamma value.
 

Detailed Description

Complex log-gamma helpers for Riemann zeta/xi evaluation.

Enumeration Type Documentation

◆ SimLogGammaStatus

Status values returned by complex log-gamma evaluators.

Enumerator
SIM_LOG_GAMMA_STATUS_OK 

Evaluation completed successfully.

SIM_LOG_GAMMA_STATUS_SINGULAR 

Argument lies on a log-gamma singularity.

SIM_LOG_GAMMA_STATUS_INVALID_ARGUMENT 

Input argument or output pointer was invalid.

SIM_LOG_GAMMA_STATUS_NUMERIC_FAILURE 

Evaluation produced an unstable numeric result.

Function Documentation

◆ sim_log_gamma_eval()

SimLogGammaResult sim_log_gamma_eval ( SimComplexDouble  z)

Evaluate the principal-branch complex log-gamma function.

Parameters
zComplex argument.
Returns
Structured value, error estimate, status, and implementation flags.

◆ sim_log_gamma_status_string()

const char * sim_log_gamma_status_string ( SimLogGammaStatus  status)

Human-readable description of a log-gamma status value.

Parameters
statusStatus returned by log-gamma evaluators.
Returns
Static diagnostic string.

◆ sim_log_gamma_value()

SimComplexDouble sim_log_gamma_value ( SimComplexDouble  z)

Convenience wrapper returning only the complex log-gamma value.

On failure both components are returned as NaN.

Parameters
zComplex argument.
Returns
log Gamma(z), or {NAN, NAN} on failure.