+ nDj82R^RIHt^RIHt^RIHt^RIHtHt^RI t ^RI H t ^RI HtHt]'d^RIt^RI HtHt^R IHt]!4R R R RR R/RRll4tR R R R/RRllt]!4RRR R R R/RRll4t]!4RRR R R R/RRll4tRRltRRltR#)) annotations)Iterable)Path) TYPE_CHECKINGAnyN) AsComponents)_send_warning_or_raisecatch_and_log_exceptions)ComponentDescriptorDescribedComponentBatch)RecordingStreamstaticF recordingstrictc4V^8dQhRRRRRRRRRR R R R R /#) entity_pathstr | list[object]entityz0AsComponents | Iterable[DescribedComponentBatch]extrarboolrRecordingStream | Nonerz bool | NonereturnNone)formats"N/data/cameron/venvs/s3viz/lib/python3.14/site-packages/rerun_sdk/rerun/_log.py __annotate__rsWtt#t <t =t  t & t  t tc\VR4'd\VP44pM:\V\4'd \V4pM\ R\ V4 R24hVFup\VR4'd"VPVP44K6\V\4'dVPV4K_\ R\ V4 R24h \VVVVR7R#)a= Log data to Rerun. This is the main entry point for logging data to rerun. It can be used to log anything that implements the [`rerun.AsComponents`][] interface, or a collection of `ComponentBatchLike` objects. When logging data, you must always provide an [entity_path](https://www.rerun.io/docs/concepts/logging-and-ingestion/entity-path) for identifying the data. Note that paths prefixed with "__" are considered reserved for use by the Rerun SDK itself and should not be used for logging user data. This is where Rerun will log additional information such as properties and warnings. The most common way to log is with one of the rerun archetypes, all of which implement the `AsComponents` interface. For example, to log a 3D point: ```py rr.log("my/point", rr.Points3D(position=[1.0, 2.0, 3.0])) ``` The `log` function can flexibly accept an arbitrary number of additional objects which will be merged into the first entity so long as they don't expose conflicting components, for instance: ```py # Log three points with arrows sticking out of them, # and a custom "confidence" component. rr.log( "my/points", rr.Points3D([[0.2, 0.5, 0.3], [0.9, 1.2, 0.1], [1.0, 4.2, 0.3]], radii=[0.1, 0.2, 0.3]), rr.Arrows3D(vectors=[[0.3, 2.1, 0.2], [0.9, -1.1, 2.3], [-0.4, 0.5, 2.9]]), rr.AnyValues(confidence=[0.3, 0.4, 0.9]), ) ``` Parameters ---------- entity_path: Path to the entity in the space hierarchy. The entity path can either be a string (with special characters escaped, split on unescaped slashes) or a list of unescaped strings. This means that logging to `"world/my\ image\!"` is the same as logging to ["world", "my image!"]. See for more on entity paths. entity: Anything that implements the [`rerun.AsComponents`][] interface, usually an archetype, or an iterable of (described)component batches. *extra: An arbitrary number of additional component bundles implementing the [`rerun.AsComponents`][] interface, that are logged to the same entity path. static: If true, the components will be logged as static data. Static data has no time associated with it, exists on all timelines, and unconditionally shadows any temporal data of the same type. Otherwise, the data will be timestamped automatically with `log_time` and `log_tick`. Additional timelines set by [`rerun.set_time`][] will also be included. recording: Specifies the [`rerun.RecordingStream`][] to use. If left unspecified, defaults to the current active data recording, if there is one. See also: [`rerun.init`][], [`rerun.set_global_data_recording`][]. strict: If True, raise exceptions on non-loggable data. If False, warn on non-loggable data. if None, use the global default from `rerun.strict_mode()` as_component_batcheszlExpected an object implementing rerun.AsComponents or an iterable of rerun.DescribedComponentBatch, but got z instead.)r componentsrrN) hasattrlistr! isinstancer TypeErrortypeextend_log_components)rrrrrrr"exts&&$$$* rlogr+svv-..&5578 FH % %&\ F|nI /   3. / /   c668 9 X & &   c "9+Y0   rc ,V^8dQhRRRRRRRRR R /#) rrrr"zlist[DescribedComponentBatch]rrrrrrr)rs"rrrsANN#N-N  N & N  Nrc./pVUu.uFqUP4NK ppVUu.uFqUP4NK pp\V\4'd0\P !VUu.uFp\ V4NK up4p\4p \WgRR7F9wrV fK W9d\RV R2^R7K$V PV 4WV &K; \P!TTTVeVP4MRR7R#uupiuupiuupi)a Internal method to log an entity from a collection of `ComponentBatchLike` objects. See also: [`rerun.log`][]. Parameters ---------- entity_path: Path to the entity in the space hierarchy. The entity path can either be a string (with special characters escaped, split on unescaped slashes) or a list of unescaped strings. This means that logging to `"world/my\ image\!"` is the same as logging to ["world", "my image!"]. See for more on entity paths. components: A collection of `ComponentBatchLike` objects. static: If true, the components will be logged as static data. Static data has no time associated with it, exists on all timelines, and unconditionally shadows any temporal data of the same type. Otherwise, the data will be timestamped automatically with `log_time` and `log_tick`. Additional timelines set by [`rerun.set_time`][] will also be included. recording: Specifies the [`rerun.RecordingStream`][] to use. If left unspecified, defaults to the current active data recording, if there is one. See also: [`rerun.init`][], [`rerun.set_global_data_recording`][]. F)rNz Component zC was included multiple times. Only the first instance will be used.)depth_to_user_code)r"static_r) component_descriptoras_arrow_arrayr%r$bindingsnew_entity_pathstrsetzipr add log_arrow_msg to_native) rr"rr instancedcomp descriptors arrow_arrayspartaddeddescrarrays &&$$ rr)r)sX68I;EF:4,,.:KF6@Ajd'')jLA+t$$..k/RkdD k/RS EEKeD  =  > "UG#fg#$   IIe  %#E& +4+@)%%'d 7GA0SsDD )Dentity_path_prefixc ,V^8dQhRRRRRRRRR R /#) r file_path str | PathrB str | Nonerrrrrrr)rs"rrrs<---#-  - & -  -rct\P!\V4TTVeVP4MRR7R#)a5 Logs the file at the given `path` using all `Importer`s available. A single `path` might be handled by more than one importer. This method blocks until either at least one `Importer` starts streaming data in or all of them fail. See for more information. Parameters ---------- file_path: Path to the file to be logged. entity_path_prefix: What should the logged entity paths be prefixed with? static: If true, the components will be logged as static data. Static data has no time associated with it, exists on all timelines, and unconditionally shadows any temporal data of the same type. Otherwise, the data will be timestamped automatically with `log_time` and `log_tick`. Additional timelines set by [`rerun.set_time`][] will also be included. recording: Specifies the [`rerun.RecordingStream`][] to use. If left unspecified, defaults to the current active data recording, if there is one. See also: [`rerun.init`][], [`rerun.set_global_data_recording`][]. NrBr/r)r2log_file_from_pathrr9)rDrBrrs&$$$rrIrIs3R  Y-+4+@)%%'d rc 0V^8dQhRRRRRRRRR R R R /#) rrDrE file_contentsbytesrBrFrrrrrrr)rs"rrrsD3333# 3  3 & 3 3rcv\P!\V4TTTVeVP4MRR7R#)as Logs the given `file_contents` using all `Importer`s available. A single `path` might be handled by more than one importer. This method blocks until either at least one `Importer` starts streaming data in or all of them fail. See for more information. Parameters ---------- file_path: Path to the file that the `file_contents` belong to. file_contents: Contents to be logged. entity_path_prefix: What should the logged entity paths be prefixed with? static: If true, the components will be logged as static data. Static data has no time associated with it, exists on all timelines, and unconditionally shadows any temporal data of the same type. Otherwise, the data will be timestamped automatically with `log_time` and `log_tick`. Additional timelines set by [`rerun.set_time`][] will also be included. recording: Specifies the [`rerun.RecordingStream`][] to use. If left unspecified, defaults to the current active data recording, if there is one. See also: [`rerun.init`][], [`rerun.set_global_data_recording`][]. NrH)r2log_file_from_contentsrr9)rDrKrBrrs&&$$$rrNrNs6\ ## Y-+4+@)%%'d rc V^8dQhRRRR/#)rr>r4rr)rs"rrrFs77#7#7rc@\\P!V44#)aP Escape an individual part of an entity path. For instance, `escape_entity_path_path("my image!")` will return `"my\ image\!"`. See for more on entity paths. Parameters ---------- part: An unescaped string Returns ------- str: The escaped entity path. )r4r2escape_entity_path_part)r>s&rrQrQFs& x//5 66rc V^8dQhRRRR/#)rrz list[Any]rr4r)rs"rrr\sNNNsNrc |\\P!VUu.uFp\V4NK up44#uupi)a Construct an entity path, defined by a list of (unescaped) parts. If any part if not a string, it will be converted to a string using `str()`. For instance, `new_entity_path(["world", 42, "my image!"])` will return `"world/42/my\ image\!"`. See for more on entity paths. Parameters ---------- entity_path: A list of strings to escape and join with slash. Returns ------- str: The escaped entity path. )r4r2r3)rr>s& rr3r3\s0* x''{(K{tT{(KL MM(Ks9 ) __future__rcollections.abcrpathlibrtypingrrrerun_bindingsr2 _baseclassesr error_utilsr r pyarrowpar r recording_streamr r+r)rIrNrQr3rrrr^s"$%!&IJ1t t )- t  ttnN N )- Nd-&*- - )- --b3&* 3  3 )- 33l7,Nr