slatec-sys 0.1.0

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

Usage: REAL L2, L3, L4, L5, L6, L1MIN, L1MAX, SIXCOF(NDIM) INTEGER NDIM, IER CALL RC6J(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 `RC6J`. Its documented behavior is taken from the selected, source-hash-verified provider prologue; the exact implementation source is [RC6J](https://www.netlib.org/slatec/src/rc6j.f).

# Arguments

## `L2`

**Direction:** `input`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** scalar.

Parameter in 6j symbol.

## `L3`

**Direction:** `input`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** scalar.

Parameter in 6j symbol.

## `L4`

**Direction:** `input`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** scalar.

Parameter in 6j symbol.

## `L5`

**Direction:** `input`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** scalar.

Parameter in 6j symbol.

## `L6`

**Direction:** `input`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** scalar.

Parameter in 6j symbol.

## `L1MIN`

**Direction:** `input-output`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **Shape:** scalar.

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

## `L1MAX`

**Direction:** `input-output`. **Fortran type:** `REAL`. **Rust ABI type:** `*mut f32`. **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:** `REAL`. **Rust ABI type:** `*mut f32`. **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::rc6j`
- Original SLATEC routine: `RC6J`
- Native symbol: `rc6j_`
- ABI fingerprint: `subroutine:void(mut_f32,mut_f32,mut_f32,mut_f32,mut_f32,mut_f32,mut_f32,mut_f32_ptr_rank1,mut_i32,mut_i32)`
- Exact Netlib source file: [RC6J](https://www.netlib.org/slatec/src/rc6j.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.