% ----------------------------------------------------------------------------
% function hfssCreateRelativeCS(fid, Name, Origin, Units)
% 
% Description :
% -------------
% Create a relative Coordinate System at "origin" point relative to the
% Global Coordinate System.
%
% Parameters :
% ------------
% fid     - file identifier of the HFSS script file.
% Name    -
% Origin  - point relative to the Global Coordinate System where the
%           Relative Coordinate System will be created.
% Units   - units of the points (specify using either 'in', 'mm', 'meter'
%           or anything else defined in HFSS).
% 
% Note :
% ------
% Use this function to facilitate drawing stuff. To return to use
% another CS (i.e. the Global CS), you can use the function hfssSetWCS
%
% Example :
% ---------
% fid = fopen('myantenna.vbs', 'wt');
% ...
% hfssInsertDesign(fid, 'Dipole_SingleElement');
% ----------------------------------------------------------------------------

% ----------------------------------------------------------------------------
% Written by Daniel R. Prado
% danysan@gmail.com / drprado@tsc.uniovi.es
% 20 September 2012
% ----------------------------------------------------------------------------

function hfssCreateRelativeCS(fid, Name, Origin, Units)

% arguments processor.
if (nargin < 4)
	error('Insufficient number of arguments !');
end

% Preamble.
fprintf(fid, '\n');
fprintf(fid, 'oEditor.CreateRelativeCS _\n');

% CS Parameters
fprintf(fid, 'Array("NAME:RelativeCSParameters", _\n');
fprintf(fid, '"OriginX:=", "%.4f%s", _\n', Origin(1), Units);
fprintf(fid, '"OriginY:=", "%.4f%s", _\n', Origin(2), Units);
fprintf(fid, '"OriginZ:=", "%.4f%s", _\n', Origin(3), Units);
fprintf(fid, '"XAxisXvec:=", "1%s", _\n', Units);
fprintf(fid, '"XAxisYvec:=", "0%s", _\n', Units);
fprintf(fid, '"XAxisZvec:=", "0%s", _\n', Units);
fprintf(fid, '"YAxisXvec:=", "0%s", _\n', Units);
fprintf(fid, '"YAxisYvec:=", "1%s", _\n', Units);
fprintf(fid, '"YAxisZvec:=", "0%s"), _\n', Units);

% CS Attributes
fprintf(fid, 'Array("NAME:Attributes", _\n');
fprintf(fid, '"Name:=", "%s")\n', Name);