View source for C457 Analysis

=Introduction=
An x-y stage, controller and software for conducting ASTM C457 Procedures A and B were developed for an MDOT Transportation Materials Research Center supplemental project in 2019. The stage is constructed from readily available components purchased from online retailers. A small number of structural elements were designed and fabricated to complete the stage. The system was designed with low-cost and ease of maintenance in mind, utilizing ballscrew actuators and an Arduino-based controller to drive the two NEMA17 stepper motors. The server operates on a Raspberry Pi and Franklin firmware is used for motion control. A common game controller is used to capture user input and control the stage. The user interface is provided over a web connection, supporting most internet browsers. The interface can be served over a local area network or a monitor, keyboard and mouse can be attached directly to the Raspberry Pi creating the standalone system.

Images in the following instructions can be clicked on to enlarge.

=Initial Settings=
==Organization==
Reports generated by the system include a letterhead containing organization details.
* [[File:c457_main_page.png|240px|right]] Click the "Organization Details" button.{{clear}}
* [[File:c457_org_details.png|240px|right]] Enter the organization details to include in report letterhead and click "Save".{{clear}}
* Organization details are stored on the server.

==Mapping Controller Buttons==
The actions performed by each of the numerous buttons on the game controller is configurable, and a button map is required to perform an analysis. The software will not permit performance of an analysis until at least one button map. Multiple button maps can be stored, allowing customization for each user if required. If only one button map is stored, it will be the default. If more button maps are stored, one of the maps can be designated as the default map and will be selected by default upon starting a new analysis. Users are presented with s election of maps if there are more than one.

ASTM C457 Procedure A requires only three counters, one each for paste, void and "other". Procedure B requires one additional counter "Void Intercept". Additional counters are available for Procedure B, if desired. The software will not permit a map to be saved if the four required counters for Procedure B are not assigned to buttons. "Void Intercept" and any optional Procedure B counters will be ignored when performing Procedure A.

An additional action, "Save Position" allows the user to save the stage position during an analysis. Saved positions will be listed in the main interface. Clicking a saved position will cause the stage move to that position.

* [[File:c457_btn_map.png|240px|right]] Click the "Map Controller Buttons" button.{{clear}}
* [[File:c457_btn_hilite.png|240px|right]] Press a button on the game controller. Note the button name is highlighted in the dialog box.{{clear}}
* [[File:c457_btn_select.png|240px|right]] Select the action to take when the button is pressed.{{clear}}
* [[File:c457_btn_map_name.png|240px|right]] Name the button map and click the "Save" button to save it.{{clear}}
* [[File:c457_btn_multiple.png|240px|right]] Button maps must have unique names. If more than one button map is available, the display will include a map selection at the top of the dialog and a checkbox to indicate the selected map is the default map. The default map cannot be deleted.{{clear}}

=Manual Control of Stage=
The stage can be controlled with the joysticks on the game controller when not running an analysis.

* Click the "Control Stage" button to enable control of the stage using the game controller's joysticks.
* Click "Cancel" when done with the stage.

=Running an Analysis=
An analysis is only possible after creating at least one button map.
* Click the "Start Analysis" button.{{clear}}
* [[File:c457_analysis_details.png|240px|right]] Choose the type of analysis to perform, Procedure A or B. Only the specimen Id text is required. Analysis conditions are determined by the top size of the aggregate. Ensure the proper top size is selected before continuing. Click "Continue" when ready.{{clear}}
* [[File:c457_analysis_corner1.png|240px|right]] Move the stage so that one corner of the analysis area is in the field of view and click the "A" button on the game controller. The "Continue" button will be displayed only after pressing the "A" button. If necessary, reposition the stage and click "Continue" to store the location of the first corner.{{clear}}
* Move the stage to the corner diagonal from the first corner such that the area to be analyzed is covered by a rectangle having the two selected corners. Click the "A" button on the game controller. If necessary, reposition the stage and click "Continue" to store the location of the second corner.{{clear}}
* [[File:c457_analysis_warning.png|240px|right]] If the selected area is smaller than that specified for concrete having aggregate with the top size selected, a warning will be displayed. Analysis can continue, or a new area can be selected.{{clear}}
* [[File:c457_analysis_status.png|240px|right]] [[File:c457_analysis_plot.png|240px|right]] The status display will be updated every time a button is pressed or released, depending on type of analysis. When a button having an action attached to it is pressed, the associated indicator will flash and the text will change color. The position is of the stage is updated at the conclusion of every move. Running analysis results are displayed in table and a history can be plotted by checking the box of the measurement(s) to plot.{{clear}}
* The analysis can be stopped and resumed at any time by simply not using the game controller.
* Interim reports can be generated by clicking the desired report type button.
* Analyses may be aborted at any time. Results can be saved if desired and will have a "ABORTED" prepended to the filename.
* The analysis will conclude