> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# NeatSession reference

> Complete reference for the NeatSession class, the main interface for working with NEAT.

The `NeatSession` is the main interface for working with NEAT. You instantiate it with a `CogniteClient` and an optional `NeatConfig`.

```python wrap theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
neat = NeatSession(client: CogniteClient, config: Optional[NeatConfig] = None)
```

For full API documentation, see the [cognite-neat package on PyPI](https://pypi.org/project/cognite-neat/) and the [NEAT source code](https://github.com/cognitedata/neat).

## Attributes

### issues

```python theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
neat.issues
```

Contains issues and insights found during session operations.

### result

```python theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
neat.result
```

Holds the result of the last executed operation in the session.

## Physical data model

```python theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
neat.physical_data_model
```

The `physical_data_model` object provides methods for reading and writing physical data models.

### Reading physical data models

Use `neat.physical_data_model.read` to load data models from:

* **CDF**: `read.cdf(space, external_id, version)` — Read from Cognite Data Fusion
* **Excel**: `read.excel(path)` — Read from an Excel file

### Writing physical data models

Use `neat.physical_data_model.write` to deploy or export data models:

* **CDF**: `write.cdf(dry_run=False, drop_data=False)` — Deploy to Cognite Data Fusion
* **Excel**: `write.excel(path)` — Export to an Excel file

## Further reading

* [Getting started with NEAT](/cdf/deploy/neat/installation) — Install and configure NEAT
* [Physical data model reference](/cdf/deploy/neat/data_modeling/excel/physical/reference) — Overview of physical data model sheets
* [NeatConfig reference](/cdf/deploy/neat/reference/config) — Configuration options for NeatSession