From 5e2a1ebfe20a2ac1eb9ed70bd393dc6e941b0102 Mon Sep 17 00:00:00 2001 From: AIK Mechatronische Systeme - Factory Acceptance Tests Date: Mon, 26 Oct 2026 16:58:04 +0100 Subject: [PATCH] Initial commit --- ECMC/runCommands.txt | 13 + Encoder/README.md | 7 + Measurements/README.md | 7 + Media/README.md | 16 + Motor/README.md | 7 + README.md | 23 ++ Report/AGENTS.md | 102 +++++++ Report/Linear_Stage_FAT_Report_Template.tex | 323 ++++++++++++++++++++ 8 files changed, 498 insertions(+) create mode 100644 ECMC/runCommands.txt create mode 100644 Encoder/README.md create mode 100644 Measurements/README.md create mode 100644 Media/README.md create mode 100644 Motor/README.md create mode 100644 README.md create mode 100644 Report/AGENTS.md create mode 100644 Report/Linear_Stage_FAT_Report_Template.tex diff --git a/ECMC/runCommands.txt b/ECMC/runCommands.txt new file mode 100644 index 0000000..bb7122b --- /dev/null +++ b/ECMC/runCommands.txt @@ -0,0 +1,13 @@ +------------------------------------ +#Copy files from ioc to lx-term +scp -r user@slslc:/ioc/hosts/aik-motion-pc5/temp_control /home/user/Documents +----------------------------------- +#Expose PVs +export EPICS_CA_ADDR_LIST=aik-motion-pc5 +------------------------------------ +#Open ECMC/GUI +caqtdm -macro IOC=aik-motion-pc5 ecmcMain.ui +------------------------------------ +#Run IOC command +sudo iocsh -7.0.9 startup.cmd +------------------------------------ \ No newline at end of file diff --git a/Encoder/README.md b/Encoder/README.md new file mode 100644 index 0000000..1d3af70 --- /dev/null +++ b/Encoder/README.md @@ -0,0 +1,7 @@ +# Encoder evidence + +Use this folder for project-specific evidence about the stage encoder and its interface. Preserve source files and record the exact model, revision, resolution, scaling, and interface details from traceable sources. + +Include relevant manufacturer documentation, configuration records, and calibration or measurement evidence when available. Distinguish encoder resolution and configured scaling from measured minimum incremental motion, repeatability, accuracy, and measurement uncertainty. + +The report instructions are in [`../Report/AGENTS.md`](../Report/AGENTS.md). The report image for the encoder belongs in `../Media/` as `I2` with a supported image extension; do not substitute a different component image. diff --git a/Measurements/README.md b/Measurements/README.md new file mode 100644 index 0000000..63af4fb --- /dev/null +++ b/Measurements/README.md @@ -0,0 +1,7 @@ +# Measurement evidence + +Place the original measurement report PDFs for this FAT in this folder. The report workflow attaches every PDF present here as complete appendix pages, so include only evidence intended for the report and retain the original filenames and contents. + +Keep raw data and analysis files here when they are part of the project evidence. In the report, list each raw and analysis file by its exact basename. Do not rely on a file count alone. Identify failed, superseded, or anomalous runs and explain their status in the report; do not silently omit them. + +Before report preparation, confirm that each PDF is the correct, complete source and that applicable acceptance criteria, calibration status, and uncertainty evidence are available. See [`../Report/AGENTS.md`](../Report/AGENTS.md) for the full workflow. diff --git a/Media/README.md b/Media/README.md new file mode 100644 index 0000000..ddf2b68 --- /dev/null +++ b/Media/README.md @@ -0,0 +1,16 @@ +# FAT report images + +Place the six images referenced by the report template in this folder using these exact basenames (case-sensitive): + +| Basename | Required subject | +| --- | --- | +| `I1` | Overall linear stage; appears first and on report page 1 | +| `I2` | Encoder | +| `I3` | Motor or actuator | +| `I4` | Coupling | +| `I5` | General FAT setup, view 1 | +| `I6` | General FAT setup, view 2 | + +Use `.jpg`, `.jpeg`, `.png`, or `.pdf` as the extension. For example, `I1.jpg` is valid. The basename-to-subject mapping is mandatory: do not guess, rename, or substitute an image when the correct evidence is missing. Keep source photographs unchanged and visually verify that each image shows the assigned subject. + +See [`../Report/AGENTS.md`](../Report/AGENTS.md) for report preparation and image validation requirements. diff --git a/Motor/README.md b/Motor/README.md new file mode 100644 index 0000000..1573dc6 --- /dev/null +++ b/Motor/README.md @@ -0,0 +1,7 @@ +# Motor or actuator evidence + +Use this folder for project-specific evidence about the linear stage motor or actuator. Preserve source files and record the exact model and revision from a traceable source such as a nameplate photograph or manufacturer document. + +Include relevant manufacturer documentation, wiring or connection details, and verified project settings when available. Keep commanded values, configured limits, measured results, and specifications clearly distinguished. Do not treat a nominal specification or configuration file as proof of FAT performance. + +The report instructions are in [`../Report/AGENTS.md`](../Report/AGENTS.md). The report image for the motor or actuator belongs in `../Media/` as `I3` with a supported image extension; do not substitute a different component image. diff --git a/README.md b/README.md new file mode 100644 index 0000000..79767d9 --- /dev/null +++ b/README.md @@ -0,0 +1,23 @@ +# Linear Stage Factory Acceptance Test (FAT) + +This repository is a starting point for preparing a project-specific factory acceptance test report for a linear stage. The report template and its required workflow are in [`Report/`](Report/). + +## Repository layout + +- [`Report/`](Report/) — LaTeX report template and report-specific instructions in `AGENTS.md`. +- [`Measurements/`](Measurements/) — source measurement reports in PDF format. The report workflow appends every PDF in this folder to the report. +- [`Media/`](Media/) — the six report images, named exactly `I1` through `I6` with `.jpg`, `.jpeg`, `.png`, or `.pdf` extensions. +- [`Motor/`](Motor/) — motor or actuator identification and supporting project evidence. +- [`Encoder/`](Encoder/) — encoder identification and supporting project evidence. +- [`ECMC/`](ECMC/) — project-specific ECMC configuration and notes, if applicable. `runCommands.txt` contains example commands and host paths; verify and adapt them before use. + +## Start a new FAT repository + +1. Create a separate project repository from this template and preserve the template files. +2. Add project evidence to the appropriate folders. Record exact equipment models, revisions, settings, acceptance criteria, test conditions, results, and evidence filenames. +3. Add the six correctly mapped images to `Media/`: `I1` overall stage, `I2` encoder, `I3` motor or actuator, `I4` coupling, `I5` FAT setup view 1, and `I6` FAT setup view 2. Do not rename or substitute images to satisfy a missing image requirement. +4. Add the measurement and analysis PDFs to `Measurements/`. Keep original evidence files intact. +5. Read [`Report/AGENTS.md`](Report/AGENTS.md) before creating or updating a report. It defines the evidence requirements, template rules, compilation, and page-by-page visual validation workflow. +6. Create a project-specific report from `Report/Linear_Stage_FAT_Report_Template.tex`; do not overwrite the template. Keep all checklist response fields blank for the user. + +The template is not evidence that a particular stage has been tested or accepted. A report disposition must be supported by applicable acceptance criteria and traceable results, calibration, and uncertainty evidence. diff --git a/Report/AGENTS.md b/Report/AGENTS.md new file mode 100644 index 0000000..5e2b413 --- /dev/null +++ b/Report/AGENTS.md @@ -0,0 +1,102 @@ +# Linear Stage FAT Report Instructions + +These instructions apply to report work inside this `Report` folder and supplement the project-root `AGENTS.md`. + +When the user asks the agent to read the instructions and create or update the report, execute this workflow end to end: inspect the available evidence, prepare the report, compile it twice, append the measurement PDFs, visually validate every page, clean the output folder, and deliver the final `.tex` and `.pdf` files. Do not stop after producing a draft. + +## Purpose and authoritative template + +- Use `unused/Linear_Stage_FAT_Report_Template.tex` as the authoritative baseline for future factory acceptance test reports for linear stages. If the template is later restored to the `Report` root, use that copy instead. +- Create a new project-specific `.tex` file. Do not overwrite the template or a completed report unless the user explicitly requests it. +- Keep generated report files and report-only working files inside `Report`. Treat `Measurements`, `Media`, `ECMC`, `Mechanical`, and other adjacent folders as read-only evidence sources unless the user separately authorizes changes. +- Preserve the template's wording, section order, tables, fonts, spacing, captions, page layout, and overall formatting. Change template text only where verified project-specific information must be inserted. + +## Evidence and privacy gate + +- Follow the data-privacy stop rule in the root `AGENTS.md` before processing sensitive information. +- Read the complete relevant source files before drawing conclusions. +- Use this evidence priority: signed test records and raw data; exact manufacturer documentation; approved project requirements and procedures; configuration files and logs; photographs; operator notes. +- Record the source of every important model number, setting, limit, result, uncertainty, and conclusion. +- Never infer physical performance from commanded motion, a writable PV, nominal encoder resolution, or a configuration file alone. +- Preserve uncertainty and conflicts, but never write `TBD` in the issued report and never invent a value. Leave an unsupported optional value blank or omit only the value while preserving the surrounding layout. State a material evidence limitation objectively when it affects interpretation. + +## Required preparation + +1. Inventory the available evidence by exact filename and file type. +2. Confirm that the six required report images are present in `../Media` with the exact basenames `I1` through `I6` and one supported extension: `.jpg`, `.jpeg`, `.png`, or `.pdf`. +3. Confirm the exact stage, encoder, motor or actuator, drive, encoder interface, controller, firmware or revision where relevant, measurement system, calibration status, and test dates. If no exact stage model is available, omit or leave the model value blank; do not guess it and do not insert a placeholder. +4. Extract the applicable acceptance criteria before evaluating results. +5. Separate measured results, calculated values, manufacturer specifications, assumptions, and open points. +6. Confirm which tests apply. Do not mark checklist fields, including with `N/A`; if applicability must be explained, state it in the report narrative without completing the user checklist. + +## Report construction rules + +- Do not leave `TBD`, template instructions, or placeholder text anywhere in the final source or PDF. Populate supported values from evidence; otherwise leave optional values blank or omit only the unsupported value without disturbing the template layout. +- Use SI units by default and preserve original units where traceability requires them. +- Distinguish command resolution, encoder resolution, minimum incremental motion, repeatability, accuracy, stability, and measurement uncertainty. +- State test direction, orientation, payload, travel, velocity, acceleration, settling criterion, cycle count, point count, sampling conditions, and environmental conditions when applicable. +- Keep the five-column checklist format: `Item | Checklist Item | Yes | No | Remarks`. +- Leave every checklist response completely blank. Do not select Yes or No, add checkmarks or crosses, complete remarks, or infer checklist completion from the evidence. Only the user may fill the checklists. +- Size the `Checklist Item` column consistently to the longest checklist sentence; let `Remarks` fill the remaining width. +- Keep checklist headings with their tables. Do not leave orphaned subsection headings. +- Verify every image visually. Captions must describe what the image actually shows. Do not infer a test setup from a component close-up. +- List every raw and analysis file by exact basename using `\path{...}`. Counts alone are insufficient. +- Integrate measured results into `Conclusions`; do not create a separate chapter that duplicates them. +- Conclusions must compare measured values with acceptance criteria and state the disposition. Avoid unsupported terms such as “excellent.” +- Include deviations, unresolved risks, required retests, responsible owner, and due date where applicable. +- Update `Document History` for each issued revision. + +## Figures and appendices + +- Use project-relative paths such as `../Media/...` and `../Measurements/...`. +- The image basename and content mapping is mandatory: + - `I1`: overall linear-stage image; this is always the first image and must appear on page 1. + - `I2`: encoder. + - `I3`: motor or actuator. + - `I4`: coupling. + - `I5`: general FAT setup, view 1. + - `I6`: general FAT setup, view 2. +- The user must provide the images with these exact basenames. Accept only `.jpg`, `.jpeg`, `.png`, or `.pdf` extensions unless the template is explicitly revised. +- Match image basenames case-sensitively in the report source. Do not use descriptive filenames, suffixes, or numbering variants such as `I1_stage`, `image1`, or `I01`. +- Do not guess, rename, or substitute a different image when `I1` through `I6` is missing. Leave the generated missing-image placeholder visible, report the missing basename to the user, and wait for the correct file when the report is intended for issue. +- Visually inspect all six images before accepting the mapping. A filename alone does not prove the content is correct. +- Preserve original evidence files. Do not crop, edit, or overwrite source photographs or measurement PDFs unless explicitly authorized. +- Confirm each figure label and every `\ref{...}` after compilation. +- Attach every PDF in `../Measurements` at the end of the report as complete appendix pages. Preserve the original page content, list the PDFs in the same order as their inclusions, and use a logical evidence order such as positioning followed by horizontal and vertical straightness. +- Scale appended PDF pages uniformly when necessary so that titles, plots, analysis tables, and page edges are fully visible. Do not annotate, crop, or alter the measurement PDFs. +- Do not silently omit failed, superseded, or anomalous runs. Identify their status and explain their exclusion or disposition. + +## Validation workflow + +1. Compile the project-specific `.tex` file with the built-in LaTeX compiler when available. Otherwise, from `Report`, create a temporary `build` directory and use `pdflatex -interaction=nonstopmode -halt-on-error -synctex=0 -aux-directory=build .tex`. This keeps `.aux` and `.log` files out of the main report folder and prevents `.synctex.gz` generation. +2. Run at least two LaTeX passes when labels or references changed. +3. Treat compilation, content verification, and visual verification as separate checks. +4. Inspect the log for errors, undefined references, missing files, and overfull boxes. +5. Render every report page to images and inspect margins, tables, line wrapping, headings, captions, page numbers, and appendix transitions. +6. Confirm that every filename printed in the report exists in the evidence inventory. +7. Search the final `.tex` and rendered PDF for `TBD`, placeholder instructions, and unintended filled checklist fields; none may remain. +8. Confirm that every PDF from `../Measurements` is attached at the end and that no appended page is clipped. +9. Confirm that no files outside `Report` were modified. +10. After successful validation, remove the temporary `build` directory and all temporary render files. The main `Report` folder must not contain `.aux`, `.log`, `.synctex`, or QA image files. +11. Keep the final project-specific `.tex`, final PDF, and `AGENTS.md` in the `Report` root. Create or retain `unused` and move superseded reports, unused templates, and report-only temporary artifacts there. Do not delete or move source evidence from adjacent folders. +12. Deliver both the project-specific `.tex` source and compiled PDF. State the final page count, appended measurement PDFs, completed validation, and any unverified runtime, hardware, calibration, or deployment condition explicitly. +13. Use one decimal place for all values expressed in microns (µm). + +## Minimum completion criteria + +A report is not complete until: + +- no `TBD`, template instructions, or placeholder text remains; +- all checklist response fields remain blank for the user; +- exact hardware identity and source revisions are recorded; +- acceptance criteria are traceable; +- results and uncertainty are reported with units; +- every conclusion is supported by evidence; +- raw and analysis filenames are listed exactly; +- images `I1` through `I6` exist, appear in the required order, and match their assigned subjects; +- figures and captions match; +- references resolve; +- every PDF in `Measurements` is appended completely at the end without clipping; +- the `Report` root contains no LaTeX auxiliary or temporary QA files; +- the latest PDF compiles and passes full-page visual inspection; and +- changes are confined to the authorized folder boundary. diff --git a/Report/Linear_Stage_FAT_Report_Template.tex b/Report/Linear_Stage_FAT_Report_Template.tex new file mode 100644 index 0000000..ec12da8 --- /dev/null +++ b/Report/Linear_Stage_FAT_Report_Template.tex @@ -0,0 +1,323 @@ +\documentclass[11pt,a4paper]{article} +\usepackage[T1]{fontenc} +\usepackage[utf8]{inputenc} +\usepackage{lmodern} +\usepackage{microtype} +\usepackage[a4paper,margin=22mm]{geometry} +\usepackage{graphicx} +\usepackage{tabularx} +\usepackage{array} +\usepackage{enumitem} +\usepackage{amssymb} +\usepackage{pdfpages} +\usepackage{xurl} + +\pagestyle{plain} +\setlength{\parindent}{0pt} +\setlength{\parskip}{0.5em} +\renewcommand{\arraystretch}{1.3} +\widowpenalty=10000 +\clubpenalty=10000 + +\newcommand{\TBD}{\textbf{TBD}} +\newcommand{\StageModel}{\TBD} +\newcommand{\EncoderModel}{\TBD} +\newcommand{\MotorModel}{\TBD} +\newcommand{\DriveModel}{\TBD} +\newcommand{\EncoderInterface}{\TBD} +\newcommand{\Controller}{\TBD} +\newcommand{\MeasurementSystem}{\TBD} +\newcommand{\TestLocation}{\TBD} +\newcommand{\TestDates}{\TBD} +\newcommand{\TestOperator}{\TBD} +\newcommand{\TravelRange}{\TBD} +\newcommand{\ReportVersion}{0.1} +\newcommand{\ReportDate}{\today} + +% Required image basenames in ../Media: I1 through I6. +% Supported extensions: .jpg, .jpeg, .png, and .pdf. +\newcommand{\imageorplaceholder}[2][55mm]{% + \IfFileExists{#2.jpg}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.jpg}}{% + \IfFileExists{#2.jpeg}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.jpeg}}{% + \IfFileExists{#2.png}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.png}}{% + \IfFileExists{#2.pdf}{\includegraphics[width=\linewidth,height=#1,keepaspectratio]{#2.pdf}}{% + \fbox{\parbox[c][#1][c]{0.92\linewidth}{\centering Required image not found\\\path{#2.[jpg|jpeg|png|pdf]}}}}}}}} + +\newlength{\checklistitemwidth} +\settowidth{\checklistitemwidth}{\small Measurement system calibrated} + +\title{\textbf{Linear Stage Factory Acceptance Test Report}} +\author{\TestLocation} +\date{\TestDates} + +\begin{document} +\maketitle + +\begin{figure}[htbp] +\centering +\begin{minipage}{0.90\textwidth} +\centering +\imageorplaceholder[65mm]{../Media/I1} +\end{minipage} +\caption{\StageModel\ linear stage during FAT testing} +\label{fig:I1_stage} +\end{figure} + +\begin{tabularx}{\textwidth}{|l|X|} +\hline +\textbf{Equipment} & \StageModel \\ \hline +\textbf{Encoder} & \EncoderModel \\ \hline +\textbf{Motor} & \MotorModel \\ \hline +\textbf{Drive} & \DriveModel \\ \hline +\textbf{Location} & \TestLocation \\ \hline +\textbf{Dates} & \TestDates \\ \hline +\textbf{Operator} & \TestOperator \\ \hline +\textbf{Applicable standards} & \TBD \\ \hline +\end{tabularx} + +\textbf{Executive summary:} \TBD. State the tested scope, achieved results, deviations, and disposition. Do not declare acceptance without traceable evidence. + +\clearpage +\section{FAT Checklists} + +\subsection{Pre-Test Safety} +\begin{center}\small +\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|} +\hline +\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline +2.1 & Risk assessment conducted & $\square$ & $\square$ & \\ \hline +2.2 & Safety barriers in place & $\square$ & $\square$ & \\ \hline +2.3 & E-stop functional & $\square$ & $\square$ & \\ \hline +2.4 & Equipment grounded & $\square$ & $\square$ & \\ \hline +2.5 & Personnel briefed & $\square$ & $\square$ & \\ \hline +2.6 & Cable routing safe & $\square$ & $\square$ & \\ \hline +2.7 & Environmental conditions OK & $\square$ & $\square$ & \\ \hline +\end{tabularx} +\end{center} + +\subsection{Equipment Verification} +\begin{center}\small +\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|} +\hline +\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline +3.1 & Stage model verified & $\square$ & $\square$ & \\ \hline +3.2 & Encoder model verified & $\square$ & $\square$ & \\ \hline +3.3 & Motor model verified & $\square$ & $\square$ & \\ \hline +3.4 & Drive model verified & $\square$ & $\square$ & \\ \hline +3.5 & Encoder interface verified & $\square$ & $\square$ & \\ \hline +3.6 & Measurement system calibrated & $\square$ & $\square$ & \\ \hline +3.7 & Documentation available & $\square$ & $\square$ & \\ \hline +3.8 & Calibration certificates valid & $\square$ & $\square$ & \\ \hline +\end{tabularx} +\end{center} + +\subsection{Mechanical and Electrical Checks} +\begin{center}\small +\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|} +\hline +\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline +4.1 & Mounting interfaces verified & $\square$ & $\square$ & \\ \hline +4.2 & Travel unobstructed & $\square$ & $\square$ & \\ \hline +4.3 & End stops functional & $\square$ & $\square$ & \\ \hline +4.4 & Cable carrier movement OK & $\square$ & $\square$ & \\ \hline +4.5 & Encoder alignment checked & $\square$ & $\square$ & \\ \hline +4.6 & Motor coupling secure & $\square$ & $\square$ & \\ \hline +4.7 & Supply voltage verified & $\square$ & $\square$ & \\ \hline +4.8 & Signal connections verified & $\square$ & $\square$ & \\ \hline +4.9 & Ground continuity checked & $\square$ & $\square$ & \\ \hline +4.10 & No abnormal noise or vibration & $\square$ & $\square$ & \\ \hline +\end{tabularx} +\end{center} + +\clearpage +\subsection{Control System Verification} +\begin{center}\small +\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|} +\hline +\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline +5.1 & Communication established & $\square$ & $\square$ & \\ \hline +5.2 & Drive parameters verified & $\square$ & $\square$ & \\ \hline +5.3 & Encoder scaling verified & $\square$ & $\square$ & \\ \hline +5.4 & Current or force limit verified & $\square$ & $\square$ & \\ \hline +5.5 & Homing or referencing functional & $\square$ & $\square$ & \\ \hline +5.6 & Software limits configured & $\square$ & $\square$ & \\ \hline +5.7 & E-stop response verified & $\square$ & $\square$ & \\ \hline +5.8 & Motion profile verified & $\square$ & $\square$ & \\ \hline +5.9 & Closed-loop stability verified & $\square$ & $\square$ & \\ \hline +5.10 & Following error acceptable & $\square$ & $\square$ & \\ \hline +\end{tabularx} +\end{center} + +\subsection{Test Execution} +\begin{center}\small +\begin{tabularx}{\textwidth}{|p{8mm}|p{\checklistitemwidth}|c|c|X|} +\hline +\textbf{Item} & \textbf{Checklist Item} & \textbf{Yes} & \textbf{No} & \textbf{Remarks} \\ \hline +6.1 & Measurement system aligned & $\square$ & $\square$ & \\ \hline +6.2 & Environmental compensation set & $\square$ & $\square$ & \\ \hline +6.3 & Test parameters recorded & $\square$ & $\square$ & \\ \hline +6.4 & Required cycles completed & $\square$ & $\square$ & \\ \hline +6.5 & Raw data saved & $\square$ & $\square$ & \\ \hline +6.6 & Analysis files generated & $\square$ & $\square$ & \\ \hline +6.7 & Environmental data logged & $\square$ & $\square$ & \\ \hline +6.8 & All configurations tested & $\square$ & $\square$ & \\ \hline +\end{tabularx} +\end{center} + +\clearpage +\section{Hardware and Configuration} +\begin{tabularx}{\textwidth}{>{\bfseries}p{45mm}X} +\hline +Component & Verified specification \\ \hline +Stage & \StageModel \\ +Travel & \TravelRange \\ +Encoder & \EncoderModel \\ +Encoder interface & \EncoderInterface \\ +Encoder resolution and scaling & \TBD \\ +Motor or actuator & \MotorModel \\ +Drive & \DriveModel \\ +Controller and control mode & \Controller \\ +Measurement system & \MeasurementSystem \\ \hline +\end{tabularx} + +\begin{figure}[htbp] +\centering +\begin{minipage}[b]{0.32\textwidth} +\centering +\imageorplaceholder[45mm]{../Media/I2} +\caption{Encoder} +\label{fig:I2_encoder} +\end{minipage} +\hfill +\begin{minipage}[b]{0.32\textwidth} +\centering +\imageorplaceholder[45mm]{../Media/I3} +\caption{Motor} +\label{fig:I3_motor} +\end{minipage} +\hfill +\begin{minipage}[b]{0.32\textwidth} +\centering +\imageorplaceholder[45mm]{../Media/I4} +\caption{Motor coupling} +\label{fig:I4_coupling} +\end{minipage} +\end{figure} + +\begin{figure}[htbp] +\centering +\begin{minipage}[b]{0.48\textwidth} +\centering +\imageorplaceholder[65mm]{../Media/I5} +\caption{General FAT setup - view 1} +\label{fig:I5_setup1} +\end{minipage} +\hfill +\begin{minipage}[b]{0.48\textwidth} +\centering +\imageorplaceholder[65mm]{../Media/I6} +\caption{General FAT setup - view 2} +\label{fig:I6_setup2} +\end{minipage} +\end{figure} + +\clearpage +\section{Test Description and Acceptance Criteria} +\subsection{Applicable Standards and Procedures} +\begin{itemize} +\item \TBD: standard, edition, and applicable clauses +\item \TBD: internal procedure and revision +\item \TBD: measurement-system operating procedure and revision +\end{itemize} + +\subsection{Positioning Test} +\begin{itemize} +\item Travel and target positions: \TBD +\item Number and direction of cycles: \TBD +\item Velocity, acceleration, and settling criterion: \TBD +\item Tested orientations and control modes: \TBD +\item Accuracy and repeatability acceptance limits: \TBD +\end{itemize} + +\subsection{Straightness and Additional Tests} +\begin{itemize} +\item Straightness planes, range, and point spacing: \TBD +\item Bidirectional repeatability, reversal error, and minimum incremental motion: \TBD +\item Additional load, velocity, thermal, vibration, or endurance tests: \TBD +\item Acceptance limits: \TBD +\end{itemize} + +\section{Environmental Conditions} +\begin{tabularx}{\textwidth}{lXXXX} +\hline +Test & Temperature ($^\circ$C) & Pressure & Humidity (\%) & Notes \\ \hline +Positioning & \TBD & \TBD & \TBD & \TBD \\ +Straightness & \TBD & \TBD & \TBD & \TBD \\ +Additional test & \TBD & \TBD & \TBD & \TBD \\ \hline +\end{tabularx} + +\clearpage +\section{Test Files and Data} +List every delivered file by exact basename. Add or remove entries to match the actual evidence set. + +\subsection{Raw Files} +\begin{itemize} +\item \path{TBD_positioning_raw_file.ext} +\item \path{TBD_straightness_raw_file.ext} +\item \path{TBD_environment_log.ext} +\end{itemize} + +\subsection{Analysis Files} +\begin{itemize} +\item \path{TBD_positioning_analysis.pdf} +\item \path{TBD_straightness_analysis.pdf} +\end{itemize} + +\section{Conclusions} +\subsection{Positioning} +\begin{itemize} +\item Measured results and uncertainty: \TBD +\item Acceptance criterion: \TBD +\item Disposition: \TBD +\end{itemize} + +\subsection{Straightness and Additional Tests} +\begin{itemize} +\item Measured results and uncertainty: \TBD +\item Acceptance criterion: \TBD +\item Disposition: \TBD +\end{itemize} + +\subsection{Overall FAT Conclusion} +\TBD. State accepted, conditionally accepted, or rejected; list deviations, open actions, owners, and due dates. Do not convert missing evidence into a passing result. + +\section*{References} +\begin{itemize} +\item \TBD: stage manufacturer document, number, and revision +\item \TBD: encoder, motor, drive, and controller documents and revisions +\item \TBD: standards and procedures +\item \TBD: calibration certificates +\end{itemize} + +\clearpage +\section*{Document History} +\begin{center} +\begin{tabularx}{\textwidth}{|l|l|X|} +\hline +Date & Version & Description \\ \hline +\ReportDate & \ReportVersion & Initial project-specific report generated from template \\ \hline +\end{tabularx} +\end{center} + +\section*{Appendix: Measurement Analysis Files} +List the attached analysis documents in their included order. Uncomment and replace each command only after confirming that the referenced PDF exists. + +\begin{itemize} +\item \path{TBD_positioning_analysis.pdf} +\item \path{TBD_straightness_analysis.pdf} +\end{itemize} + +% Example: +% \includepdf[pages=-,fitpaper=true,pagecommand={\pagestyle{plain}}]{../Measurements/TBD_positioning_analysis.pdf} + +\end{document}