From 5e7824ab69469babc7f2ac9603b2485476f77263 Mon Sep 17 00:00:00 2001 From: Wouter Horlings Date: Thu, 21 Jan 2021 13:38:41 +0100 Subject: [PATCH] Move copied text to includes --- content/appendix_specifications.tex | 20 +--- content/appendix_test_cases.tex | 101 ++++++++------------- content/case_experiment_specifications.tex | 14 +-- content/case_experiment_test_protocol.tex | 43 +-------- content/input/speclista.tex | 8 ++ content/input/speclistb.tex | 4 + content/input/speclistc.tex | 5 + content/input/systemtest1.tex | 19 ++++ content/input/systemtest6.tex | 18 ++++ 9 files changed, 104 insertions(+), 128 deletions(-) create mode 100644 content/input/speclista.tex create mode 100644 content/input/speclistb.tex create mode 100644 content/input/speclistc.tex create mode 100644 content/input/systemtest1.tex create mode 100644 content/input/systemtest6.tex diff --git a/content/appendix_specifications.tex b/content/appendix_specifications.tex index 0c820bd..fb960e5 100644 --- a/content/appendix_specifications.tex +++ b/content/appendix_specifications.tex @@ -3,23 +3,9 @@ \begin{specification} \begin{enumerate} \setlength{\itemsep}{10pt} - \item The Writer shall be able to write at least fifty characters per line. - \item The Writer shall be able to write at least three of text. - \item The Writer shall plot characters with a size that is readable from 4 meters for a person with good eyesight. - \item The Writer shall plot in a regular used font with corresponding character spacing. - \item When a new tweet is send to the Writer, the Writer, shall wipe the existing tweet and write down the new tweet. - \item If the Writer is not wiping or writing then the Writer shall not obstruct the view of the whiteboard. - \item While writing, the Writer shall have a writing speed of at least one character per second. - \item The dynamics of the Writer shall be complex/sophisticated/interesting. - \item If the Writer is tasked to wipe the tweet, the Writer shall wipe the tweet within sixty seconds - \item When a reset-signal is send to the Writer, the Writer shall recalibrate its position on the board. - \item When a wipe-signal is send to the Writer, the Writer shall wipe the board clean. - \item The Writer shall not damage itself. - \item While writing, the SCARA shall have a writing speed of at least 1.5 characters per second. - \item When the Carriage/base of the SCARA is at a static position, the SCARA shall be able to write at least three characters at that position. \label{threecharspec} - \item When the SCARA finished writing at their current position, the Carriage shall move the SCARA to it's next position where it can write the subsequent characters. - \item When the SCARA has to be moved to a new position, the Carriage shall perform this movement within one second. - \item When the system changes from writing to wiping or vice-versa, the SCARA and End-effector should change the tool within ten seconds. + \input{content/input/speclista.tex} + \input{content/input/speclistb.tex} + \input{content/input/speclistc.tex} \end{enumerate} \end{specification} diff --git a/content/appendix_test_cases.tex b/content/appendix_test_cases.tex index 714e8a2..1122000 100644 --- a/content/appendix_test_cases.tex +++ b/content/appendix_test_cases.tex @@ -3,59 +3,41 @@ \setcounter{testcounter}{0} \begin{test}[label={test1}]{Small rectangle} - During this test, a rectangle will be drawn on the whiteboard using the SCARA. - This rectangle is will be at least \SI{50}{\milli\meter} high and \SI{70}{\milli\meter} wide, such that three characters fit within the rectangle. - To test the speed requirements, the rectangle should be drawn within one second. - \tcbline - \begin{description} - \item[Features:] SCARA - \item[Specifications:] 3, 7, 11, 13 - \item[Results:] The test passes when: - \begin{itemize} - \item Rectangle height is at least \SI{50}{\milli\meter} - \item Rectangle width is at least \SI{70}{\milli\meter} - \item Completion time is less than \SI{1}{\second} - \end{itemize} -% The SCARA must draw a square of at least \SI{50}{\milli\meter} high and \SI{70}{\milli\meter} wide. -% This box is large enough to draw at least 3 characters. -% This square should be drawn within one second. -% If it is slower than that, it is not able to achieve specification 7. - \end{description} + \input{content/input/systemtest1.tex} \end{test} \begin{test}[label={test_perimeter}]{Perimeter} - The carriage must move along the outer edges of the text area. + The Cable bot must move along the outer edges of the text area. This area consists of three lines of text with fifty characters each. - Resulting in perimeter of \SI{1000}{\milli\meter} wide and \SI{250}{\milli\meter} high. + Resulting in a perimeter of \SI{1000}{\milli\meter} wide and \SI{250}{\milli\meter} high. This proves that reach of the system is sufficient to write the text. - Furthermore, the carriage should move outside of the perimeter as well. - Moving outside of the text area is to prove that carriage has a position where it does not obstruct the written text. + Furthermore, the Cable bot should move outside of the perimeter as well. + Moving outside of the text area is to prove that Cable bot has a position where it does not obstruct the written text. \tcbline \begin{description} \item[Features:] Cable Bot - \item[Specifications:] 1, 2, 6, 11 + \item[Specifications:] 1, 2, 6, 11, (12) \item[Results:] The test passes when: \begin{itemize} - \item The carriage moved along the edge of the text area. - \item The carriage moved outside of the text area. + \item The Cable bot moved along the edge of the text area. + \item The Cable bot moved outside of the text area. \end{itemize} \end{description} \end{test} \begin{test}[label={test_speed_carriage}]{Cable Bot Speed} - The carriage must be able to move a distance of \SI{80}{\milli\meter} in horizontal direction to move within a second. - At the start and the end of the movement the speed of the carriage must be zero. - This is to ensure that the SCARA can then write its characters at the given position. - + The Cable bot must be able to move a distance of \SI{80}{\milli\meter} in horizontal direction within a second. + At the start and the end of the movement the speed of the Cable bot must be zero. + This is to ensure that the SCARA can then write three characters at the given position. \tcbline \begin{description} \item[Features:] Cable Bot - \item[Specifications:] 7, 14 + \item[Specifications:] 7, 9, (12), 14, 15, 16 \item[Results:] The test passes when: \begin{itemize} - \item At the start and end of the test, the carriage does not move relative to the board. - \item During the test, the carriage has moved \SI{80}{\milli\meter} within \SI{1}{\second}. + \item At the start and end of the test, the Cable bot does not move relative to the board. + \item During the test, the Cable bot has moved \SI{80}{\milli\meter} within \SI{1}{\second}. \end{itemize} \end{description} \end{test} @@ -63,31 +45,30 @@ \begin{test}[label={test_triple_char}]{Triple Chars} The SCARA together with the end-effector must write 3 characters without - moving the carriage. This extends on the small square but the + moving the Cable bot. This extends on the small rectangle of \autoref{test1} but the end-effector must now be able to lift the marker of the board. The three characters should be written on the board within two seconds. \tcbline \begin{description} \item[Features:] SCARA, End-Effector - \item[Specifications:] 3, 4, 12, 13 + \item[Specifications:] 3, 4, (12), 13, 14 \item[Results:] The test passes when: \begin{itemize} - \item The SCARA wrote three characters on the whiteboard within \SI{1}{\second}. - \item The carriage did not move more than \SI{10}{\milli\meter}. + \item The SCARA wrote three characters on the whiteboard within \SI{2}{\second}. + \item The Cable bot did not move more than \SI{10}{\milli\meter}. \end{itemize} \end{description} \end{test} \begin{test}[label={test_tool_change}]{Tool Change} - Tool changing is not a specific part of the specification. - However, the system has to switch in some way between the marker and a wiper, or a different color. + The system has to switch in some way between the marker and a wiper, or a different color. For this test the system must switch a tool within 10 seconds. \tcbline \begin{description} \item[Features:] SCARA, End-Effector - \item[Specifications:] 16 + \item[Specifications:] (5), (12), 17 \item[Results:] The test passes when: \begin{itemize} \item A tool is released from the end-effector and stored for later use. @@ -99,25 +80,8 @@ \begin{test}[label={test_repeat}]{Repeatability} - This tests if the Writer can reach draw repeatedly on the same position on the board. - The system will start with drawing multiple \SI{60}{\milli\meter} squares on the board in a random location. - To test the repeatability, a circle with a \SI{55}{\milli\meter} diameter must be drawn inside of the square. - This should be done with twenty squares in an area of at least \SI{1000}{\milli\meter} x \SI{300}{\milli\meter}. - The drawing order of each square must be different from the drawing order of circles, this ensures that the Cable bot makes a different approach path. - \tcbline - \begin{description} - \item[Features:] SCARA, Cable Bot - \item[Specifications:] 3, 4, 9, 11 - \item[Results:] - The test passes when: - \begin{itemize} - \item Each square has a circle drawn inside. - \item The squares and circles are within \SI{5}{\milli\meter} of their given dimensions. - \item All the circles are completely within their corresponding square. - \end{itemize} - \end{description} + \input{content/input/systemtest6.tex} \end{test} - \begin{test}[label={test_linear}]{Linearity} The system must draw a grid on the drawing range (\SI{1000}{\milli\meter} x \SI{300}{\milli\meter}), with the horizontal and vertical lines spaces \SI{100}{\milli\meter} from each other. @@ -126,7 +90,7 @@ \tcbline \begin{description} \item[Features:] SCARA, End-Effector, Cable Bot - \item[Specifications:] + \item[Specifications:] 1, 2, 3, (12) \item[Results:] The test passes when: \begin{itemize} \item All lines are drawn, 11 vertical and 4 horizontal lines. @@ -154,7 +118,7 @@ the quick brown fox jumps over the lazy dog!?@,.- \tcbline \begin{description} \item[Features:] SCARA, End-Effector, Cable Bot - \item[Specifications:] 1, 2, 3, 4, 6, 7, 11, 12, 13, 14, 15 + \item[Specifications:] 1, 2, 3, 4, (5), 6, 7, 12, 13, 14, 15, 16 \item[Results:] The test passes when: \begin{itemize} \item The text as described is readable from a atleast \SI{4}{\meter} distance. @@ -166,14 +130,29 @@ the quick brown fox jumps over the lazy dog!?@,.- \begin{test}[label={test_wiping}]{Wiping} The complete board must be cleared of any marking within 60 seconds. This is without the change of tool. - \tcbline \begin{description} \item[Features:] SCARA, End-Effector, Cable Bot - \item[Specifications:] 8, 10, 5 + \item[Specifications:] (5), 10, 11, 12 \item[Results:] The test passes when: \begin{itemize} \item The system cleaned the board within \SI{60}{\second}. \end{itemize} \end{description} \end{test} + + \begin{test}[label={test:compexity}]{Complexity} + The last test is that the design has to be complex enough. + This has to be evaluated by the developer of the system. + \tcbline + \begin{description} + \item[Features:] SCARA, End-Effector, Cable Bot + \item[Specifications:] 8 + \item[Results:] The test passes when: + \begin{itemize} + \item The developer can motivate that the system is complex enough to evaluate the case study. + \end{itemize} + \end{description} + \end{test} + + diff --git a/content/case_experiment_specifications.tex b/content/case_experiment_specifications.tex index d1b5cda..4e4fe90 100644 --- a/content/case_experiment_specifications.tex +++ b/content/case_experiment_specifications.tex @@ -16,14 +16,7 @@ \begin{specification} \begin{enumerate} \setlength{\itemsep}{10pt} - \item The Writer shall be able to write at least fifty characters per line. - \item The Writer shall be able to write at least three of text. - \item The Writer shall plot characters with a size that is readable from 4 meters for a person with good eyesight. - \item The Writer shall plot in a regular used font with corresponding character spacing. - \item When a new tweet is send to the Writer, the Writer, shall wipe the existing tweet and write down the new tweet. - \item If the Writer is not wiping or writing then the Writer shall not obstruct the view of the whiteboard. - \item While writing, the Writer shall have a writing speed of at least one character per second. - \item The dynamics of the Writer shall be complex/sophisticated/interesting. + \input{content/input/speclista.tex} \end{enumerate} \end{specification} Some other specifications that are related to the operation of the system are: @@ -31,10 +24,7 @@ \begin{enumerate} \setcounter{enumi}{8} \setlength{\itemsep}{10pt} - \item If the Writer is tasked to wipe the tweet, the Writer shall wipe the tweet within sixty seconds - \item When a reset-signal is send to the Writer, the Writer shall recalibrate its position on the board. - \item When a wipe-signal is send to the Writer, the Writer shall wipe the board clean. - \item The Writer shall not damage itself. + \input{content/input/speclistb.tex} \end{enumerate} \end{specification} diff --git a/content/case_experiment_test_protocol.tex b/content/case_experiment_test_protocol.tex index 44615ff..1210388 100644 --- a/content/case_experiment_test_protocol.tex +++ b/content/case_experiment_test_protocol.tex @@ -41,11 +41,7 @@ \begin{specification} \begin{enumerate} \setcounter{enumi}{12} - \item While writing, the SCARA shall have a writing speed of at least 1.5 characters per second. - \item When the Carriage/base of the SCARA is at a static position, the SCARA shall be able to write at least three characters at that position. - \item When the SCARA finished writing at their current position, the Carriage shall move the SCARA to it's next position where it can write the subsequent characters. - \item When the SCARA has to be moved to a new position, the Carriage shall perform this movement within one second. - \item When the system changes from writing to wiping or vice-versa, the SCARA and End-effector should change the tool within ten seconds. + \input{content/input/speclistc.tex} \end{enumerate} \end{specification} These additional specifications are also based on the combined system decission that was made in section \autoref{sec:initialdesign}. @@ -60,42 +56,13 @@ One of the small tests focusses on the speed and range requirements of the SCARA: \setcounter{testcounter}{0} - \begin{test}[label={rect}]{Small rectangle} - During this test, a rectangle will be drawn on the whiteboard using the SCARA. - This rectangle is will be at least \SI{50}{\milli\meter} high and \SI{70}{\milli\meter} wide, such that three characters fit within the rectangle. - To test the speed requirements, the rectangle should be drawn within one second. - \tcbline - \begin{description} - \item[Features:] SCARA - \item[Specifications:] 3, 7, 11, 13 - \item[Results:] The test passes when: - \begin{itemize} - \item Rectangle height is at least \SI{50}{\milli\meter} - \item Rectangle width is at least \SI{70}{\milli\meter} - \item Completion time is less than \SI{1}{\second} - \end{itemize} - \end{description} + \begin{test}{Small rectangle} + \input{content/input/systemtest1.tex} \end{test} Repeatability is tested in one of the large system wide tests: \setcounter{testcounter}{5} - \begin{test}[label={rep}]{Repeatability} - This tests if the Writer can reach draw repeatedly on the same position on the board. - The system will start with drawing multiple \SI{60}{\milli\meter} squares on the board in a random location. - To test the repeatability, a circle with a \SI{55}{\milli\meter} diameter must be drawn inside of the square. - This should be done with twenty squares in an area of at least \SI{1000}{\milli\meter} x \SI{300}{\milli\meter}. - The drawing order of each square must be different from the drawing order of circles, this ensures that the Cable bot makes a different approach path. - \tcbline - \begin{description} - \item[Features:] SCARA, Cable Bot - \item[Specifications:] 3, 4, 9, 11 - \item[Results:] - The test passes when: - \begin{itemize} - \item Each square has a circle drawn inside. - \item The squares and circles are within \SI{5}{\milli\meter} of their given dimensions. - \item All the circles are completely within their corresponding square. - \end{itemize} - \end{description} + \begin{test}{Repeatability} + \input{content/input/systemtest6.tex} \end{test} The complete set of system tests is included in \autoref{app:test_specification}. diff --git a/content/input/speclista.tex b/content/input/speclista.tex new file mode 100644 index 0000000..18540a8 --- /dev/null +++ b/content/input/speclista.tex @@ -0,0 +1,8 @@ +\item The Writer must be able to write at least fifty characters per line. +\item The Writer must be able to write at least three lines of text. +\item The Writer must plot characters with a size that is readable from 4 meters for a person with good eyesight. +\item The Writer must plot in a regular used font with corresponding character spacing. +\item When a new tweet is send to the Writer, the Writer must wipe the existing tweet and write down the new tweet. +\item If the Writer is not wiping or writing then the Writer must not obstruct the view of the whiteboard. +\item While writing, the Writer must have a writing speed of at least one character per second. +\item The dynamics of the Writer must be complex/sophisticated/interesting. diff --git a/content/input/speclistb.tex b/content/input/speclistb.tex new file mode 100644 index 0000000..fdb03bd --- /dev/null +++ b/content/input/speclistb.tex @@ -0,0 +1,4 @@ +\item If the Writer is tasked to wipe the tweet, the Writer must wipe the tweet within sixty seconds +\item When a reset-signal is send to the Writer, the Writer must recalibrate its position on the board. +\item When a wipe-signal is send to the Writer, the Writer must wipe the board clean. +\item The Writer must not damage itself. diff --git a/content/input/speclistc.tex b/content/input/speclistc.tex new file mode 100644 index 0000000..a2309e9 --- /dev/null +++ b/content/input/speclistc.tex @@ -0,0 +1,5 @@ +\item While writing, the SCARA must have a writing speed of at least 1.5 characters per second. +\item When the Carriage/base of the SCARA is at a static position, the SCARA shall be able to write at least three characters at that position. +\item When the SCARA finished writing at their current position, the Cable bot shall move the SCARA to it's next position where it can write the subsequent characters. +\item When the SCARA has to be moved to a new position, the Cable bot shall perform this movement within one second. +\item When the system changes from writing to wiping or vice-versa, the SCARA and End-effector should change the tool within ten seconds. diff --git a/content/input/systemtest1.tex b/content/input/systemtest1.tex new file mode 100644 index 0000000..b17a96d --- /dev/null +++ b/content/input/systemtest1.tex @@ -0,0 +1,19 @@ + + During this test, a rectangle will be drawn on the whiteboard using the SCARA. + This rectangle is \SI{50}{\milli\meter} high and \SI{70}{\milli\meter} wide, such that three characters fit within the rectangle. + To test the speed requirements, the rectangle should be drawn within one second. + \tcbline + \begin{description} + \item[Features:] SCARA + \item[Specifications:] 3, 7, 11, 13, 14 + \item[Results:] The test passes when: + \begin{itemize} + \item Rectangle height is at least \SI{50}{\milli\meter} + \item Rectangle width is at least \SI{70}{\milli\meter} + \item Completion time is less than \SI{1}{\second} + \end{itemize} +% The SCARA must draw a square of at least \SI{50}{\milli\meter} high and \SI{70}{\milli\meter} wide. +% This box is large enough to draw at least 3 characters. +% This square should be drawn within one second. +% If it is slower than that, it is not able to achieve specification 7. + \end{description} diff --git a/content/input/systemtest6.tex b/content/input/systemtest6.tex new file mode 100644 index 0000000..40da6ca --- /dev/null +++ b/content/input/systemtest6.tex @@ -0,0 +1,18 @@ + + This tests if the Writer can draw repeatedly on the same position, for different approach angles, on the board. + The system will start with drawing multiple \SI{60}{\milli\meter} squares on the board in a random location. + To test the repeatability, a circle with a \SI{55}{\milli\meter} diameter must be drawn inside of the square. + This should be done with twenty squares in an area of at least \SI{1000}{\milli\meter} x \SI{300}{\milli\meter}. + The drawing order of each square must be different from the drawing order of circles, this ensures that the Cable bot makes a different approach path. + \tcbline + \begin{description} + \item[Features:] SCARA, Cable Bot + \item[Specifications:] 3, 4, 9, 11, (12) + \item[Results:] + The test passes when: + \begin{itemize} + \item Each square has a circle drawn inside. + \item The squares and circles are within \SI{5}{\milli\meter} of their given dimensions. + \item All the circles are completely within their corresponding square. + \end{itemize} + \end{description}