Online Data Stream Creation
How to create a new stream online. • Last modified on 7/5/2019 • edit

This small tutorial is assuming you're comfortable around the online interface of speckle. If you haven't even heard about it, then please read the following tutorial.

Creating streams online is useful for various purposes, such as centralising in one place project parameters and pulling them out afterwards in Grasshopper or Dynamo to drive your parametric models. You can do this from the online interface!

Stream Creation & The Data Tab

To create a stream, while in the stream overview page, click on the big blue plus button in the lower right corner. Give it a name, add some tags, then head over to the data tab. Generally, creating a stream online is useful for simple data structures - numbers, text, booleans, etc. Specifically, it's been implemented so you can store & edit generic project paramters and then receive them throughout the ecosystem (more importantly, grasshopper and dynamo).

Manual Data Input

You can add stream "layers" (they will become output ports), and then type in values manually using commas to separate them from each other.

create a stream

The "Data Tab" is enabled only for streams that have been created online.

From Excel

Inputing any CSV values is rather easy. Just Click the Import CSV button in the top right corner and paste in your data. Here's a short animation showing how you can copy and paste some excel data into a stream (remember the big blue button in the lower right corner):

create a stream

Saving Your Changes

The layers that you create become output ports - you can rename them. The values that you enter should be comma-separated, and they're parsed automatically to numbers, strings or bools. Once you are happy with the way the data is looking, you will need to click on the "save" button (and enter a commit message - this will make your reading of the history easier). Once saving is done, you can now receive that data in grasshopper, dynamo, or via the API. Congratulations, you've created your first online stream - see below how this stream looks like in grasshopper:

receive a stream