

Using the Thread3D Client Tool in demo mode (no software for calculation of the results is needed)
==================================================================================================

1. Enter the URL of the TraCIM Server. For the PTB TraCIM Server use https://tracim.ptb.de
   If you are behind a proxy server, enter the relevant settings (i.e. IP address of the proxy, 
   and username/password, if applicable), otherwise leave the fields blank. 

2. Enter your order ID (also called order key) for a FREE TEST. You can get an order key in the 
   TraCIM webshop (https://tracim.ptb.de) after registration. All other fields (i.e. process ID, software name, etc.) 
   can be left blank at this point.

3. Now you can download the test data by clicking the buttom "Request test data". If nothing goes wrong, you will get
   an xml file with the test data and a process ID <ProcessID> (also called process key).
   The test data are also extracted to ascii files in the subfolder 
   \tracimTestClientData\<ProcessID>
 
4. Check now the box "Demo mode for free test". This has the consequence that with "Load results" the build-in 
   test results for the free test data are loaded. Note that the box is automatically unchecked when new test data are requested or loaded.

5. Before the build-in results are loaded, the field "Software name", "Software version" and "Software vendor" 
   must be filled in. The field "Software revision" ist optional.
   Further valid MPEs must be specified. The default value is 0.01 micrometer for lengths, 0.01 µrad for angles, and 1E-8 for the pitch cone taper.
   If an MPE is set to zero, the default value is used.
   
6. With "Load results" the build-in results are loaded and transformed to xml. 

7. "Submit results" will send the results to the TraCIM server.

8. If nothing goes wrong, a PDF document containing the test report will open. The PDF is also saved to the folder
   \tracimTestClientData\<ProcessID>
   

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


Using the Thread3D Client Tool to perform a TraCIM test:
===================================================================================================================================

1. Enter the URL of the TraCIM Server. For the PTB TraCIM Server enter https://tracim.ptb.de
   If you are behind a proxy server, enter the relevant settings, otherwise leave the fields blank 

2. Enter your order ID (also called order key) for a free or non-free test. You can get an order key in the 
   TraCIM webshop (https://tracim.ptb.de) after registration.  All other fields (i.e. process ID, software name, etc.) 
   can be left blank at this point.

3. Now you can download the test data by clicking the buttom "Request test data". If nothing goes wrong, you will get
   an xml file with the test data and a Process ID <ProcessID> (also called process key).
   The test data are also extracted to ascii files in the subfolder 
   \tracimTestClientData\<ProcessID>
   The test data is also saved as xml to the file testData.xml in the same subfolder. This file can 
   be loaded at a later time by clicking the buttom "Load test data".
 
4. Now the results to the given test data must be calculated by your implementation of the Thread3D algorithm.
   The results must be saved as ascii files in the same directory 
   \tracimTestClientData\<ProcessID> 
   The format and names of the files containing the results are evident from the example data in 
   \tracimTestClientData\A735T0FBE0KFO05L
      
   You can find information on how to calculate these results in the document "Computational Aims" at the end of the manual.
   (https://tracim.ptb.de/tracim/resources/downloads/ptb_math_thread3d/ptb_math_thread3d_manual.pdf)
                         
5. Before the calculated results are loaded, the field "Software name", "Software version" and "Software vendor" 
   must be filled in. The field "Software revision" ist optional.
   Further valid MPEs must be specified. The default value is 0.001 micrometer for lengths, 0.01 µrad for angles, and 1E-8 for the pitch cone taper.
   If an MPE is set to zero, the default value is used.
   
6. Make sure the box "Demo Mode" is unchecked. With "Load results" the results from the folder 
   \tracimTestClientData\<ProcessID>
   are loaded and transformed to xml. (The field "Process ID" must contain the appropriate ProcessID.)

7. "Submit results" will send the results to the TraCIM server.  

8. If nothing goes wrong, a PDF document containing the test report will open. The PDF is also saved to the folder
   \tracimTestClientData\<ProcessID>


