otp.Source.drop#

Source.drop(columns, inplace=False)#

Remove a list of columns from the Source. If column with such name wasn’t found the error will be raised, if the regex was specified and there aren’t any matched columns, do nothing. Regex is any string containing any of characters *+?:[]{}(), dot is a valid symbol for OneTick identifier, so a.b will be passed to OneTick as an identifier, if you want specify such regex use parenthesis - (a.b)

Parameters

columns (str, Column or list of them) – Column(s) to remove. You could specify a regex or collection of regexes, in such case columns with match names will be deleted.
inplace (bool) – A flag controls whether operation should be applied inplace. If inplace=True, then it returns nothing. Otherwise method returns a new modified object.

Return type

Source or None

Examples

>>> data = otp.Ticks(X1=[1, 2, 3],
...                  X2=[3, 2, 1],
...                  A1=["A", "A", "A"])
>>> data = data.drop("X1")
>>> otp.run(data)
                     Time  X2 A1
0 2003-12-01 00:00:00.000   3  A
1 2003-12-01 00:00:00.001   2  A
2 2003-12-01 00:00:00.002   1  A

Regexes also could be specified in such case all matched columns will be deleted

>>> data = otp.Ticks(X1=[1, 2, 3],
...                  X2=[3, 2, 1],
...                  A1=["A", "A", "A"])
>>> data = data.drop(r"X\d+")
>>> otp.run(data)
                     Time A1
0 2003-12-01 00:00:00.000  A
1 2003-12-01 00:00:00.001  A
2 2003-12-01 00:00:00.002  A

Several parameters can be specified

>>> data = otp.Ticks(X1=[1, 2, 3],
...                  X2=[3, 2, 1],
...                  Y1=[1, 2, 3],
...                  Y2=[3, 2, 1],
...                  YA=["a", "b", "c"],
...                  A1=["A", "A", "A"])
>>> data = data.drop([r"X\d+", "Y1", data["Y2"]])
>>> otp.run(data)
                     Time YA A1
0 2003-12-01 00:00:00.000  a  A
1 2003-12-01 00:00:00.001  b  A
2 2003-12-01 00:00:00.002  c  A

a.b will be passed to OneTick as an identifier, if you want specify such regex use parenthesis - (a.b)

>>> data = otp.Ticks({"COLUMN.A": [1, 2, 3], "COLUMN1A": [3, 2, 1],
...                   "COLUMN1B": ["a", "b", "c"], "COLUMN2A": ["c", "b", "a"]})
>>> data = data.drop("COLUMN.A")
>>> otp.run(data)
                     Time  COLUMN1A COLUMN1B COLUMN2A
0 2003-12-01 00:00:00.000         3        a        c
1 2003-12-01 00:00:00.001         2        b        b
2 2003-12-01 00:00:00.002         1        c        a

>>> data = otp.Ticks({"COLUMN.A": [1, 2, 3], "COLUMN1A": [3, 2, 1],
...                   "COLUMN1B": ["a", "b", "c"], "COLUMN2A": ["c", "b", "a"]})
>>> data = data.drop("(COLUMN.A)")
>>> otp.run(data)
                     Time COLUMN1B
0 2003-12-01 00:00:00.000        a
1 2003-12-01 00:00:00.001        b
2 2003-12-01 00:00:00.002        c