class_docstr: An interface to incrementally build an SFrame (row by row). It has some
  basic features such as appending multiple rows at once, polling the last N
  rows appended, and a primitive parallel insert interface.
  
  Once closed, the SFrame cannot be "reopened" using this interface.
  
  Parameters
  ----------
  column_types : list[type]
      The column types of the result SFrame. Types must be of the python
      types that are supported by SFrame (int, float, str, array.array, list,
      dict, datetime.datetime, image). Column types are strictly enforced
      while appending.
  
  column_names : list[str], optional
      Column names of the result SFrame. If given, length of the list must
      equal the length of `column_types`. If not given, names are generated.
  
  num_segments : int, optional
      Number of segments that can be written in parallel.
  
  history_size : int, optional
      The number of rows to be cached as history. Caches the last
      `history_size` rows added with `append` or `append_multiple`.
  
  Returns
  -------
  out : SFrameBuilder
  
  Examples
  --------
  >>> from turicreate import SFrameBuilder
  
  >>> sb = SFrameBuilder([int,float,str])
  
  >>> sb.append([1,1.0,"1"])
  
  >>> sb.append_multiple([[2,2.0,"2"],[3,3.0,"3"]])
  
  >>> new_sf = sb.close(); new_sf
  Columns:
          X1      int
          X2      float
          X3      str
  Rows: 3
  Data:
  +----+-----+----+
  | X1 |  X2 | X3 |
  +----+-----+----+
  | 1  | 1.0 | 1  |
  | 2  | 2.0 | 2  |
  | 3  | 3.0 | 3  |
  +----+-----+----+
  [3 rows x 3 columns]
class_docstr_tok: ["An","interface","to","incrementally","build","an","SFrame","(","row","by","row",")",".","It","has","some","basic","features","such","as","appending","multiple","rows","at","once",",","polling","the","last","N","rows","appended",",","and","a","primitive","parallel","insert","interface",".","Once","closed",",","the","SFrame","can","not","be","``","reopened","''","using","this","interface",".","Parameters","--","--","--","--","--","column_types",":","list","[","type","]","The","column","types","of","the","result","SFrame",".","Types","must","be","of","the","python","types","that","are","supported","by","SFrame","(","int",",","float",",","str",",","array.array",",","list",",","dict",",","datetime.datetime",",","image",")",".","Column","types","are","strictly","enforced","while","appending",".","column_names",":","list","[","str","]",",","optional","Column","names","of","the","result","SFrame",".","If","given",",","length","of","the","list","must","equal","the","length","of","`","column_types","`",".","If","not","given",",","names","are","generated",".","num_segments",":","int",",","optional","Number","of","segments","that","can","be","written","in","parallel",".","history_size",":","int",",","optional","The","number","of","rows","to","be","cached","as","history",".","Caches","the","last","`","history_size","`","rows","added","with","`","append","`","or","`","append_multiple","`",".","Returns","--","--","--","-","out",":","SFrameBuilder","Examples","--","--","--","--",">",">",">","from","turicreate","import","SFrameBuilder",">",">",">","sb","=","SFrameBuilder","(","[","int",",","float",",","str","]",")",">",">",">","sb.append","(","[","1,1.0",",","''","1","''","]",")",">",">",">","sb.append_multiple","(","[","[","2,2.0",",","''","2","''","]",",","[","3,3.0",",","''","3","''","]","]",")",">",">",">","new_sf","=","sb.close","(",")",";","new_sf","Columns",":","X1","int","X2","float","X3","str","Rows",":","3","Data",":","+","--","--","+","--","--","-+","--","--","+","|","X1","|","X2","|","X3","|","+","--","--","+","--","--","-+","--","--","+","|","1","|","1.0","|","1","|","|","2","|","2.0","|","2","|","|","3","|","3.0","|","3","|","+","--","--","+","--","--","-+","--","--","+","[","3","rows","x","3","columns","]"]
docstr: Append a single row to an SFrame.
  
  Throws a RuntimeError if one or more column's type is incompatible with
  a type appended.
  
  Parameters
  ----------
  data  : iterable
      An iterable representation of a single row.
  
  segment : int
      The segment to write this row. Each segment is numbered
      sequentially, starting with 0. Any value in segment 1 will be after
      any value in segment 0, and the order of rows in each segment is
      preserved as they are added.
docstr_tok: ["Append","a","single","row","to","an","SFrame",".","Throws","a","RuntimeError","if","one","or","more","column","'s","type","is","incompatible","with","a","type","appended",".","Parameters","--","--","--","--","--","data",":","iterable","An","iterable","representation","of","a","single","row",".","segment",":","int","The","segment","to","write","this","row",".","Each","segment","is","numbered","sequentially",",","starting","with","0",".","Any","value","in","segment","1","will","be","after","any","value","in","segment","0",",","and","the","order","of","rows","in","each","segment","is","preserved","as","they","are","added","."]
code: def append(self, data, segment=0):
      """
      Append a single row to an SFrame.
  
      Throws a RuntimeError if one or more column's type is incompatible with
      a type appended.
  
      Parameters
      ----------
      data  : iterable
          An iterable representation of a single row.
  
      segment : int
          The segment to write this row. Each segment is numbered
          sequentially, starting with 0. Any value in segment 1 will be after
          any value in segment 0, and the order of rows in each segment is
          preserved as they are added.
      """
      # Assume this case refers to an SFrame with a single column
      if not hasattr(data, "__iter__"):
          data = [data]
      self._builder.append(data, segment)
  
file_path: turicreate/src/python/turicreate/data_structures/sframe_builder.py
imports: from __future__ import print_function
  from __future__ import division
  from __future__ import absolute_import
  from .._cython.cy_sframe_builder import UnitySFrameBuilderProxy
  from .sframe import SFrame
  from ..util import _make_internal_url
  import logging
label_desc: Use image node_id 3 for calling the SFrameBuilder obj's underlying member method code with example usage: obj.append(data, segment) without return types