File tree 1 file changed +13
-0
lines changed
spec/API_specification/dataframe_api
1 file changed +13
-0
lines changed Original file line number Diff line number Diff line change @@ -19,6 +19,19 @@ class Column(Protocol):
19
19
users of the library implementing the dataframe API standard. Rather, use
20
20
constructor functions or an already-created dataframe object retrieved via
21
21
:meth:`DataFrame.col`.
22
+
23
+ The parent dataframe (which can be retrieved via the :meth:`dataframe` property)
24
+ plays a key role here:
25
+
26
+ - If two columns were retrieved from the same dataframe,
27
+ then they can be combined and compared at will.
28
+ - If two columns were retrieved from different dataframes,
29
+ then there is no guarantee about how or whether they can be combined and
30
+ compared, this may vary across implementations.
31
+ - If two columns are both "free-standing" (i.e. not retrieved from a dataframe
32
+ but constructed directly from a 1D array or sequence), then they can be
33
+ combined and compared with each other. Note, however, that they still can't
34
+ be compared or combined with columns retrieved from a dataframe.
22
35
"""
23
36
@property
24
37
def dataframe (self ) -> DataFrame | None :
You can’t perform that action at this time.
0 commit comments