.. _auto_curves_three_point_circle:

*CURVES THREE POINT CIRCLE*
===========================

Computes a circle from three 3-D points (XYZ vectors) and returns the requested geometric quantity — circle center coordinates, radius, or diameter. Use this worker whenever you need to characterise a circular arc or cross-section from three known spatial points in a workflow.

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

Classification: **process**.

Tagged: ``circle``, ``curve_transform``, ``diameter``, ``geometry``, ``radius``, ``three_point_circle``, ``vector``, ``xyz``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Point 1 XYZ
     - point1xy_z
     - vector
     - —
     - 
     - First of the three points that define the circle, supplied as a 3-component XYZ vector (e.g. [x, y, z] in model length units).
   * - Point 2 XYZ
     - point2xy_z
     - vector
     - —
     - 
     - Second of the three points that define the circle, supplied as a 3-component XYZ vector (e.g. [x, y, z] in model length units).
   * - Point 3 XYZ
     - point3xy_z
     - vector
     - —
     - 
     - Third of the three points that define the circle, supplied as a 3-component XYZ vector (e.g. [x, y, z] in model length units); the three points must be non-collinear.
   * - Return Type
     - return_type
     - float
     - circle-xyz
     - 
     - Selects what the worker returns: 'circle-xyz' (default) outputs the centre-point coordinates, 'radius' outputs the scalar radius, and 'diameter' outputs the scalar diameter; leave at default when only the centre location is needed.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_three_point_circle_output_1
     - curves_three_point_circle_output_1
     - vector
     - Computed result as a vector: the circle centre XYZ coordinates when return_type is 'circle-xyz', or a scalar vector containing the radius or diameter (in model length units) when return_type is 'radius' or 'diameter'.

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

- data.curve.transform

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

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

.. raw:: html

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