class_docstr: Container for a digitization point.
  
  This is a simple subclass of the standard dict type designed to provide
  a readable string representation.
  
  Parameters
  ----------
  kind : int
      The kind of channel,
      e.g. ``FIFFV_POINT_EEG``, ``FIFFV_POINT_CARDINAL``.
  r : array, shape (3,)
      3D position in m. and coord_frame.
  ident : int
      Number specifying the identity of the point.
      e.g.  ``FIFFV_POINT_NASION`` if kind is ``FIFFV_POINT_CARDINAL``,
      or 42 if kind is ``FIFFV_POINT_EEG``.
  coord_frame : int
      The coordinate frame used, e.g. ``FIFFV_COORD_HEAD``.
class_docstr_tok: ["Container","for","a","digitization","point",".","This","is","a","simple","subclass","of","the","standard","dict","type","designed","to","provide","a","readable","string","representation",".","Parameters","--","--","--","--","--","kind",":","int","The","kind","of","channel",",","e.g",".","``","FIFFV_POINT_EEG","``",",","``","FIFFV_POINT_CARDINAL","``",".","r",":","array",",","shape","(","3",",",")","3D","position","in","m.","and","coord_frame",".","ident",":","int","Number","specifying","the","identity","of","the","point",".","e.g",".","``","FIFFV_POINT_NASION","``","if","kind","is","``","FIFFV_POINT_CARDINAL","``",",","or","42","if","kind","is","``","FIFFV_POINT_EEG","``",".","coord_frame",":","int","The","coordinate","frame","used",",","e.g",".","``","FIFFV_COORD_HEAD","``","."]
code: def __repr__(self):  # noqa: D105
      from ..transforms import _coord_frame_name
  
      if self["kind"] == FIFF.FIFFV_POINT_CARDINAL:
          id_ = _cardinal_kind_rev.get(
              self["ident"], "Unknown cardinal"
          )
      else:
          id_ = _dig_kind_proper[
              _dig_kind_rev.get(self["kind"], "unknown")
          ]
          id_ = f"{id_} #{self['ident']}"
      id_ = id_.rjust(10)
      cf = _coord_frame_name(self["coord_frame"])
      x, y, z = self["r"]
      if "voxel" in cf:
          pos = (f"({x:0.1f}, {y:0.1f}, {z:0.1f})").ljust(25)
      else:
          pos = (
              f"({x * 1e3:0.1f}, {y * 1e3:0.1f}, {z * 1e3:0.1f}) mm"
          ).ljust(25)
      return f"<DigPoint | {id_} : {pos} : {cf} frame>"
  
imports: import heapq
  from collections import Counter
  import numpy
  from ..utils import Bunch, _check_fname, _validate_type, logger, verbose, warn
  from .constants import FIFF, _coord_frame_named
  from .tag import read_tag
  from .tree import dir_tree_find
  from .write import start_and_end_file, write_dig_points
label_desc: Use image node_id 1 for calling the DigPoint obj's underlying member method code with example usage: obj.__repr__() and returns: str, id_, str, pos, str, cf, str