# Math (math) (/developers/pinets/architecture/namespaces/math)



## PineTS Math (`math`) Namespace [#pinets-math-math-namespace]

This directory contains the implementation of Pine Script's `math.*` namespace functions. These functions provide standard mathematical operations adapted for time-series data.

## Architecture [#architecture]

Like other namespaces, `math` functions are factory functions that receive the `context` and return the implementation.

## The `param()` Method [#the-param-method]

The `math.param()` method is identical to `ta.param()`. It ensures that all mathematical operations can handle both scalar values and `Series` objects seamlessly.

### Behavior [#behavior]

* **Series Input**: Returns the Series object (with offset if specified).
* **Scalar Input**: Wraps the scalar in a new `Series` object.
* **Array Input**: Wraps the array in a `Series` object.

This uniformity allows math functions to work directly on `Series` objects, enabling operations like `math.abs(close)`.

## Implementation Specifics [#implementation-specifics]

### 1. Series Support [#1-series-support]

Most math functions are designed to work on the *current value* of a Series. They typically extract the value using `Series.from(source).get(0)` and perform the operation.

```typescript
// Example: math.abs
const val = Series.from(source).get(0);
return Math.abs(val);
```

### 2. NaN Handling [#2-nan-handling]

Math functions should propagate `NaN` correctly. `Math.abs(NaN)` returns `NaN` in JavaScript, which aligns with Pine Script behavior.

### 3. Equality Check (`__eq`) [#3-equality-check-__eq]

A special `__eq` function handles equality checks, specifically for `NaN`. In Pine Script, `NaN == NaN` is true (unlike JavaScript). The transpiler converts `==` to `$.math.__eq()` to ensure correct behavior.

## Generating the Barrel File [#generating-the-barrel-file]

To regenerate the `math.index.ts` file after adding new methods:

```bash
npm run generate:math-index
```