code: def warp(
      ctx,
      files,
      output,
      driver,
      like,
      dst_crs,
      dimensions,
      src_bounds,
      dst_bounds,
      res,
      resampling,
      src_nodata,
      dst_nodata,
      threads,
      check_invert_proj,
      overwrite,
      creation_options,
      target_aligned_pixels,
      warper_options,
      dry_run,
  ):
      """
      Warp a raster dataset.
  
      If a template raster is provided using the --like option, the
      coordinate reference system, affine transform, and dimensions of
      that raster will be used for the output.  In this case --dst-crs,
      --bounds, --res, and --dimensions options are not applicable and
      an exception will be raised.
  
      \b
          $ rio warp input.tif output.tif --like template.tif
  
      The destination's coordinate reference system may be an authority
      name, PROJ4 string, JSON-encoded PROJ4, or WKT.
  
      \b
          --dst-crs EPSG:4326
          --dst-crs '+proj=longlat +ellps=WGS84 +datum=WGS84'
          --dst-crs '{"proj": "utm", "zone": 18, ...}'
  
      If --dimensions are provided, --res and --bounds are not applicable
      and an exception will be raised.  Resolution is calculated based on
      the relationship between the raster bounds in the target coordinate
      system and the dimensions, and may produce rectangular rather than
      square pixels.
  
      \b
          $ rio warp input.tif output.tif --dimensions 100 200 \\
          > --dst-crs EPSG:4326
  
      If --bounds are provided, --res is required if --dst-crs is provided
      (defaults to source raster resolution otherwise).
  
      \b
          $ rio warp input.tif output.tif \\
          > --bounds -78 22 -76 24 --res 0.1 --dst-crs EPSG:4326
  
      """
      output, files = resolve_inout(
          files=files, output=output, overwrite=overwrite
      )
  
      resampling = Resampling[resampling]  # get integer code for method
  
      if not len(res):
          # Click sets this as an empty tuple if not provided
          res = None
      else:
          # Expand one value to two if needed
          res = (res[0], res[0]) if len(res) == 1 else res
  
      if target_aligned_pixels:
          if not res:
              raise click.BadParameter(
                  "--target-aligned-pixels requires a specified resolution"
              )
  
      # Check invalid parameter combinations
      if like:
          invalid_combos = (dimensions, dst_bounds, dst_crs, res)
          if any(p for p in invalid_combos if p is not None):
              raise click.BadParameter(
                  "--like cannot be used with any of --dimensions, --bounds, "
                  "--dst-crs, or --res"
              )
  
      elif dimensions:
          invalid_combos = (dst_bounds, res)
          if any(p for p in invalid_combos if p is not None):
              raise click.BadParameter(
                  "--dimensions cannot be used with --bounds or --res"
              )
  
      with ctx.obj["env"]:
          setenv(CHECK_WITH_INVERT_PROJ=check_invert_proj)
  
          with rasterio.open(files[0]) as src:
              left, bottom, right, top = src.bounds
  
              out_kwargs = src.profile
              out_kwargs.pop("driver", None)
              if driver:
                  out_kwargs["driver"] = driver
  
              # Sort out the bounds options.
              if src_bounds and dst_bounds:
                  raise click.BadParameter(
                      "--src-bounds and destination --bounds may not be "
                      "specified simultaneously."
                  )
  
              if like:
                  with rasterio.open(like) as template_ds:
                      dst_crs = template_ds.crs
                      dst_transform = template_ds.transform
                      dst_height = template_ds.height
                      dst_width = template_ds.width
  
              elif dst_crs is not None:
                  try:
                      dst_crs = CRS.from_string(dst_crs)
                  except ValueError as err:
                      raise click.BadParameter(
                          str(err),
                          param="dst_crs",
                          param_hint="dst_crs",
                      )
  
                  if dimensions:
                      # Calculate resolution appropriate for dimensions
                      # in target.
                      dst_width, dst_height = dimensions
                      bounds = src_bounds or src.bounds
                      try:
                          xmin, ymin, xmax, ymax = transform_bounds(
                              src.crs, dst_crs, *bounds
                          )
                      except CRSError as err:
                          raise click.BadParameter(
                              str(err),
                              param="dst_crs",
                              param_hint="dst_crs",
                          )
                      dst_transform = Affine(
                          (xmax - xmin) / float(dst_width),
                          0,
                          xmin,
                          0,
                          (ymin - ymax) / float(dst_height),
                          ymax,
                      )
  
                  elif src_bounds or dst_bounds:
                      if not res:
                          raise click.BadParameter(
                              "Required when using --bounds.",
                              param="res",
                              param_hint="res",
                          )
  
                      if src_bounds:
                          try:
                              xmin, ymin, xmax, ymax = transform_bounds(
                                  src.crs, dst_crs, *src_bounds
                              )
                          except CRSError as err:
                              raise click.BadParameter(
                                  str(err),
                                  param="dst_crs",
                                  param_hint="dst_crs",
                              )
                      else:
                          xmin, ymin, xmax, ymax = dst_bounds
  
                      dst_transform = Affine(
                          res[0], 0, xmin, 0, -res[1], ymax
                      )
                      dst_width = max(
                          int(ceil((xmax - xmin) / res[0])), 1
                      )
                      dst_height = max(
                          int(ceil((ymax - ymin) / res[1])), 1
                      )
  
                  else:
                      try:
                          if src.transform.is_identity and src.gcps:
                              src_crs = src.gcps[1]
                              kwargs = {"gcps": src.gcps[0]}
                          else:
                              src_crs = src.crs
                              kwargs = src.bounds._asdict()
                          dst_transform, dst_width, dst_height = calcdt(
                              src_crs,
                              dst_crs,
                              src.width,
                              src.height,
                              resolution=res,
                              **kwargs,
                              **warper_options,
                          )
                      except CRSError as err:
                          raise click.BadParameter(
                              str(err),
                              param="dst_crs",
                              param_hint="dst_crs",
                          )
  
              elif dimensions:
                  # Same projection, different dimensions, calculate resolution.
                  dst_crs = src.crs
                  dst_width, dst_height = dimensions
                  l, b, r, t = src_bounds or (left, bottom, right, top)
                  dst_transform = Affine(
                      (r - l) / float(dst_width),
                      0,
                      l,
                      0,
                      (b - t) / float(dst_height),
                      t,
                  )
  
              elif src_bounds or dst_bounds:
                  # Same projection, different dimensions and possibly
                  # different resolution.
                  if not res:
                      res = (src.transform.a, -src.transform.e)
  
                  dst_crs = src.crs
                  xmin, ymin, xmax, ymax = src_bounds or dst_bounds
                  dst_transform = Affine(
                      res[0], 0, xmin, 0, -res[1], ymax
                  )
                  dst_width = max(int(round((xmax - xmin) / res[0])), 1)
                  dst_height = max(
                      int(round((ymax - ymin) / res[1])), 1
                  )
  
              elif res:
                  # Same projection, different resolution.
                  dst_crs = src.crs
                  dst_transform = Affine(
                      res[0], 0, left, 0, -res[1], top
                  )
                  dst_width = max(
                      int(round((right - left) / res[0])), 1
                  )
                  dst_height = max(
                      int(round((top - bottom) / res[1])), 1
                  )
  
              else:
                  dst_crs = src.crs
                  inv_transform = ~src.transform
                  eps = sys.float_info.epsilon
                  c1, r1 = inv_transform * (left + eps, top + eps)
                  c2, r2 = inv_transform * (right + eps, top + eps)
                  c3, r3 = inv_transform * (right + eps, bottom + eps)
                  c4, r4 = inv_transform * (left + eps, bottom + eps)
                  col1 = min(c1, c2, c3, c4)
                  col2 = max(c1, c2, c3, c4)
                  row1 = min(r1, r2, r3, r4)
                  row2 = max(r1, r2, r3, r4)
                  col1 = floor(col1)
                  col2 = ceil(col2)
                  row1 = floor(row1)
                  row2 = ceil(row2)
                  px = (right - left) / (col2 - col1)
                  py = (top - bottom) / (row2 - row1)
                  res = max(px, py)
                  dst_width = max(int(round((right - left) / res)), 1)
                  dst_height = max(int(round((top - bottom) / res)), 1)
                  dst_transform = Affine.translation(
                      left, top
                  ) * Affine.scale(res, -res)
  
              if target_aligned_pixels:
                  dst_transform, dst_width, dst_height = aligned_target(
                      dst_transform, dst_width, dst_height, res
                  )
  
              # If src_nodata is not None, update the dst metadata NODATA
              # value to src_nodata (will be overridden by dst_nodata if it is not None
              if src_nodata is not None:
                  # Update the dst nodata value
                  out_kwargs.update(nodata=src_nodata)
  
              # Validate a manually set destination NODATA value
              # against the input datatype.
              if dst_nodata is not None:
                  if src_nodata is None and src.meta["nodata"] is None:
                      raise click.BadParameter(
                          "--src-nodata must be provided because dst-nodata is not None"
                      )
                  else:
                      # Update the dst nodata value
                      out_kwargs.update(nodata=dst_nodata)
  
              out_kwargs.update(
                  crs=dst_crs,
                  transform=dst_transform,
                  width=dst_width,
                  height=dst_height,
              )
  
              # Adjust block size if necessary.
              if "blockxsize" in out_kwargs and dst_width < int(
                  out_kwargs["blockxsize"]
              ):
                  del out_kwargs["blockxsize"]
                  logger.warning(
                      "Blockxsize removed from creation options to accomodate small output width"
                  )
              if "blockysize" in out_kwargs and dst_height < int(
                  out_kwargs["blockysize"]
              ):
                  del out_kwargs["blockysize"]
                  logger.warning(
                      "Blockxsize removed from creation options to accomodate small output height"
                  )
  
              out_kwargs.update(**creation_options)
  
              if dry_run:
                  crs = out_kwargs.get("crs", None)
                  if crs:
                      epsg = src.crs.to_epsg()
                      if epsg:
                          out_kwargs["crs"] = "EPSG:{}".format(epsg)
                      else:
                          out_kwargs["crs"] = src.crs.to_string()
  
                  click.echo("Output dataset profile:")
                  click.echo(json.dumps(dict(**out_kwargs), indent=2))
              else:
                  with rasterio.open(output, "w", **out_kwargs) as dst:
                      reproject(
                          source=rasterio.band(
                              src, list(range(1, src.count + 1))
                          ),
                          destination=rasterio.band(
                              dst, list(range(1, src.count + 1))
                          ),
                          src_transform=src.transform,
                          src_crs=src.crs,
                          src_nodata=src_nodata,
                          dst_transform=out_kwargs["transform"],
                          dst_crs=out_kwargs["crs"],
                          dst_nodata=dst_nodata,
                          resampling=resampling,
                          num_threads=threads,
                          **warper_options,
                      )
  
file_path: rasterio/rasterio/rio/warp.py
imports: import json
  import logging
  from math import ceil, floor
  import sys
  import click
  import rasterio
  from rasterio.crs import CRS
  from rasterio.env import setenv
  from rasterio.errors import CRSError
  from rasterio.rio import options
  from rasterio.rio.helpers import resolve_inout
  from rasterio.rio.options import _cb_key_val
  from rasterio.transform import Affine
  from rasterio.warp import reproject, Resampling, SUPPORTED_RESAMPLING, transform_bounds, aligned_target, calculate_default_transform
label_desc: Use image node_id 1 for calling a global function with example usage: warp(ctx, files, output, driver, like, dst_crs, dimensions, src_bounds, dst_bounds, res, resampling, src_nodata, dst_nodata, threads, check_invert_proj, overwrite, creation_options, target_aligned_pixels, warper_options, dry_run) without return types