tivars.types.real.TIRealRadical

class documentation

class TIRealRadical(RealEntry): (source)

Constructor: TIRealRadical(init, for_flash, name, version, ...)

Parser for real radicals

A TIRealRadical is an exact sum of two square roots with rational scalars. Specifically, a TIRealRadical can represent numbers of the form (± a√b ± c√d) / e. All values are non-negative, with signs tracked separately. Additionally, b > d ≥ 0 and e > 0.

Each value is given three nibbles of storage in BCD format. Sign information for each radical is stored in an additional nibble.

A TIRealRadical can be used to form TIComplexRadical complex numbers.

Method	`__format__`	Formats this entry for string representations
Method	`calc_data`	The data section of the entry which is loaded on-calc
Method	`decimal`	No summary
Method	`denominator`	The denominator of the real radical
Method	`left_radicand`	The left radicand of the real radical
Method	`left_scalar`	The left scalar of the real radical
Method	`load_decimal`	Loads a `decimal` into this real number
Method	`load_string`	Loads this entry from a string representation
Method	`right_radicand`	The right radicand of the real radical
Method	`right_scalar`	The right scalar of the real radical
Method	`sign_type`	The sign type of the real radical
Class Variable	`flash_only`	Whether this entry only supports flash chips
Class Variable	`imag_subtype_id`	The subtype ID this type receives if used as an imaginary part
Class Variable	`is_exact`	Whether this numeric type is exact
Class Variable	`min_data_length`	The minimum length of this entry's data
Class Variable	`versions`	The possible versions of this entry
Property	`sign`	No summary
Property	`signed_left_scalar`	The left scalar of the real radical, with sign attached
Property	`signed_right_scalar`	The right scalar of the real radical, with sign attached
Class Variable	`_type_id`	Undocumented

Inherited from RealEntry:

Method	`__float__`	Undocumented
Method	`__init__`	Creates an empty entry with specified meta and data values
Method	`__int__`	Undocumented
Method	`__neg__`	Undocumented
Method	`clear`	Clears this entry's data
Method	`coerce`	Coerces this entry to a subclass if possible using the entry's type ID
Method	`float`	No summary
Method	`get_min_os`	Determines the minimum OS that supports this entry's data
Method	`graph_bit`	Whether the entry is used during graphing
Method	`json_number`	Encoder for JSON implementations with potentially low precision
Method	`load_float`	Loads a `float` into this real number, upcasting as necessary
Method	`sign_bit`	The sign bit for the number
Method	`subtype_id`	The subtype ID of the number
Method	`supported_by`	Determines whether a given model can support this entry
Class Variable	`extensions`	The file extension used for this entry per-model
Class Variable	`min_exponent`	The smallest allowed floating point exponent
Property	`subtype`	The subtype of this real number
Constant	`_T`	Undocumented

Inherited from TIEntry (via RealEntry):

Class	`Raw`	Raw bytes container for `TIEntry`
Class Method	`get`	Converts `bytes` -> `TIEntry`
Class Method	`get_type`	Gets the subclass corresponding to a type ID if one is registered
Class Method	`open`	Creates a new entry from a file given a filename
Class Method	`register`	Registers a subtype with this class for coercion
Class Method	`set`	Converts `TIEntry` -> `bytes`
Static Method	`next_entry_length`	Helper function to determine the length of the next entry in a bytestream
Method	`__bool__`	No summary
Method	`__bytes__`	No summary
Method	`__copy__`	No summary
Method	`__eq__`	Determines if two entries are the same type and have the same bytes
Method	`__iter__`	No summary
Method	`__len__`	No summary
Method	`__str__`	No summary
Method	`archive`	Archives this entry (if supported)
Method	`archived`	Whether the entry is archived
Method	`bytes`	The bytes contained in this entry, without any var file header or metadata.
Method	`data`	The entry's user data
Method	`dict`	No summary
Method	`export`	Exports this entry to a `TIVar` with a specified name, header, and target model
Method	`get_version`	Determines the version byte corresponding to given data for this entry type
Method	`load_bytes`	Loads a byte string or bytestream into this entry
Method	`load_data_section`	Loads the data of this entry from a bytestream
Method	`load_dict`	Loads this entry from a JSON dictionary representation
Method	`load_from_file`	Loads this entry from a file given a file pointer and offset
Method	`meta_length`	The length of the meta section of the entry
Method	`name`	The name of the entry
Method	`save`	Saves this entry as a var file in the current directory given a filename and optional header and targeted model
Method	`string`	No summary
Method	`type_id`	The type ID of the entry
Method	`unarchive`	Unarchives this entry (if supported)
Method	`version`	The version number of the entry
Class Variable	`base_meta_length`	Undocumented
Class Variable	`flash_meta_length`	Undocumented
Class Variable	`leading_data_bytes`	Bytes that always begin this entry's data
Class Variable	`leading_name_byte`	Byte that always begins the name of this entry
Instance Variable	`raw`	Undocumented
Property	`calc_data_length`	The length of the data section of the entry
Property	`flash_bytes`	The flash bytes of this entry if they exist
Property	`is_empty`	Whether this entry's data is empty
Property	`meta`	The meta section of this entry
Method	`__init_subclass__`	Undocumented
Class Variable	`_type_ids`	Undocumented

Inherited from Dock (via RealEntry, TIEntry):

Method	`load`	Loads data into an instance by delegating to `Loader` methods based on the input's type
Class Variable	`loaders`	Undocumented

def __format__(self, format_spec: str) -> str: (source) ¶

overrides tivars.types.real.RealEntry.__format__

Formats this entry for string representations

Parameters
format_spec:`str`	The format parameters
Returns
`str`	A string representation of this entry

@Section(min_data_length)
def calc_data(self) -> bytes: (source) ¶

overrides tivars.types.real.RealEntry.calc_data

The data section of the entry which is loaded on-calc

def decimal(self) -> Decimal: (source) ¶

overrides tivars.types.real.RealEntry.decimal

Returns
`Decimal`	A `decimal` object corresponding to this real number

@View(calc_data, LeftNibbleBCD)[1:3]
def denominator(self) -> int: (source) ¶

The denominator of the real radical

@View(calc_data, LeftNibbleBCD)[7:9]
def left_radicand(self) -> int: (source) ¶

The left radicand of the real radical

@View(calc_data, LeftNibbleBCD)[4:6]
def left_scalar(self) -> int: (source) ¶

The left scalar of the real radical

@Loader[Decimal]
def load_decimal(self, decimal: Decimal): (source) ¶

overrides tivars.types.real.RealEntry.load_decimal

Loads a decimal into this real number

Parameters
decimal:`Decimal`	The decimal to load

@Loader[str]
def load_string(self, string: str): (source) ¶

overrides tivars.var.TIEntry.load_string

Loads this entry from a string representation

Parameters
string:`str`	The string to load

@View(calc_data, RightNibbleBCD)[6:8]
def right_radicand(self) -> int: (source) ¶

The right radicand of the real radical

@View(calc_data, RightNibbleBCD)[3:5]
def right_scalar(self) -> int: (source) ¶

The right scalar of the real radical

@View(calc_data, Bits[4:8])[1:2]
def sign_type(self) -> int: (source) ¶

The sign type of the real radical

If the sign type is odd (first bit is set), the left scalar is negative. If the sign type is greater than one (second bit is set), the right scalar is negative.

flash_only: bool = (source) ¶

overrides tivars.var.TIEntry.flash_only

Whether this entry only supports flash chips

imag_subtype_id: int = (source) ¶

overrides tivars.types.real.RealEntry.imag_subtype_id

The subtype ID this type receives if used as an imaginary part

is_exact: bool = (source) ¶

overrides tivars.types.real.RealEntry.is_exact

Whether this numeric type is exact

min_data_length: int = (source) ¶

overrides tivars.types.real.RealEntry.min_data_length

The minimum length of this entry's data