code: def write_image(
      fig,
      file,
      format=None,
      scale=None,
      width=None,
      height=None,
      validate=True,
      engine="auto",
  ):
      """
      Convert a figure to a static image and write it to a file or writeable
      object
  
      Parameters
      ----------
      fig:
          Figure object or dict representing a figure
  
      file: str or writeable
          A string representing a local file path or a writeable object
          (e.g. an open file descriptor)
  
      format: str or None
          The desired image format. One of
            - 'png'
            - 'jpg' or 'jpeg'
            - 'webp'
            - 'svg'
            - 'pdf'
            - 'eps' (Requires the poppler library to be installed and on the PATH)
  
          If not specified and `file` is a string then this will default to the
          file extension. If not specified and `file` is not a string then this
          will default to:
              - `plotly.io.kaleido.scope.default_format` if engine is "kaleido"
              - `plotly.io.orca.config.default_format` if engine is "orca"
  
      width: int or None
          The width of the exported image in layout pixels. If the `scale`
          property is 1.0, this will also be the width of the exported image
          in physical pixels.
  
          If not specified, will default to:
              - `plotly.io.kaleido.scope.default_width` if engine is "kaleido"
              - `plotly.io.orca.config.default_width` if engine is "orca"
  
      height: int or None
          The height of the exported image in layout pixels. If the `scale`
          property is 1.0, this will also be the height of the exported image
          in physical pixels.
  
          If not specified, will default to:
              - `plotly.io.kaleido.scope.default_height` if engine is "kaleido"
              - `plotly.io.orca.config.default_height` if engine is "orca"
  
      scale: int or float or None
          The scale factor to use when exporting the figure. A scale factor
          larger than 1.0 will increase the image resolution with respect
          to the figure's layout pixel dimensions. Whereas as scale factor of
          less than 1.0 will decrease the image resolution.
  
          If not specified, will default to:
              - `plotly.io.kaleido.scope.default_scale` if engine is "kaleido"
              - `plotly.io.orca.config.default_scale` if engine is "orca"
  
      validate: bool
          True if the figure should be validated before being converted to
          an image, False otherwise.
  
      engine: str
          Image export engine to use:
           - "kaleido": Use Kaleido for image export
           - "orca": Use Orca for image export
           - "auto" (default): Use Kaleido if installed, otherwise use orca
  
      Returns
      -------
      None
      """
      # Check if file is a string
      # -------------------------
      file_is_str = isinstance(file, string_types)
  
      # Infer format if not specified
      # -----------------------------
      if file_is_str and format is None:
          _, ext = os.path.splitext(file)
          if ext:
              format = ext.lstrip(".")
          else:
              raise ValueError(
                  """
  Cannot infer image type from output path '{file}'.
  Please add a file extension or specify the type using the format parameter.
  For example:
  
      >>> import plotly.io as pio
      >>> pio.write_image(fig, file_path, format='png')
  """.format(
                      file=file
                  )
              )
  
      # Request image
      # -------------
      # Do this first so we don't create a file if image conversion fails
      img_data = to_image(
          fig,
          format=format,
          scale=scale,
          width=width,
          height=height,
          validate=validate,
          engine=engine,
      )
  
      # Open file
      # ---------
      if file_is_str:
          with open(file, "wb") as f:
              f.write(img_data)
      else:
          file.write(img_data)
  
file_path: catboost/contrib/python/plotly/py2/plotly/io/_kaleido.py
imports: from __future__ import absolute_import
  from six import string_types
  import os
  import json
  import plotly
  from plotly.io._utils import validate_coerce_fig_to_dict
label_desc: Use image node_id 2 for calling a global function with example usage: write_image(fig, file, format, scale, width, height, validate, engine) without return types