Page tree
Skip to end of metadata
Go to start of metadata


This document is intended to guide scientists and technicians through the use of the Kappabridge KLY-4 Magnetic Susceptibility meter. Two software packages are available for measuring the anisotropy of magnetic susceptibility: The AGICO Sufar program and the AMSspin program.  Users are encouraged to use the AMSspin software over the AGICO software when possible.

AMSspin Software

AMSSpin is a Labview program written by Jeff Gee for Anisotropy of Magnetic Susceptibility measurements (Gee et al., AMSSpin: A LabVIEW program for measuring the anisotropy of magnetic susceptibility with the Kappabridge KLY-4S2008). The code has been modified to meet the needs of IODP. For detailed instructions on the use AMSSpin and the files written by this program, see Gee's manual AMSSpin – A LabVIEW Program for the Kappabridge KLY-4S and KLY-3S. This program is controlled with keyboard keystrokes. Be aware of what menu you are operating in as some keystrokes have multiple uses.  The version of AMSSpin used by IODP includes a method for measuring bulk susceptibility only and outputs data to a .csv file as well as the original AMSSpin .asc files.

To Start AMSSpin (Current version AMSSpin2)

  1. Remove cloth cover from Kappabridge.
    1. It is important to remember this step. When the AMSSpin program is opened, the arm will raise automatically. If the cover is still on, damage may occur to the arm.
  2. Unstrap the Kappabridge from the metal pole
  3. Slide the Kappabridge away from the pole (to the left). The sensors work best with distance from the support pole.
  4. Turn on the power box. 
  5. Open AMSSpin from the desktop (Figure 1).  The sample handler will move to the UP position immediately upon start up.
    1. This is the AMSSpin program from Jeff Gee with updates.  The desktop icon is a white box with yellow triangle.

      Figure 1. AMSSpin desktop icon.

  6. The software will open and be ready to run. The Kappabridge is on Com1.
  7. There are three menus on the left hand side of the screen. When the program first opens, menu mode is selected (Figure 2).

    Figure 2. AMSSpin startup window.


  8. Press F to assign the file name and path for saving the measurements. This command will also allow the user to select an existing file.
    1. Choose a file name or select an existing file. You do not need to add any file extensions (i.e. .csv). However, if you do, AMSSpin will strip the extension and add the appropriate extension needed for output (see File Writing below) . The same    goes for selecting an existing file; if you select a file with a .txt extension, the extension will be stripped and the data will be appended to the existing files which were initially created. For consistency, it may be a good idea to stick with selecting the .csv file (vs the .txt file) when opening an existing file.
    2. The default directory that is opened when selecting a file will be the last folder you were in. It does not matter what folder you are in when naming a new file; the new file will still output to the C:/data/in folder. If you wish to select a file that has already been uploaded to LIMS, you will need to navigate to C:/data/archive. Files that have not yet been uploaded will be in C:/data/in.
    3. Once a file is selected, the file name will appear in the Data File blank in the upper right hand corner of the screen.
    4. Data will be saved to this file each time SAVE is selected at the end of a measurement.
    5. The user may change this file at any time as long as the Menu mode of AMSSpin is active.
  9. Things to keep in mind when selecting and naming files:
    1. If you choose to create a new file but select an existing file name (or name your file with an existing name), the previously recorded data in that file will be overwritten. You should receive the standard windows message that the file name already exists but care should be taken when naming files.
    2. If you save measurements to an existing file that has already been uploaded, the output .csv file that is saved in C:/Data/IN will not contain the previously measured samples. It will only contain the new measurements. When this file is uploaded to LIMS, a .csv.rep0 file will be added to the archive folder. This file will only open in a text editor such as notepad. All measurements will still be in LIMS.

Calibration Measurement

  1. Place the calibration standard cylinder (typically found in a bag on the metal pole) into the Kappabridge sample holder with the cylinder standing up so the flat ends are on the top and bottom (Figure 3). Azimuthal orientation does not matter as long as the axis of the cylinder is vertical.
    1. Tighten the screw so that the specimen does not move, but do not over tighten.
  2. Press the C key of the keyboard. The calibration measurement will begin.
  3. When measurement is complete, press save if the calibration measurement looks good.
    1. A good measurement is when the calibration measurement (see the "Std. (SI)" field) matches the value given on the standard (139.8E-03 SI).
    2. Two pop up windows will ask the user if they wish to replace the existing files. Select yes for both windows.

Figure 3. Kappabridge Holder with calibration standard.

Anisotropy of Magnetic Susceptibility Measurements

  1. Make sure the sample holder is empty and the screw is flush with the holder. Also check that there are no obstructions in the path of the sample handler.
  2. Press N to name a new specimen and to begin a measurement. Do not put a sample in the holder at this time
  3. Use the barcode scanner to enter the TextID as the sample name in the pop up window and select OK.
    1. The TextID is required as the sample name for data upload.
    2. After the sample name is populated, the program will move to the Measurement Mode menu.  And the blue bar in the center of the screen above the empty graphs will display "Ready for Sample Holder."
  4. Press the space bar to begin the sample holder measurement.
  5. The sample holder value will be displayed at the top of the screen when the measurement is complete.
  6. Evaluate the sample holder value
    1. The value should be small (E-05 or E-06) and should be negative.
    2. If the value looks acceptable, continue onward; Values less than about -5E-05 are generally acceptable.
    3. If the value is high, the program will allow the user to complete the measurements, but will not allow the user to save the data. High values may result from noise from nearby metallic objects or electronics. Make sure the Kappabridge is away from the pole and that no computers/laptops/metal devices are next to the Kappabridge.
      1. If you move the Kappabridge, then recalibrate. You will need to press M and go back to the main menu and repeat the above steps.
      2. If you did not move the Kappabridge, then press R to repeat the sample holder measurement.  Repeat the measurement until an acceptable holder measurement is obtained. This may take several tries.

        Between any of the measurements the user may:

        • Repeat a measurement (press R),
        • Start the entire measurement process over (press S), or
        • Return to the main menu (press M). 

        Selecting bulk (press B) will only complete the bulk susceptibility measurement. If you wish to collect a sample holder measurement for a bulk susceptibility measurement, be sure to press the space bar before pressing B. Otherwise, a bulk susceptibility measurement will be taken with no sample holder measurement.

  7.  Place the sample in the sample holder following the orientation scheme shown on the front of the Kappabridge and press the space bar to initiate the measurement (Figure 4).

    Figure 4: Orientations of samples for the AMSSpin measurements. The dark blue arrow is the IODP arrow, which points up hole. Depending on the how the sample is collected, this arrow will be either in the Working-half orientation (Push samples) or in the Archive-half orientation (Extruded samples).

  8. When the holder returns to the up position, rotate the specimen to the second position and then press the space bar to initiate the measurement.
  9. When the holder returns to the up position, rotate the specimen to the third position and then press the space bar to initiate the measurement.
  10. When the holder returns to the up position, press space bar to initiate the bulk susceptibility measurement. The sample should remain in position 3 for the bulk susceptibility measurement.
  11. When the bulk susceptibility measurement is complete, the program will automatically move you to the third menu, Data Mode (Figure 5a).

    Figure 5a. Data Mode window of AMSSpin.

    Figure 5b. Menu Mode of AMSSpin.

  12. You can choose to:
    1. Discard (D) the measurement,
    2. Modify (M); The modify option allows you to change the sample name before saving the data.
    3. Remeasure (R) the specimen; The remeasure option allows you to select which of the positions you wish to remeasure/
    4. Save (S) the measurement.
  13. Once you are satisfied with the data, press S to save.
    1. If a file is already selected, the new data will be added to the file.
    2. If no file name was assigned at the start of the measurement, the program will prompt the user to designate a file name or select a file.
  14. When the save is complete, the user is returned to the main menu (Figure 5b).
  15. User may save the current holder value at this time by pressing H.
    1. This will save the holder value and you will not need to remeasure the holder for every specimen
    2. When the holder measurement is being held it will say "OLD" under the Save SH heading at the top of the screen.

  16. To continue measurements, press N to assign the next sample name.
  17. If the holder value is saved, place the next specimen in position 1 and continue the measurements as in steps 6-11.
  18. Continue this process for each sample.

To stop the program press the red STOP button. This will move the Kappabridge arm back down and the Kappabridge can be put away.

File Writing

AMSspin will save the file as a .csv file in the folder the user selects.  The default and recommended location for saving the files is C:/Data/IN.  All other files generated by AMSspin will be written directly to the C:/AUX_Data folder.  The .txt file that is generated by AMSspin can be opened in the Anisoft5 program.  When selecting a file to open in Anisoft5, the user must change the file type from .ams to .txt in Anisoft or the files will not be visible.

Uploading Data to LIMS (AMSspin)

For AMS measurements from the AMSSpin program, MUT requires the .csv file generated by AMSspin. AMSspin and the .csv files to be uploaded must be closed for the files to upload. To complete an upload, place the files to be uploaded in the IN folder and select upload. MUT will not recognize if the same file has already been uploaded and will upload it again.  This will result in duplicate data being uploaded. The Text ID must be the sample name for upload to work. 

If you click upload, but do not see your file(s) in LIMS, the file(s) may have an error preventing their upload. Check the folder directory C:/Data/Error to see if your file(s) are there. If so, there is  an error associated with the file. The file(s) may also go toC:/Data if they contain errors. To check for errors, right click on the suspect .csv file and open/edit with a text editor such as notepad. Most errors will be associated with a space after the sample name (Figure 6). Delete the space and save. Then move the edited .csv file back to the IN folder and upload.

Figure 6. Example AMSSpin data file with an error that would cause the data to fail to upload into LIMS.

AGICO Sufar Software

Sufar.exe does not run on the Windows PC operating system. Instead, use DOSbox, which simulates the proper operating environment. To launch Sufar.exe and complete measurements, do the following.

Start the Sufar Software:

  1. Remove cloth cover from Kappabridge
  2. Unstrap the Kappabridge from the metal pole.
  3. Slide the Kappabridge away from the pole (to the left). The sensors work best with distance from the support pole.
  4. Turn on the power box. The Kappabridge will move into the Up position if not already there.
  5. There are two ways to start the DOS software on which Sufar runs.
    1. The easiest way is to click on the shortcut "DOSBox in SUFAR folder"
    2. Alternatively open DOSBox 0.74 folder from the desktop (Figure 7).
    3. Open DOSbox.exe: In the DOSbox 0.74 window that opens, the cursor should be flashing behind the prompt Z:\> All commands will be entered following a prompt of this type. Figure 8 illustrates what the screen will look like after all commands have been entered.
  6. At the prompt Z:\>, enter the command: mount c "c:\Kappabridge\Agico software\KLY4CS\Sufar"
    1. If the directory is correct, user will receive the message "Drive C is mounted as local directory c:\Kappabridge\Agico software\KLY4CS\Sufar\
      1. This mounts the C drive and the directories. If Sufar is moved to a different directory, this path will differ.
    2. At the prompt Z:\> enter the command c:
      1. This command changes the current directory from Z to the C drive
    3. At the prompt C:\>, enter the command Sufar.exe or Sufar

Figure 7. Direct access to DOS Box by clicking on the
DOSBox in SUFAR folder (top) icon on the Desktop or mount the C drive as
described above by clicking on the DOSbox- 0.74 (bottom) icon.

Figure 8. DOSbox.exe with commands for opening Sufar entered 

The Sufar program should open, initialize, and be ready for measuring once the main Sufar window is displayed (Figure 9a and b). Sufar.exe is controlled by the F keys of the keyboard and the arrow keys. The mouse will not work within this program. The number pad to the right of the keyboard will also not work for entering any commands.

Figure 9a Sufar.exe startup window 

Figure 9b Main Sufar Window

Calibration Measurement:

  1. Press F10 to access the auxiliary menu (Aux) in Sufar (Figure 10). When in the Auxiliary menu the AUX will be displayed in the grey bar at the top of the window.

Figure 10. Sufar Auxiliary Menu window

2. Place the calibration standard (found in the bag on the pole next to Kappabridge) into the Kappabridge holder standing upright (Figure 3).

3. Press F3 (Cal) to initiate calibration measurement.

a. The sample holder will move down into the coils and calibration measurement will be completed. The Old and New calibration information will be displayed (Figure 11).

Figure 11 Calibration window when measurement is complete

4. To Save the new calibration information press Return

    1. If you do not wish to save, press F9 (Kill) to exit the calibration window

 Holder Measurement:

  1. Press F10 to access the auxiliary menu (Aux) in Sufar.
    1. Make sure the Kappabridge holder is empty and clean and that the screw for holding the specimens is secured in place (Figure 12).

Figure 12. Empty Kappabridge Holder prepared for holder measurement. Note that the screw (indicated
by white arrow) must be flush with the holder before starting the measurement.

3. Press F4 (Hol)

a. The holder measurement sequence will begin. Do not touch the holder until the display indicates the measurements are completed.

b. Flashing values are 'suspicious' values. They may exceed the allowable range of error as determined by AGICO. Often our standard error value for TSus is suspicious, but still very low.  

i. It is possible to get non-suspicious values for the holder, but it often takes multiple attempts.  It is recommended that no one walk past the Kappabridge during the holder measurements and that the user remain very still.  Do not swivel in the chair or walk around the system.

4. When the measurement is complete, the display will prompt the user to save (Figure 13).

a. To save the data press Y. If you do not wish to save, press N.

Figure 13. Holder Correction window after measurement is complete.
For this measurement,
the values are considered suspicious and a warning is given.

Anisotropy of Magnetic Susceptibility Measurement:

1. Place a specimen in the holder in position 1 (Figure 4).

a. The specimen should be centered in the holder and secured using the small screw in the right side of the holder.

b. Use small pieces of foam to help keep the sample secure in the holder.

2. Navigate to the Sulfar Main window (press F10 if in the Auxiliary window). From the Sufar Main window (Figure 9b), press F1 to initiate Ax1 measurement

a. The Kappabridge will move the specimen into the measurement region and spin the specimen.

b. An asterisk will flash above the active measurement during the process. The screen will also display percentage of measurement that is completed (Transferred) and the Range that the Kappabridge is using (Figure 14).

c. When each measurement finishes, the data will be displayed on the screen (Figure 15).

d. Monitor the error percentage values as you measure. If they are high, try to remeasure the sample. This can be done by simply pressing the appropriate F command again while the specimen is in the correct position.

Figure 14' Sufar Display during the AX2 measurement

Figure 15. Sufar display when Ax1 measurement complete

3. Place the specimen in position 2

4. Press the F2 key to initiate the Ax2 measurement. Data will be displayed upon measurement completion.

5. Place the specimen in position 3

6. Press the F3 key to initiate the Ax3 measurement. Data will be displayed upon measurement completion.

7. Press F4 to complete the bulk susceptibility measurement.

a. The sample should be left in the holder in position 3 for this measurement.

b. When the measurement is complete, the data for all 3 axes and the bulk susceptibility measurement will be displayed (Figure 16).

c. Press F5 to evaluate and save the data. If this is the first measurement made Sufar will display Path ? (Figure 17).

Figure 16. Sufar display after Ax1-Ax3 and bulk susceptibility measurements

Figure 17. Sufar window requesting path to save data.

Window is displayed if F5 is pressed and no file has already been selected

8. If you wish to save to the current path, press return

a. If you wish to save to a new path, enter the path now and press return

i. If the path is invalid, you will be prompted again

ii. The program assumes that the C drive is the location c:\Kappabridge\Agico software\KLY4CS\Sufar

9. At the prompt Name of file?, enter a file name that is less than 8 characters with no extension (Figure 18).

a. It is recommended that file names be the Site and Hole i.e. U1508C

b. If the file name is more than 8 characters, the program will not accept the name.

Figure 18. Sufar window prompting user to enter a file name with a maximum of eight characters

10. A new command line is now visible on the screen.

a. If this is a file with existing measurements, the window will display the number of measurements already in the file, and ask for the new specimen name (Figure 19).

b. If this is a new file, the window will only display the prompt asking for the specimen name.

Figure 19. Sufar window prompting user to enter a specimen name or to use the # sign to indicate they wish to put the data in a new file.

11. At the prompt: Specimen name /# enter new file/?, enter the TextID of the sample. Press return

a. TextIDs are required as sample names for upload.

12. The Sufar window now displays the options for entering the orientation scheme you wish to use (Figure 20). Enter 1,2, or 3 and press return.

a. This will likely be number 3, Non-oriented specimen

Figure 20. Sufar window displaying options for entering specimen orientation information

13. The specimen data will now be displayed on the screen for you to evaluate (Figure 21). To leave this window, press ESC (the escape key).

Figure 21. Sufar data evaluation window

14. Sufar will now display: Output to file (Y/N)? (Figure 22).

a. Pressing Y and return saves the data. You may also press return as saving the data is the default action

b. Pressing N and return will result in your data not being saved.

Figure 22. Sufar display asking user to choose to output data to a file and if they wish to print.

15. User is now prompted: Output to printer (Y/N)? (Figure 22). Pressing return will trigger the default response of N (no).

 a. Entering Y will result in data being sent to a printer

16. User will be returned to the Main Sufar window (Figure 9b). You may begin the next measurement now by repeating steps one through seven.

a. The saving process will look different after the first measurement is made. The program will only prompt the user for a specimen name (Figure 23).

b. If you wish to change the file that the data is saved to, enter # and press return. The display will now show a prompt for a Path (Figure 17).

Figure 23. Sufar prompt window after initial file has been set

17. When measurements are completed and the user wishes to switch off the software, press F1 to trigger an Ax1 measurement.

18. Then press F8 to stop the measurement

19. Use ctrl + Q to quit the program.

a. Improperly quitting the program may result in the loss of data.  The last lines of the .ASC file will not be properly written.

20. Data should now appear in the .ASC file. Check the data file to ensure all data was written properly.

a. Do not complete measurements with the .ASC file open

b. Data will not appear in the .ASC file immediately. Data will be written to the .RAN file and transferred to the .ASC file when the program is closed.

Bulk Susceptibility Measurement:

  1. Press F10 to access the AUX menu

2. Press F1 to initiate Bulk Susceptibility measurements

3. Sufar will prompt the user to decide if new holder measurement is necessary. Enter Y or N and press return (Figure 24).

a. The default response is N.

Figure 19 Prompt Window allowing user to measure the holder before bulk susceptibility measurements 

4. User is prompted to select to measure in the current field or k-H Curve. Pressing Return will trigger the default response: current field (Figure 25).

Figure 25. Prompt Window allowing user to select field for bulk susceptibility measurements

5. Place sample in holder in Position 1.

6. Enter the Specimen name at the prompt (Figure 26).

Figure 26. Bulk Susceptibility Measurement Window

7. Use the TextID as the specimen name

8. Press Return to initiate the bulk susceptibility measurement

9. When the measurement is complete, user is prompted for the next specimen. Repeat steps 5 through 7 for all specimens.

10. When measurements are complete, enter Q and press return (Figure 27).

Figure 27 Saving Bulk Susceptibility data

11. User will be prompted to Output the data to a file. Enter Y and press return to save data (Figure 27).

12. User is prompted for the file path. Press return to use default file path (Figure 27).

13. At the Name of File? Prompt, enter a file name under 8 characters in length. Recommended file name is Site and Hole (ex. U1517B). Press return (Figure 27).

14. User is prompted to enter a note. This field can be left blank.

15. User is prompted to output data on a printer. Enter N.

16. Data should now be written to a .ky4 file at the path set by the user. Check to make sure the file has been written.

When done, you can kill the program by hitting F9 and clicking on the X in the upper right corner of the DOS window. To get the Kappabridge arm to return to the down position, start up AMSSpin and then press the red STOP button. This will move the Kappabridge arm back down and the Kappabridge can be put away.

Uploading data to LIMS (SUFAR)

Uploads are completed using the MegaUploadaTron (MUT) application. For Anisotropy of Magnetic Susceptibility measurements generated by the AGICO Sufar program, MUT requires an .asc and a .ran file. To upload bulk susceptibility files, MUT requires the .ky4 file.

To complete an upload, place the files to be uploaded in the IN folder and select upload. MUT will not recognize if the same file has already been uploaded and will upload it again.  This will result in duplicate data being uploaded.
The Text ID must be the sample name for upload to work.  It is not possible to edit the names after the fact because the names need to be altered in the .ran file.

Archive Versions:

KappabridgeUserGuide_exp378.pdf: PDF version of this wiki page as of 2020-02-24

  • No labels