slatec-sys 0.1.0

Unsafe, provider-neutral Rust declarations for the reviewed SLATEC raw API
Documentation
# Purpose

Usage: DOUBLE PRECISION L2, L3, L4, L5, L6, L1MIN, L1MAX, SIXCOF(NDIM) INTEGER NDIM, IER CALL DRC6J(L2, L3, L4, L5, L6, L1MIN, L1MAX, SIXCOF, NDIM, IER) The definition and properties of 6j symbols can be found, for example, in Appendix C of Volume II of A. Messiah. Although the parameters of the vector addition coefficients satisfy certain conventional restrictions, the restriction that they be non-negative integers or non-negative integers plus 1/2 is not imposed on input to this subroutine. The restrictions imposed are 1. L2+L3+L5+L6 and L2+L4+L6 must be integers; 2. ABS(L2-L4).LE.L6.LE.L2+L4 must be satisfied; 3. ABS(L4-L5).LE.L3.LE.L4+L5 must be satisfied;

# Description

This canonical unsafe binding exposes original SLATEC routine `DRC6J`. Its documented behavior is taken from the selected, source-hash-verified provider prologue; the exact implementation source is [DRC6J](https://www.netlib.org/slatec/src/drc6j.f).

# Arguments

## `L2`

**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Parameter in 6j symbol.

## `L3`

**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Parameter in 6j symbol.

## `L4`

**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Parameter in 6j symbol.

## `L5`

**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Parameter in 6j symbol.

## `L6`

**Direction:** `input`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Parameter in 6j symbol.

## `L1MIN`

**Direction:** `input-output`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Smallest allowable L1 in 6j symbol. must be a non-negative integer, where.

## `L1MAX`

**Direction:** `input-output`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** scalar.

Largest allowable L1 in 6j symbol. must be a non-negative integer, where MIN(L2+L3,L5+L6) and L1MIN=MAX(ABS(L2-L3),ABS(L5-L6)). If all the conventional restrictions are satisfied, then these restrictions are met. Conversely, if input to this subroutine meets all of these restrictions and the conventional restriction stated above, then all the conventional restrictions are satisfied. The user should be cautious in using input parameters that do not satisfy the conventional restrictions. For example, the the subroutine produces values of h(L1) = { L1 2/3 1 } {2/3 2/3 2/3} for L1=1/3 and 4/3 but none of the symmetry properties of the 6j symbol, set forth on pages 1063 and 1064 of Messiah, is satisfied.

## `SIXCOF`

**Direction:** `output`. **Fortran type:** `DOUBLE PRECISION`. **Rust ABI type:** `*mut f64`. **Shape:** rank 1; dimensions (NDIM).

Set of 6j coefficients generated by evaluating the 6j symbol for all allowed values of L1. SIXCOF(I) will contain h(L1MIN+I-1), I=1,2,. ,L1MAX-L1MIN+1.

## `NDIM`

**Direction:** `input`. **Fortran type:** `INTEGER`. **Rust ABI type:** `*mut crate::FortranInteger`. **Shape:** scalar.

Declared length of SIXCOF in calling program.

## `IER`

**Direction:** `status-output`. **Fortran type:** `INTEGER`. **Rust ABI type:** `*mut crate::FortranInteger`. **Shape:** scalar.

Error flag. IER=0 No errors. IER=1 L2+L3+L5+L6 or L4+L2+L6 not an integer. IER=2 L4, L2, L6 triangular condition not satisfied. IER=3 L4, L5, L3 triangular condition not satisfied. IER=4 L1MAX-L1MIN not an integer.

# Return value

This is a Fortran subroutine and has no direct return value. Its results, status, and any persistent solver state are communicated through the documented arguments.

# Status and error values

| Status | Value | Meaning |
| --- | ---: | --- |
| `IER` | `0` | No errors. |
| `IER` | `1` | L2+L3+L5+L6 or L4+L2+L6 not an integer. |
| `IER` | `2` | L4, L2, L6 triangular condition not satisfied. |
| `IER` | `3` | L4, L5, L3 triangular condition not satisfied. |
| `IER` | `4` | L1MAX-L1MIN not an integer. |
| `IER` | `5` | L1MAX less than L1MIN. |
| `IER` | `6` | NDIM less than L1MAX-L1MIN+1. |

# Workspace and array requirements

- `SIXCOF`: not a workspace argument

# ABI notes

- Canonical Rust path: `slatec_sys::special::drc6j`
- Original SLATEC routine: `DRC6J`
- Native symbol: `drc6j_`
- ABI fingerprint: `subroutine:void(mut_f64,mut_f64,mut_f64,mut_f64,mut_f64,mut_f64,mut_f64,mut_f64_ptr_rank1,mut_i32,mut_i32)`
- Exact Netlib source file: [DRC6J](https://www.netlib.org/slatec/src/drc6j.f)

# Safety

Every raw pointer must be non-null unless this argument contract expressly permits null, correctly aligned, and valid for its documented readable or writable extent. Preserve Fortran column-major layout, length, leading-dimension, workspace, callback-lifetime, aliasing, and provider-runtime requirements. The native routine does not retain ordinary argument pointers beyond this call.