osl_dynamics.utils.model

Utility classes and functions related to the models.

Classes

Table	A simple table class that stores data in rows and columns.
HTMLTable	Class for creating HTML tables.
LatexTable	Class for creating LaTeX tables.

Functions

tex_escape(text)

Escape characters which require control sequences in text for use in LaTeX.

Module Contents

osl_dynamics.utils.model.tex_escape(text)

Escape characters which require control sequences in text for use in LaTeX.

Parameters:

text (str) – Text to be escaped.

Returns:

escaped_text – Escaped text.

Return type:

str

class osl_dynamics.utils.model.Table(headers)

A simple table class that stores data in rows and columns.

Parameters:

headers (list) – List of strings for the table headers.

headers

rows = []

class osl_dynamics.utils.model.HTMLTable(headers)

Bases: Table

Class for creating HTML tables.

Parameters:

headers (List[str])

headers

The table headers.

Type:

list of str

rows

The table rows.

Type:

list of list of str

outer = Multiline-String

Show Value

"""<table>
{headers}
{content}
</table>"""

tr = '<tr>{}</tr>'

th = '<th>{}</th>'

td = '<td style="white-space:pre-wrap; word-wrap:break-word">{}</td>'

append_last(item)

Append an item to the last cell in the last row.

Parameters:

item (str) – The string to append to the cell.

Return type:

None

html_row(items)

Format a list of strings as an HTML table row.

Parameters:

items (list of str) – A list of str to be added to the HTML table.

Returns:

html – The HTML table row.

Return type:

str

html_headers()

Generate HTML table headers from self.headers

Returns:

headers – HTML table headers

Return type:

str

output()

Create the full HTML for the table.

Returns:

html – The HTML for the table.

Return type:

str

class osl_dynamics.utils.model.LatexTable(headers, *, vertical_lines=True, horizontal_lines=True, header_lines=True)

Bases: Table

Class for creating LaTeX tables.

Parameters:

• headers (List[str])

• vertical_lines (bool)

• horizontal_lines (bool)

• header_lines (bool)

headers

The table headers.

Type:

list of str

rows

The table rows.

Type:

list of list of str

vertical_lines

Whether to draw vertical lines, by default True.

Type:

bool, optional

horizontal_lines

Whether to draw horizontal lines, by default True.

Type:

bool, optional

header_lines

Whether to draw horizontal lines above the header, by default True.

Type:

bool, optional

outer = ''

vertical_lines = True

horizontal_lines = True

escape()

Escape special characters in headers and rows.

Return type:

None

append_last(item)

Append an item on the last row of the table.

Parameters:

item (any) – Item to append.

Return type:

None

static latex_row(items)

Create a latex row from a list of strings.

Parameters:

items (list of strings) – The list of strings to be turned into a row.

Returns:

latex_row – The latex row.

Return type:

string

output()

Format the table into LaTeX code.

Returns:

The LaTeX code that produces the table.

Return type:

str