convert#
- convert(data, constructor_dict=DEFAULT_CLASS_MAP, *, default_encoding=None, force_default_encoding=False, global_environment=None, base_environment=None)[source]#
Use the default converter (
SimpleConverter()
) to convert the data.- Parameters:
data (parser.RData | parser.RObject) – Parsed data.
constructor_dict (ConstructorDict) –
Dictionary mapping names of R classes to constructor functions with the following prototype:
def constructor(obj, attrs): ...
This dictionary can be used to support custom R classes. By default, the dictionary used is
DEFAULT_CLASS_MAP
which has support for several common classes.default_encoding (str | None) – Default encoding used for strings with unknown encoding. If None, the one stored in the file will be used, or ASCII as a fallback.
force_default_encoding (bool) – Use the default encoding even if the strings specify other encoding.
global_environment (MutableMapping[str, Any] | None) – Global environment to use. By default is an empty environment.
base_environment (MutableMapping[str, Any] | None) – Base environment to use. By default is an empty environment.
- Return type:
Any
Examples
Parse one of the included examples, containing a vector
>>> import rdata >>> >>> parsed = rdata.parser.parse_file( ... rdata.TESTDATA_PATH / "test_vector.rda") >>> converted = rdata.conversion.convert(parsed) >>> converted {'test_vector': array([1., 2., 3.])}
Parse another example, containing a dataframe
>>> import rdata >>> >>> parsed = rdata.parser.parse_file( ... rdata.TESTDATA_PATH / "test_dataframe.rda") >>> converted = rdata.conversion.convert(parsed) >>> converted {'test_dataframe': class value 1 a 1 2 b 2 3 b 3}