FAQ
Frequently Asked Questions
General
Where do I find an Application Programming Interface to write my own software?
If you prefer to develop your software instead of using the PT2026 software, MFToolV10, EZMag3D, Metrolab provides a set of Application Programming Interfaces to simplify and speed-up your code development.
there are 2 ways to find the files, documentation, and examples you need:
- A single page compiling all APIs: What API for my software ?
- Seek in the download section:
- Go to the download section.
- Select your instrument.
- Select “Software and driver”.
My advice go to the compilation page: What API for my software?
How do I get my instrument calibrated or repaired?
- Ship directly to Metrolab with all freight charges prepaid. Goods will be shipped back to your office with collect charges.
- After first tests, we will send you a formal quotation for the calibrationDuring calibration, the instrument reading is compared to one or more references to verify its accuracy. The references themselves need... More.
- Your Purchase Order and prepayment will signal your approval of the quotation and shipping instructions.
Can you repair or calibrate our ancient Metrolab instrument?
Probably. As much as we’d like to sell you one of our spiffy new instruments, we will repair and/or calibrate our beloved veterans as long as we can get parts. Please contact us for a quote.
Can you calibrate magnetometers produced by another manufacturer?
We very much appreciate the confidence implicit in this question, but the answer is no. Every magnetometerAn instrument to measure magnetic flux density (B) or magnetic field intensity (H). More is different, and our procedures and equipment are only set up to handle our own instruments.
Can I control my Metrolab instrument from Matlab, Excel, Perl, Python or Tcl?
Yes, you can – and probably other programming environments as well. Please see this Technical Note.
MFC2046
What are the key differences between the MFC2046 and MFC3045?
- Extended magnetic field strength measurement rangeThe range of a probe is defined by the minimum and maximum field strength it can measure. On an instrument,... More: 0.03 T to over 25 T (1.1 GHz) for the MFC2046 compared to 0.2 T to 7 T for the MFC3045.
- Extended magnet geometries: the MFC2046 accommodates 2 probe-array geometries to map any magnet ranging from 40mm-wide bores (MFC9146) used in NMRNuclear Magnetic Resonance. A resonance phenomenon seen when you irradiate a sample in a magnetic field with an RF field.... More spectroscopy to 500 mm DSV (MFC9046) used in pre-clinical, extremities or whole-body MRI. The MFC3045 is limited to a 220 mm – 500 mm DSV.
- Extended flexibility: The MFC2046 can be used for single-point measurements or multiple-point mappingThe process of measuring magnetic field intensity at many different points, in order to understand the structure of the field... More. A wide-range probeThe actual sensor that is placed in the magnetic field. The NMR probe contains the NMR sample; the Hall probe... More (like 1326 probes) can be included at the center of the MFC9046 probe arrayFor Metrolab's Magnetic Field Camera, the probe array is a semi-circular plate holding up to 32 NMR probes. More for field rampingThe process of injecting current to bring the field up to the operational field. Used particularly for superconducting magnets. More. The MFC3045 is limited to multiple-point mappingThe process of measuring magnetic field intensity at many different points, in order to understand the structure of the field... More.
- All this with modern software and connections.
What is the difference between the MFC9046 and MFC9146 probe arrays?
They both use the same pulsed-NMR technology; the main difference lies in the geometry of the arrays. The MFC9146 has been designed to map NMR-spectroscopy magnets; the probes are positioned to report a cylindrical magnetic field map after a 360° rotation of the array. The magnet boreThe centre of a solenoidal magnet, where the magnetic field is concentrated. More can be as small as 40 mm. In the MFC9046, the probes are arranged in a semi-circular array, allowing the large DSV (Diameter of Spherical Volume – up to 500 mm) of an MRI magnet to be measured in a single 360° rotation of the array.
Can I use only one probe of the camera and how fast can I measure in that case?
Yes. If you decide to work with a single probeThe actual sensor that is placed in the magnetic field. The NMR probe contains the NMR sample; the Hall probe... More, the maximum frequency will be 33Hz, with a measurement every 30 ms. This is true for the wide-range probeThe actual sensor that is placed in the magnetic field. The NMR probe contains the NMR sample; the Hall probe... More at the center of the camera (if there is one) or any narrow-range probeThe actual sensor that is placed in the magnetic field. The NMR probe contains the NMR sample; the Hall probe... More in the circumference. The MFCTool v10 software allows you to measure a single probeThe actual sensor that is placed in the magnetic field. The NMR probe contains the NMR sample; the Hall probe... More or all the probes, but not to measure just a subset of the probes. You can decide to display only a subset of the probes of the camera if you wish.
How much field inhomogeneity can the MFC9046 or MFC9146 probe arrays handle?
The new probeThe actual sensor that is placed in the magnetic field. The NMR probe contains the NMR sample; the Hall probe... More design can handle at least 1’000 ppmParts per million, or 10-6. Bigger than a ppb, but still pretty darn small. More/cm. Using signal averaging, the probes can manage up to 3’000 ppmParts per million, or 10-6. Bigger than a ppb, but still pretty darn small. More/cm; this technique can only be used for constant fields, and the cost will obviously be a slower measurement. The older generation of cameras (MFC3045) is limited to 600 ppmParts per million, or 10-6. Bigger than a ppb, but still pretty darn small. More/cm. Note: it is not easy to specify tolerance to field gradients, as they depend to a large extent on the gradientIn this context, gradient refers to the spatial variation of the magnetic field. More direction(s) and linearity.
Can I use the same software (MFCTool v10) for the MFC2046 and MFC3045?
Short answer, no – not yet! The current version, v10 of the MFCTool software is not compatible with the MFC3045, but it will be in a future version. However, the MFC2046 low-level interface is in no way compatible with that of the MFC3045.
Do we still use the rubber sample for low field measurements?
Yes, the MFC2046 uses rubber samples (protons). D2O samples (deuterons) are not used in the MFC2046, as the PT2026 Main Unit supports proton samples up to 1.1 GHz (25 T), and the Signal-to-Noise Ratio of rubber is much better than with D2O.
What are the possible connections on the MFC2046?
Same as the PT2026, the Main Unit has two possible interfaces, USB or Ethernet. You can use either of these two solutions to connect the main unit to a PC. The remote controlAn NMR-controlled field is one whose strength is monitored by NMR. As opposed to NMR-regulated. More now connects to the FCA box, via a LEMO connector; it will no longer go to the PC. Consequently, you only need one PC connection, either USB (USB2) or Ethernet.
Can the MFC2046 system be remotely controlled with our own software?
Yes, it is possible to controlAn NMR-controlled field is one whose strength is monitored by NMR. As opposed to NMR-regulated. More the MFC2046 system (PT2026 + FCA7046 + MFC9046 or MFC9146) using your own software.
Here is what you need to know:
- We provide a “C++ instrument catalog” interface to simplify and optimize the development of your code, avoiding using low-level instrument command. (The “C++ instrument catalog” is available in the downloads page)
- Please do not use SCPI command set from the PT2026 user’s manual. SCPI command set is not optimized for the PT2026 in camera mode.
- If you only need to monitorSee Control. More and collect instrument status and measurement results automatically and don’t need to controlAn NMR-controlled field is one whose strength is monitored by NMR. As opposed to NMR-regulated. More the MFC system with your software, we offer in the MFCToolV10 application a way to collect all measurements and instrument status through a DLL. (see MFCToolV10 User’s Manual).
Can I use SCPI command set to develop my own MFC software?
If you want to develop a software for the MFC2046 camera system, you must not use de PT2026 SCPI command set. Operating the PT2026 as a camera system requires specialized knowledge and commands that we implemented into the “C++ Instrument Catalog”.
Can I automatically export measurement results to another software than MFCToolV10?
Yes, You can automatically export measurement results from MFCToolV10 by developing your DLL. See MFCToolV10 user’s manual for more details.
Where can I find information about software Licensing for the MFToolV10 or the “C++ instrument catalog”?
License terms documentations are available in the MFCToolV10 installation directory and the “C++ instrument catalog” package.
Is the MFC3045 supported by the MFCToolV10 or the “C++ instrument catalog”?
Yes, one software and one API to rule them all. see: https://old.metrolab.com/mfctool-sw-release/
Where can I find an example to develop my own MFC software with the “C++ instrument catalog”?
An example is available in the “C++ instrument catalog” package.
MFCToolV10 uses the “C++ instrument catalog” to interface the instrument. MFCToolV10 source code is available in its installation directory and serves as an example.
Are the 3 fixing lugs on the MFC9046 Array in the same location as the old MFC3048 array?
Yes, the overall geometry of the cameras remains the same, as do the 3 fixing lugs. However, the MFC9046 arrays have a rectangular extension below the centreline that was not present in the MFC3048.
Is the bandwidth of the Array probe still ± 1% or is it different?
For the MFC9046 and MFC9146, the bandwidth is specified to ±3%, but in practice a bandwidth of ±5% can usually be reached. This rangeThe range of a probe is defined by the minimum and maximum field strength it can measure. On an instrument,... More is wider than that of the MFC3048, which is ±2% except for a few (like the 7 T) where the bandwidth is limited to ±1%.
Does the Normalization process remain the same or is it different?
The normalization process is similar to the current one, using the MFCTool v10 software.
What is the length of the 3026 Extension cable?
PT2026
You've been talking about the PT2026 for years; is it soup yet?
Yes! It’s shipping. And we’re quite proud of it, thank you. Check out the web page.
What value for the gyromagnetic ratio is used in the PT2026?
Please read this technical note.
PT2025
Where do I find the software for the PT2025?
Bad news: there is none. Having said that, we may be able to help you out with an undocumented, unsupported and unpretty LabVIEW driver that we use internally. Please contact us.
Why does my PT2025 RS-232 interface not work?
- The micro-switches should be set to 000100100, the baud rate to 2400 (center jumper on the 14-pin header) and no flow controlAn NMR-controlled field is one whose strength is monitored by NMR. As opposed to NMR-regulated. More (= “no handshake”, right-hand jumper on the two four-pin headers).
- The stickiest problem is often the RS232 cable. Pin-out specifications for both DB-9 and DB-25 connectors are in Section 6.2 of the the PT2025 manual, “Connecting the RS 232 C Interface.” If you’re not using flow controlAn NMR-controlled field is one whose strength is monitored by NMR. As opposed to NMR-regulated. More, as suggested above, the only relevant pins are 2 and 3: pin 2 on the DB-9 should be connected to pin 2 on the DB-25, and likewise pin 3 -> pin 3. Please take the time to check your cable.
- Use a terminal emulator such as TerraTerm to test basic communication. A few simple commands for initial tests are: Ctrl+E : should return the displayed field value S1, S2, S3 or S4 : should return the various status registers R : lights the “REM/SEARCH” light (In REMOTE mode) D0 and D1 : should toggle the display from MHz to TeslaThe SI unit for magnetic flux density (B). More and back
Why does my PT2025 IEEE-488 interface not work?
Probably because you did not purchase the IEEE-488 option. All PT2025s have the GPIB connector; what’s missing are the interface chips, because they are becoming rare. We can, however, easily retrofit your instrument; please contact us for an offer.
Why does my PT2025 probe (range 6, 7 or 8) not work anymore?
Probably because the ampule containing the heavy-water NMRNuclear Magnetic Resonance. A resonance phenomenon seen when you irradiate a sample in a magnetic field with an RF field.... More sampleThe NMR sample is the material placed in the magnetic field, whose proton spin resonates when an RF field of... More is broken. ProbeThe actual sensor that is placed in the magnetic field. The NMR probe contains the NMR sample; the Hall probe... More ranges 1-5 use robust rubber (hydrogen, or proton) samples, but ranges 6-8 use a glass ampule with heavy water (deuterium). This ampule can break if subjected to shock or freezing. Please contact us for a repair offer.
Why does the PT2025 take so long to lock after finding the NMR signal?
Probably because you have selected the incorrect field polarity. After finding the NMRNuclear Magnetic Resonance. A resonance phenomenon seen when you irradiate a sample in a magnetic field with an RF field.... More signal, the PT2025 starts regulating the frequency to precisely track the NMRNuclear Magnetic Resonance. A resonance phenomenon seen when you irradiate a sample in a magnetic field with an RF field.... More signal. This regulationA NMR-regulated magnet is an electromagnet whose field is measured by an NMR teslameter, which then closes the loop by... More diverges if the field polarity is incorrect. After a few such failures, the PT2025 tries switching the field polarity on its own, but this trial-and-error process takes time. Try switching the field polarity, and the instrument should lock onto the signal immediately.
Why does the PT2025 drift after finding the NMR signal?
Technically, it’s not drifting, it’s trackingOnce the resonance has been found (see Search), a continuous-wave NMR teslameter can lock onto a signal and continue measuring it, even... More. After the signal is found, the PT2025 tracker gradually centers the NMRNuclear Magnetic Resonance. A resonance phenomenon seen when you irradiate a sample in a magnetic field with an RF field.... More signal on the modulationIn a continuous-wave NMR teslameter, the Larmor frequency has to be crossed and re-crossed to perform a measurement. This is achieved... More sweep. If the “Fine” adjustment (vernier dial knob on the front panel) is not in the middle of its rangeThe range of a probe is defined by the minimum and maximum field strength it can measure. On an instrument,... More, the NMRNuclear Magnetic Resonance. A resonance phenomenon seen when you irradiate a sample in a magnetic field with an RF field.... More pulse will initially be off-center, and will need to be corrected. The correction takes a few seconds, and during that time, it looks like the measurement is drifting. To avoid this, set the “Fine” ajustement to 5 before launching a searchBefore being able to measure, an NMR teslameter has to search the range of the probe to find the NMR... More.
What value for the gyromagnetic ratio is used in the PT2025?
Please read this technical note.
THM1176 / TFM1186
I am not able to recharge the tablet of my handheld THM1176/TFM1186 kit. Do you have a solution?
We have identified an issue whereby the Windows tablet included in the THM1176/TFM1186 Handheld Kit would not recharge. The manufacturer has been able to identify the problem and has issued a BIOS upgrade to avoid any recurrence. Here is the procedure to solve this issue.
How do I recalibrate my THM1176?
The THM1176 has to be returned to the factory for recalibration. The procedure for returning your instrument is as described above, in the section “General.” For the sake of cost efficiency, we calibrate the THM1176 in batches, four times a year; please see the THM1176 manual or the price list for the dates. You can have your instrument calibrated outside these times, but the price is higher – please see the price list for details.
Why are my first few measurements off?
If you are measuring small field values, you are probably seeing the effects of auto-ranging: the first measurement uses the highest rangeThe range of a probe is defined by the minimum and maximum field strength it can measure. On an instrument,... More, with a very large error, and then the instrument progressively reduces the rangeThe range of a probe is defined by the minimum and maximum field strength it can measure. On an instrument,... More setting, until it arrives at the lowest rangeThe range of a probe is defined by the minimum and maximum field strength it can measure. On an instrument,... More, where the readings stabilize. To avoid this behavior, you should manually select the lowest field rangeThe range of a probe is defined by the minimum and maximum field strength it can measure. On an instrument,... More, instead of “Auto”.
Does the THM1176 software work with Windows 8 or Windows 10?
Yes, but you may have to configure Windows to install an older version of Microsoft’s .NET Framework. Please see this Technical Note.
Does the THM1176 software work with macOS 10.14 Mojave?
How do I configure the THM1176 software to ...?
We have a Technical Note that details how to configure the THM1176 software for the most common usage scenarios. Please check this note, and if you still cannot figure out how to perform your measurement, please do not hesitate to contact us.
My THM1176 / TFM1186 is malfunctioning or giving weird results.
We have a Technical Note that details the most common problems encountered with the THM1176, TFM1186, THM1176 software, and THM1176-PDA. Please consult this note, and if it does not cover your problem, please do not hesitate to contact us.
I know my field oscillates at 50 Hz. Why does the spectral display in the THM1176 software show 100 Hz?
Because the computation of B-magnitude rectifies the signal, thus doubling the frequency. If you want the “true” rotation frequency of the B-vector, you need to look at the spectrum of the field components. The THM1176 software allows you to do just that.
Do you have a Matlab or Excel or Python interface for the THM1176 / TFM1186?
The THM1176 application has disappeared from my PDA!
Did you perhaps change the interface language? This erases all user data – see the Warning on page 20 of the SoMo 655 User’s Guide. Please restore the PDA as described in the file “\Handheld Kit\PDA\ReadMe.rtf” on your installation CD (or download).
MFC3045
The MFC3045 WinMFC software is giving me really odd results. What's going on?
Are you using an MFC3045 with the optional built-in USB interface (“MFC3045-USB”), or are you using a USB-to-RS232 adapter? If so, you may well be experiencing a common timing problem. Please set the “Wr/Rd delay” in the WinMFC-9 software to 400ms. This option is available from the “Options” – “Serial Port” menu.
What value for the gyromagnetic ratio is used in the MFC3045?
Please read this technical note.
FDI2056
Why does the FDI2056 give me different results with Gain ≤ 1 and Gain superior at 1?
Changing the gain changes the input impedance, which changes the input bandwidth. Depending on your coil impedance and signal spectrum, this can significantly change your results. Please see Section 5-3 of the FDI User’s Manual, “Input Adaptation”.
Do I have to short-circuit the FDI2056's input while I'm doing the zero-offset compensation?
Good question! Yes. You can either short-circuit your coil (IN+ to IN-), or you can ground them, which will short-circuit them internally.
My FDI2056 doesn't start up, or extremely slowly.
A common cause is that the battery that maintains the date/time of the crate controller (the embedded Windows PC) is depleted. When the date/time is invalid, the boot process hangs with a BIOS prompt. Attach a keyboard and monitorSee Control. More to the crate controller to verify that this is the problem. If so, replace the battery (type CR2032), reset the date/time, and continue booting. If all is well, you can disconnect the keyboard and monitorSee Control. More and boot normally.
PM1055
What is the field homogeneity of the PM1055?
The PM1055 was originally designed for our PT2025 NMRNuclear Magnetic Resonance. A resonance phenomenon seen when you irradiate a sample in a magnetic field with an RF field.... More PrecisionPrecision is how closely multiple measurements will be clustered. Also called reproducibility or repeatability. In everyday speech, often confused with... More TeslameterSee magnetometer. More, so the field gradients must be less than about 1400 ppmParts per million, or 10-6. Bigger than a ppb, but still pretty darn small. More/cm – otherwise the PT2025 would not be able to measure (see Section “Magnetic Environment” in Section 2.2 of the PT2025 manual). In reality, the gradients are much lower; for example, the field map of PM1055 S/N 008 shows gradients at the center of less than 140 ppmParts per million, or 10-6. Bigger than a ppb, but still pretty darn small. More/cm. Generally, remember that the PM1055 is intended to be used as a reference magnetA magnet used for calibrating a magnetometer. Reference magnets are often controlled or even regulated by an NMR teslameter. More, not for NMRNuclear Magnetic Resonance. A resonance phenomenon seen when you irradiate a sample in a magnetic field with an RF field.... More spectroscopy or MR imaging.
Why does the PM1055 have a Lemo connector?
As explained on the web page, the PM1055 contains an auxiliary coil to be able to offset temperature driftThe gradual loss of an instrument's accuracy. NMR teslameters drift because their time base drifts; this can be easily checked and... More, or otherwise modulate the field. The Lemo connector connects to that coil.