File Exchange

image thumbnail

ellipse3D

version 1.0.0.0 (3.28 KB) by William Martin
Generates the coordinates of an ellipse in 3D space and can optionally plot it.

11 Downloads

Updated 25 Jun 2012

View License

%% Definition
%
% Ellipse3D generates a three row, single column vector that holds the
% coordinates of an ellipse in 3D space and can optionally plot it.
%
% Generation of the ellipse coordinates occurs via the following
% methodology:
%
% 1. Plot an ellipse on the XY plane with semimajor axis of radius rx
% along X axis and semimajor axis of radius ry along Y axis
%
% 2. Rotate ellipse CCW about X axis by 'pitch' radians. 0 leaves ellipse
% on XY plane. pi/2 rotates CCW about positive X-axis and puts ellipse
% on XZ plane
%
% 3. Rotate ellipse CCW about Y axis by 'roll' radians. 0 leaves
% ellipse on XY plane. pi/2 rotates CCW about positive Y-axis and puts
% ellipse on YZ plane
%
% 4. Rotate ellipse CCW about Z axis by 'yaw'
% radians. 0 leaves ellipse on XY plane. pi/2 rotates CCW about
% positive Z-axis and (leaving ellipse on XY plane)
%
% 5. Apply offsets of x0, y0, and z0 to ellipse
%
% 6. Optionally generate 3D plot of ellipse
%
%% Inputs
%
% rx - length of radius of semimajor axis of ellipse along x-axis
% ry - length of radius of semimajor axis of ellipse along y-axis
% x0 - origin of ellipse with respect to x-axis
% y0 - origin of ellipse with respect to y-axis
% z0 - origin of ellipse with respect to z-axis
% Nb - number of points used to define ellipse
% pitch - angle of pitch in radians of ellipse wRt +x-axis
% roll - angle of roll in radians of ellipse wRt +y-axis
% yaw - angle of yaw in radians of ellipse wRt +z-axis
% graph - flag that tells function whether or not to graph.
% 0 - do not graph
% 1 - graph and let this function define graphing options
% >1 - graph, but allow other functions to define graphing options
% C - color of ellipse to be plotted. Acceptable input either in character
% form ('r') or RGB form ([0 .5 1])
%
%% Outputs
%
% ellipseCoords - holds coordinates of ellipse in form:
% [ X
% Y
% Z ]
% h - graphics handle of ellipse if graphed, 0 otherwise

%% Usage Examples
% ELLIPSE(rx,ry,x0,y0,z0) adds an on the XY plane ellipse with semimajor
% axis of rx, a semimajor axis of radius ry centered at the point x0,y0,z0.
%
% ELLIPSE(rx,ry,x0,y0,z0,Nb), Nb specifies the number of points
% used to draw the ellipse. The default value is 300. Nb may be used
% for each ellipse individually.
%
% ELLIPSE(rx,ry,x0,y0,z0,Nb, pitch,roll,yaw) adds an on the XY plane
% ellipse with semimajor axis of rx, a semimajor axis of radius ry centered
% at the point x0,y0,z0 and a pose in 3D space defined by roll, pitch, and
% yaw angles
%
% as a sample of how ellipse works, the following produces a red ellipse
% tipped up with a pitch of 45 degrees
% [coords, h] = ellipse3D(1,2,0,0,0,300,pi/4,0,0,1,'r');
%
% note that if rx=ry, ELLIPSE3D plots a circle
%

%% METADATA
% Author: William Martin
% Author Contact: wmartin8@utk.edu
% Institution: University of Tennessee, Knoxville
% Date Created: 6/22/2012
% Last Updated: 6/25/2012
% Inspiration:
% ellipse.m
% written by D.G. Long, Brigham Young University, based on the
% CIRCLES.m original
% written by Peter Blattner, Institute of Microtechnology, University of
% Neuchatel, Switzerland, blattner@imt.unine.ch

Cite As

William Martin (2021). ellipse3D (https://www.mathworks.com/matlabcentral/fileexchange/37304-ellipse3d), MATLAB Central File Exchange. Retrieved .

Comments and Ratings (6)

Zhongwei Yang

It works well, thanks. A small tip: could you add a function of linewidth. Anyway, we can plot3 the data afterward.

Zhongwei Yang

Rama Chhangte

Rama Chhangte

You might want to check the error on line 91.
"Error using ellipse3D (line 91)
Not enough arguments"

William Martin

Jay, could you elaborate on "not working"? I'd very much like to know the issue so that I can address it. What exactly are you trying to do and how is the function failing?

Jay Patel

Thanks for this file . . . It helped me in collage project . . . but it is not working

MATLAB Release Compatibility
Created with R2012a
Compatible with any release
Platform Compatibility
Windows macOS Linux
Categories

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!