datascience.tables.Table.take

Table.take()[source]

Return a new Table of a sequence of rows taken by number.

Args:
row_indices_or_slice (integer or list of integers or slice): The row index, list of row indices or a slice of row indices to be selected.
Returns:
A new instance of Table.
>>> t = Table().with_columns([
...     'letter grade', ['A+', 'A', 'A-', 'B+', 'B', 'B-'],
...     'gpa', [4, 4, 3.7, 3.3, 3, 2.7]])
>>> t
letter grade | gpa
A+           | 4
A            | 4
A-           | 3.7
B+           | 3.3
B            | 3
B-           | 2.7
>>> t.take(0)
letter grade | gpa
A+           | 4
>>> t.take(5)
letter grade | gpa
B-           | 2.7
>>> t.take(-1)
letter grade | gpa
B-           | 2.7
>>> t.take([2, 1, 0])
letter grade | gpa
A-           | 3.7
A            | 4
A+           | 4
>>> t.take([1, 5])
letter grade | gpa
A            | 4
B-           | 2.7
>>> t.take(range(3))
letter grade | gpa
A+           | 4
A            | 4
A-           | 3.7

Note that take also supports NumPy-like indexing and slicing:

>>> t.take[:3]
letter grade | gpa
A+           | 4
A            | 4
A-           | 3.7

>>> t.take[2, 1, 0]
letter grade | gpa
A-           | 3.7
A            | 4
A+           | 4