Data Modeling Introduction¶

Prerequisite:

• Installed Neat, see Installation
• Launched a notebook environment.
• Familiar with the NeatSession object, see introduction

In this tutorial, we will publish an example data model to CDF.

Creating NeatSession¶

We will start by instansiating a NeatSession. The below steps assumes you are in a CDF Notebook

In [ ]:

%pip install cognite-neat

from cognite.client import CogniteClient

from cognite.neat import NeatSession

client = CogniteClient()

neat = NeatSession(client)

%pip install cognite-neat from cognite.client import CogniteClient from cognite.neat import NeatSession client = CogniteClient() neat = NeatSession(client)

Reading Data Model¶

We will read an example model that comes with neat.

In [2]:

neat

neat

Out[2]:

Empty session. Get started by reading something with the .read attribute.

In [3]:

neat.read.examples.pump_example()

neat.read.examples.pump_example()

Out[3]:

Success: Read NEAT(verified,physical,neat_playground,NeatHelloWorld,v1)

In [4]:

neat

neat

Out[4]:

Data Model

level	physical
intended for	Data Engineer
name	Neat Hello World
space	neat_playground
external_id	NeatHelloWorld
version	v1
views	33
containers	3
properties	14

When we read a model in neat. We are now ready to look at the model

Inspect Model¶

We can visualize the data model with the show command

In [5]:

neat.show.data_model()

neat.show.data_model()

http_purl.org_cognite_neat_data-model_verified_physical_neat_playground_NeatHelloWorld_v1.html

Out[5]:

Deploy to CDF¶

We want to deploy this model to CDF.

First, instead of using the default data model ID, we set our own.

In [6]:

neat.set.data_model_id(("my_space", "HelloWorldModel", "v1"))

neat.set.data_model_id(("my_space", "HelloWorldModel", "v1"))

Out[6]:

Success: NEAT(verified,physical,neat_playground,NeatHelloWorld,v1) → NEAT(verified,physical,my_space,HelloWorldModel,v1)

Then we deploy the data model to CDF.

In [10]:

neat.to.cdf.data_model()

neat.to.cdf.data_model()

You can inspect the details with the .inspect.outcome.data_model(...) method.

Out[10]:

	name	unchanged
0	spaces	1
1	containers	3
2	views	3
3	data_models	1
4	nodes	0

We can now login to CDF to see the model

Note that model is an extension of CogniteCore and thus includes CogniteCore types as well as the Pump, Facility and Documentation

Model to Excel¶

Finally, we can inspect the data model in Excel by using the to.excel command.

In [6]:

neat.to.excel("my_first_model.xlsx")

neat.to.excel("my_first_model.xlsx")

In [ ]: