% MICROCRE teaching simulation: Roundness harmonics and first-order removal % NOT EXECUTED IN MATLAB/Octave in the authoring environment. % Python/SciPy counterpart has been run; see validation-report.json. % Standalone MATLAB R2016b+ script (local functions); no extra toolbox required. % Edit p below, run this file, inspect outputs and assumptions before use. % Formula: r−R=e cosθ+a₂cos2θ+a₃cos(3θ+φ);a_n=(2/N)Σr_jcos(nθ_j) % Assumption: 720点覆盖360°,不重复终点;完整均匀角采样使谐波正交。 % Limitation: 仅演示傅里叶分量去除,不是完整非线性最小二乘圆或最小区域圆。 % Limitation: 未模拟主轴误差分离、滤波截止与探针误差,不能作圆度验收。 % Source: https://itl.nist.gov/div898/handbook/mpc/section3/mpc344.htm % Source: https://itl.nist.gov/div898/handbook/mpc/section3/mpc3442.htm % This is not product performance, calibration, or compliance evidence. clear; close all; clc; p.radius = 10; % 标称半径 [mm] p.eccentricity = 3; % 一阶分量 [µm] p.amplitude2 = 1; % 二阶幅值 [µm] p.amplitude3 = 0.5; % 三阶幅值 [µm] p.phase = 30; % 三阶相位 [degree] assert(isfinite(p.radius) && p.radius>=0.001 && p.radius<=1000, 'Invalid radius'); assert(isfinite(p.eccentricity) && p.eccentricity>=-1000 && p.eccentricity<=1000, 'Invalid eccentricity'); assert(isfinite(p.amplitude2) && p.amplitude2>=0 && p.amplitude2<=1000, 'Invalid amplitude2'); assert(isfinite(p.amplitude3) && p.amplitude3>=0 && p.amplitude3<=1000, 'Invalid amplitude3'); assert(isfinite(p.phase) && p.phase>=-180 && p.phase<=180, 'Invalid phase'); theta=(0:719)*2*pi/720; phase=p.phase*pi/180; assert(p.radius*1000>abs(p.eccentricity)+abs(p.amplitude2)+abs(p.amplitude3),'Nominal radius is too small.'); raw=p.eccentricity*cos(theta)+p.amplitude2*cos(2*theta)+p.amplitude3*cos(3*theta+phase); a0=mean(raw); a1=2*mean(raw.*cos(theta)); b1=2*mean(raw.*sin(theta)); corrected=raw-a0-a1*cos(theta)-b1*sin(theta); lines=[s('Raw radial deviation',theta*180/pi,raw,'degree','um'),s('First harmonic removed',theta*180/pi,corrected,'degree','um')]; out=struct('radial_span',max(corrected)-min(corrected),'rms',sqrt(mean(corrected.^2)),'first_harmonic',hypot(a1,b1)); outdir=fullfile(pwd,'roundness-harmonics_results'); if ~exist(outdir,'dir'),mkdir(outdir);end fid=fopen(fullfile(outdir,'roundness-harmonics.csv'),'w'); assert(fid>=0,'Cannot open CSV'); fprintf(fid,'series,x,y,x_unit,y_unit\n'); for j=1:numel(lines) for k=1:numel(lines(j).x) fprintf(fid,'"%s",%.17g,%.17g,"%s","%s"\n',lines(j).name,lines(j).x(k),lines(j).y(k),lines(j).xu,lines(j).yu); end end fclose(fid); fig=figure('Color','w');hold on; for j=1:numel(lines) if lines(j).plot,plot(lines(j).x,lines(j).y,'LineWidth',1.5,'DisplayName',lines(j).name);end end grid on;legend('show','Location','best');xlabel(lines(1).xu);ylabel(lines(1).yu); title('Roundness harmonics and first-order removal','Interpreter','none'); print(fig,fullfile(outdir,'roundness-harmonics.png'),'-dpng','-r160'); fid=fopen(fullfile(outdir,'roundness-harmonics-summary.json'),'w');fprintf(fid,'%s',jsonencode(struct('inputs',p,'outputs',out,'notice','Teaching model; not product validation.')));fclose(fid); disp(out); function a=s(name,x,y,xu,yu) a=struct('name',name,'x',x,'y',y,'xu',xu,'yu',yu,'plot',true); end function q=qlinear(values,p) v=sort(values); pos=p*(numel(v)-1); k=floor(pos)+1; f=pos-floor(pos); if k==numel(v),q=v(k);else,q=v(k)*(1-f)+v(k+1)*f;end end