Databin

Databin["id"]
represents a databin in the Wolfram Data Drop.

Databin["id",n]
represents the first n entries in a databin.

Databin["id",-n]
represents the most recent n entries in a databin.

Databin["id",{m,n}]
represents entries m through n in a databin, with negative numbers counting from the end.

Databin["id",{m,n,s}]
represents entries m through n with step s.

Databin["id",time]
represents entries going back for the quantity of time specified by time.

Databin["id",date]
represents the entries in a databin from the specified date to now.

Databin["id",{date1,date2}]
represents the entries in a databin from to .

Databin["id",range,{"key1","key2",}]
represents only elements with keys within each entry in a databin.

DetailsDetails

  • In Databin["id"], id can be a short ID, a complete UUID, or a short or long URL.
  • The long URL for a databin in the Wolfram Cloud is of the form datadrop.wolframcloud.com/databin/.
  • Databin uses the standard sequence specification:
  • Allall entries
    nentries 1 through n
    -nlast n entries
    {n}entry n only
    {m,n}entries m through n inclusive
    {m,n,s}entries m through n in steps of s
  • Databin["id"] is equivalent to Databin["id",All].
  • In Databin["id",time], time is specified as a Quantity object.
  • Special forms for time include:
  • "Minute"most recent minute
    "Hour"most recent hour
    "Day"most recent 24-hour period
    "Week"most recent 7-day period
    "Month"most recent 30-day period
    "Year"most recent 365-day period
  • In Databin["id",date], date is specified using DateObject.
  • The following operations on databins are supported:
  • EventSeries[databin]an event series of all data in the databin
    TimeSeries[databin]a time series of all data in the databin
    Dataset[databin]a dataset of timestamps and entries in the databin
    Get[databin]the full content of the databin as a list of associations
    Normal[databin]the list of entries in the databin without metadata
    Values[databin]lists of values in the databin without timestamps
    Keys[databin]the association keys corresponding to the data signature
    DateListPlot[databin]time series plots for each key in the databin
    Options[databin]find the options of a databin
    SetOptions[databin,]reset the options of a databin
  • In general, functions that operate on TimeSeries and EventSeries objects can be applied directly to Databin objects. Examples include Histogram, Mean, and TimeSeriesMap.
  • Operations can be performed on a databin using Databin[][request,].
  • Basic requests for retrieving databin content include:
  • "Latest"the latest entry added, with metadata
    "Recent"recent entries, with metadata
    "TimeInterval"timespan for entries in the databin
    "Timestamps"list of time stamps for all entries in the databin
    "GeoLocations"list of geo locations for all entries in the databin
    "EventSeries"event series for data in the databin (EventSeries)
    "TimeSeries"time series for data in the databin (TimeSeries)
    "FullEntries"all databin entries, with metadata (Get)
    "Entries"all entries in the databin, without metadata (Normal)
    "Values"list of values for each key used in the databin (Values)
    request,paramsmake a request with parameters params
  • Possible parameters params include:
  • seqentries given by the sequence specification seq
    <|key1val1,|>detailed specification
  • Possible entries in the detailed specification include:
  • "Count"total number of entries
    "StartIndex"index of first entry to include
    "EndIndex"index of last entry to include
    "StartTime"time of first entry to include
    "EndTime"time of last entry to include
  • Requests related to adding data to a databin include:
  • "Add",dataadd data to the databin
    "WebForm"cloud-deployed form for adding data to the databin
  • Databin["id"]["Add",data] is equivalent to DatabinAdd["id",data].
  • Databin["id"]["Add",data,"Authorization"->token] includes an authorization token, which must match a token specified when the databin was created.
  • Databin["id"]["Add",data,"Timestamp"date] includes a custom time stamp for a databin entry.
  • Databin identification operations include:
  • "ShortID"short ID for the databin
    "UUID"full UUID for the databin
    "ShortURL"short URL for the databin
    "URL"full UUID-based URL for the databin
    "Name"name assigned to the databin
  • Databin metadata requests include:
  • "Information"information about the databin
    "Interpretation"interpretation signature for the databin
    "EntryCount"number of entries in the databin
    "Size"size of the databin contents
    "Keys"key names in the databin interpretation signature
    "LatestDate"date the latest entry was added
    "CreationDate"date the databin was first created
    "ExpirationDate"date the databin expires
    "Class"class used to create the databin
  • Databin["id"]["Keys"] is equivalent to Keys[Databin["id"]].
  • Databin access control operations include:
  • "Permissions"permissions for the databin
    "Owner"Wolfram ID of the owner of the databin
    "Administrators"Wolfram IDs of the administrators of the databin
    "Creator"Wolfram ID of the creator of the databin
  • Databin report generation operations include:
  • "Report"report on the databin, given as a local notebook
    "WebReport"report on the databin, given as a cloud notebook
  • Some operations on a databin may require authentication in the Wolfram Cloud.
  • The options, such as permissions of a databin, can be found using Options and set using SetOptions.

ExamplesExamplesopen allclose all

Basic Examples  (4)Basic Examples  (4)

Load an existing example databin:

In[1]:=
Click for copyable input
Out[1]=

Plot data from the databin:

In[2]:=
Click for copyable input
Out[2]=

Get time series from the databin:

In[3]:=
Click for copyable input
Out[3]=

Load the most recent 3 entries from an existing databin:

In[1]:=
Click for copyable input
Out[1]=

Retrieve the values for these entries:

In[2]:=
Click for copyable input
Out[2]=

Create a new databin:

In[1]:=
Click for copyable input
Out[1]=

Add a value to the databin:

In[2]:=
Click for copyable input
Out[2]=

Add another value:

In[3]:=
Click for copyable input
Out[3]=

Add data using the web API:

In[4]:=
Click for copyable input

Retrieve all values from the databin:

In[5]:=
Click for copyable input
Out[5]=

Create a databin with an interpretation:

In[1]:=
Click for copyable input
Out[1]=

Add to the databin:

In[2]:=
Click for copyable input
Out[2]=
In[3]:=
Click for copyable input
Out[3]=

Retrieve values from the databin:

In[4]:=
Click for copyable input
Out[4]=
Introduced in 2014
(10.0)