# foundryts.functions.first\_point

## foundryts.functions.first\_point()

Returns a function that extracts the earliest point for a single time series.

The returned point is the first occurring point within the range of a given time series.
Returns an empty summary when the series is empty.

* **Returns:**
  A function that accepts a single time series and returns the first point in the provided series. The dataframe
  contains a single row with the first point.
* **Return type:**
  ([FunctionNode](../nodes-function-node/index.md#foundryts.nodes.FunctionNode)) -> SummarizerNode

## Dataframe schema

| Column name   | Type              | Description            |
|---------------|-------------------|------------------------|
| timestamp     | pandas.Timestamp  | Timestamp of the point |
| value         | Union\[float, str] | Value of the point     |

:::callout{theme="success" title="See Also"}
[`time_extent()`](../functions-time-extent/index.md#foundryts.functions.time_extent), [`last_point()`](../functions-last-point/index.md#foundryts.functions.last_point)
:::

## Examples

```pycon
>>> series = F.points(
...     (1, 0.0),
...     (101, 10.2),
...     (200, 11.3),
...     (123450, 11.8),
... )
>>> series.to_pandas()
                      timestamp  value
0 1970-01-01 00:00:00.000000001    0.0
1 1970-01-01 00:00:00.000000101   10.2
2 1970-01-01 00:00:00.000000200   11.3
3 1970-01-01 00:00:00.000123450   11.8
```

```pycon
>>> fp = F.first_point()(series)
>>> fp.to_pandas()
                      timestamp  value
0 1970-01-01 00:00:00.000000001    0.0
```