plastid.bin.test_table_equality module

Regression-testing script designed to test equality between a newly-generated file and a reference file that is intended to contain the same data. Rows and columns are not expected to be in the same order. Float values are only required to be equal within a user-specified tolerance. NaN values evaluate as equal if and only if they occur in the same cell after sorting rows and columns. Finally, specific columns may be excluded by name (or number, if there is no header row).

Exit status is 0 if files are identical, 1 otherwise

plastid.bin.test_table_equality.equal_enough(col1, col2, tol=1e-10, printer=NullWriter())

If col1 and col2 are both numeric, test that all their values are within tol of each other. numpy.nan values, if present, must be in the same place in each column. Ditto numpy.inf values.

If col1 and col2 are not numeric, return true if they have the same dtype and the same values in all cells.

Parameters

col1numpy.ndarray

First column of data

col2numpy.ndarray

Second column of data

tolfloat

Error tolerance for numeric data between col1 and col2, value-wise

printeranything implementing a write() method (e.g. a NameDateWriter)

if not None, rich comparison information will be sent to this writer

Returns

bool

True if col1 == col2 for non-numeric data; True if abs(col1 - col2) <= tol for numeric data; False otherwise

plastid.bin.test_table_equality.main(argv=['-T', '-E', '-b', 'html', '-d', '_build/doctrees', '-D', 'language=en', '.', '_build/html'], verbose=False)

Command-line program

Parameters

argvlist, optional

A list of command-line arguments, which will be processed as if the script were called from the command line if main() is called directly.

Default: sys.argv[1:]. The command-line arguments, if the script is invoked from the command line

verbosebool, optional

If True, return

Returns

int

0 if files are identical, 1 otherwise

str

Only returned if verbose is selected. String describing how tables are unequal (e.g. which columns failed, et c).

plastid.bin.test_table_equality.test_dataframe_equality(df1, df2, tol=1e-08, sort_columns=[], printer=NullWriter(), print_verbose=False, return_verbose=False)

Test equality of dataframes over multiple columns, with verbose output. If NaNs or Infs are present, these must be present in corresponding cells in both dataframes for the dataframes to evaluate as equal.

Parameters

df1pd.DataFrame

First dataframe

df2pd.DataFrame

Second dataframe

tolfloat, optoinal

Maximum tolerated difference between floating point numbers (Default: 1e-8)

sort_columnslist, optional

List of column names or indices on which to sort data before comparing values

printerfile-like, optional

Any logger importing a write() method

print_verbosebool, optional

Print verbose output to stderr (Default: False)

return_verbosebool, optional

If True, return a list of failure messages

Returns

bool

True if dataframes are equal, False otherwise

list

A list of strings explaining how df1 and df2 differ. Only returned if return_verbose is True