.. _auto_curve_vary_xy_at_x:

*CURVE VARY XY AT X*
====================

Generates a family of curves by simultaneously varying both the X position and the Y value at a specified X coordinate on a base curve, sweeping over user-defined ranges and step sizes. Use this worker to explore how joint perturbations of an X location and its corresponding Y value affect curve shape — useful for sensitivity studies or design-space sampling on curve data.

When to use
-----------

Classification: **process**.

Tagged: ``curve``, ``curve_family``, ``parametric_sweep``, ``sensitivity``, ``transformations``, ``variation``, ``xy_perturbation``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Base Curve
     - base_curve
     - vector
     - —
     - 
     - The reference curve (X-Y vector) that will be modified; all generated variants are derived from this baseline shape.
   * - X
     - x
     - scalar
     - —
     - 
     - The nominal X coordinate at which both X-position and Y-value perturbations are anchored; leave null to rely solely on min_x/max_x sweep bounds.
   * - Min X
     - min_x
     - scalar
     - —
     - 
     - Lower bound of the X-position sweep range (same units as the base curve's X axis); defines where the X variation starts.
   * - Max X
     - max_x
     - scalar
     - —
     - 
     - Upper bound of the X-position sweep range (same units as the base curve's X axis); defines where the X variation ends.
   * - Step Size X
     - step_sizefor_x
     - scalar
     - —
     - 
     - Increment between successive X-position values in the sweep (same units as the X axis); smaller values produce finer resolution but more output curves.
   * - Min Y
     - min_y
     - scalar
     - —
     - 
     - Lower bound of the Y-value sweep range at the target X location (same units as the base curve's Y axis).
   * - Max Y
     - max_y
     - scalar
     - —
     - 
     - Upper bound of the Y-value sweep range at the target X location (same units as the base curve's Y axis).
   * - Step Size Y
     - step_sizefor_y
     - scalar
     - —
     - 
     - Increment between successive Y values in the sweep (same units as the Y axis); smaller values produce finer resolution but more output curves.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - curve_vary_xy_at_x_output_1
     - curve_vary_xy_at_x_output_1
     - vector
     - Collection of varied curves (X-Y vectors), one per (X-position, Y-value) combination in the Cartesian sweep grid, preserving the shape of the base curve outside the varied point.

Disciplines
-----------

- data.curve.transform
- design_exploration.doe
- design_exploration.sensitivity

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curve_vary_xy_at_x <https://www.d3view.com/api/workflow/example?id=curve_vary_xy_at_x>`_

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>curve_vary_xy_at_x</code>. Schema hash: <code>a1298e891fa8</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>