ak.from_json¶
Defined in awkward.operations.convert on line 1021.
- ak.from_json(source, nan_string=None, infinity_string=None, minus_infinity_string=None, complex_record_fields=None, highlevel=True, behavior=None, initial=1024, resize=1.5, buffersize=65536)¶
- Parameters
source (str) – JSON-formatted string or filename to convert into an array.
nan_string (None or str) – If not None, strings with this value will be interpreted as floating-point NaN values.
infinity_string (None or str) – If not None, strings with this value will be interpreted as floating-point positive infinity values.
minus_infinity_string (None or str) – If not None, strings with this value will be interpreted as floating-point negative infinity values.
complex_record_fields (None or (str, str)) – If not None, defines a pair of field names to interpret records as complex numbers.
highlevel (bool) – If True, return an
ak.Array
; otherwise, return a low-levelak.layout.Content
subclass.behavior (None or dict) – Custom
ak.behavior
for the output array, if high-level.initial (int) – Initial size (in bytes) of buffers used by
ak.layout.ArrayBuilder
(seeak.layout.ArrayBuilderOptions
).resize (float) – Resize multiplier for buffers used by
ak.layout.ArrayBuilder
(seeak.layout.ArrayBuilderOptions
); should be strictly greater than 1.buffersize (int) – Size (in bytes) of the buffer used by the JSON parser.
Converts a JSON string into an Awkward Array.
Internally, this function uses ak.layout.ArrayBuilder
(see the high-level
ak.ArrayBuilder
documentation for a more complete description), so it
has the same flexibility and the same constraints. Any heterogeneous
and deeply nested JSON can be converted, but the output will never have
regular-typed array lengths.
See also ak.to_json
.