Associate this study design with a dataset

Assigning data to the study design allows Tisane to perform some additional checks on your study design and variables, and ensures that everything makes sense.

It is optional to specify cardinality for variables, and the Design will automatically calculate the cardinality using the data.

When cardinality is specified, the Design will check to make sure that the cardinality of the variable and the cardinality in the data make sense.


source (os.PathLike or pandas.DataFrame) – How to get the data. This can be a string containing a path, such as “path/to/my/data.csv”, or some kind of path object, or simply a Pandas DataFrame. If it is a path, it must be a csv file.


A reference to the object this was called on

Return type



Our data is in a csv file called “rats_data.csv”.

>>> import tisane as ts
>>> rat = ts.Unit("rat_id")
>>> week = ts.SetUp("week_number")
>>> weight = rat.numeric("rat_weight", number_of_instances=week)
>>> exercise_condition = rat.nominal("exercise_condition")
>>> design = ts.Design(ivs=[exercise_condition], dv=weight).assign_data("rats_data.csv")

Suppose instead we have a pandas DataFrame called rats_df.

>>> design = ts.Design(ivs=[exercise_condition], dv=weight).assign_data(rats_df)