Mikrofab SuiteMikrofab SuiteMeasurement & Analysis
Manual  /  12. Settings, Troubleshooting, FAQ & Glossary
TR
Simulation · v5.85.0

Settings, Troubleshooting, FAQ and Glossary

This chapter documents the Settings Center of the Mikrofab semiconductor / thin-film transistor (TFT) / photovoltaic (PV) measurement and analysis software setting by setting, provides step-by-step solutions for the most common problems, answers frequently asked questions, and explains the technical terms and abbreviations used throughout measurement and analysis. The Default column in the tables is taken verbatim from the factory values in the config/default_config.json file shipped with the software; you can confirm a value here before changing it.

ℹ️
Note Settings open as a workspace from the Settings button in the left navigation bar. Shortcut: Ctrl+,. The page consists of a category navigation on the left, a search box at the top, the form panel of the selected category on the right, and a Save / Apply / Cancel / Reset to Defaults button bar at the bottom.
Mikrofab Settings Center workspace: category list on the left, form panel in the center, save button bar at the bottom
Figure. Settings Center workspace — left category navigation, form panel and bottom button bar.
🎓 What is it for? — Settings, Troubleshooting and Reference Section

This section is like the "back of the user manual": you look here for what a setting does and its factory value, what to do when an error appears, and what the abbreviations you encounter (Vth, FF, EQE…) mean. It is the first place to look when something does not work as you expect; think of it as the thick reference booklet that comes in the instrument's box — instead of reading it cover to cover, you open it when you need it.

  • Why it is done: to configure the software safely, quickly resolve where you got stuck, and learn the technical terms.
  • What it teaches / measures: the meaning of each setting + its factory default, step-by-step solutions for common problems, FAQ and a technical glossary.
  • Where it is used: first-time setup, changing settings, troubleshooting errors/faults, and looking up terms while reading reports/results.

1. Understanding the Settings Center — The Save Model

🎓 What is it for? — Staged Save Model

The Settings Center does not write your changes to disk immediately; it first accumulates them in a draft and commits them when you press Save. This way you do not accidentally make a wrong value permanent — it is like reviewing a form before pressing "Submit". Theme/font/language are the exception: they are previewed instantly, but are still not written to disk until you Save.

  • Why it is done: to prevent hardware-sensitive settings from being changed silently or by accident.
  • What it teaches / measures: which change is "pending" (dirty ●), which is a live preview, and how to undo it.
  • Where it is used: on every settings change; especially for critical settings such as Simulation Mode that alter device behavior.

The Settings Center uses a hybrid (staged) save model. This is designed to prevent hardware-sensitive settings from being written accidentally and silently.

BehaviorDescription
StagingEvery change you make is first written to a working copy; it is committed to the live configuration only when you press Save.
Live preview (live)Settings marked live, such as theme, font and language, are previewed the moment you change them (applied on screen immediately) but not written to disk. They are reverted with Cancel.
Dirty indicatorIf there are unsaved changes, a * appears in the page title and a ● unsaved changes badge appears in the bottom bar; an ↺ (undo) button appears on each changed row.
ValidationIf a numeric field is outside the allowed range, a red error message appears below the row and the Save button is disabled.

Button bar

ButtonFunction
SaveMakes the staged changes permanent (enabled only when there are changes and they are valid).
ApplySaves without leaving the page.
CancelReverts all changes (and live previews) to the last saved state.
Reset to DefaultsReturns all settings to the factory defaults (asks for confirmation; Save is still required to make it permanent).
ProfilesSave/load/delete named settings snapshots; Export/Import to a file (*.json).
Tip The search box at the top left ("Search settings…") filters by row label, description and synonymous keywords. The Changed only button shows only the rows you have modified; the Advanced button shows the normally hidden, advanced rows (e.g. log level, VISA timeout, calibration interval).
Tip By right-clicking a row label and choosing "Reset to default" you can return only that row to its factory value. The button, on the other hand, returns the row to its last saved value (the two are different).

2. Settings Reference (Category by Category)

The tables below give, for each setting, its display name → configuration key (config key), meaning, valid values and factory default. For numeric settings, the unit and the allowed lower/upper limit are also stated.

2.1 General

🎓 What is it for? — General Settings

The General tab determines the most fundamental behaviors of the software: where results will be saved, whether you will work with a real device or with mock (simulation) devices, and how much detail will be written to the log. This is the first place a new user visits; in particular Simulation Mode is the switch that must be turned off when moving to real measurements.

  • Why it is done: to set up the software for your lab layout and choose the real/trial operating mode.
  • What it teaches / measures: basic keys such as the output folder, mock_mode, Switch Matrix line-ending and log level.
  • Where it is used: first-time setup and the transition from simulation to real hardware.
Setting (key)MeaningValuesDefault
Measurement folder (output_directory)Folder where measurement results and exports are writtenFolder pathmeasurements
Simulation Mode (mock_mode)Work with mock devices without hardware; turn off for real measurementsOn / OffOn (true)
Switch Matrix newline (switch_append_newline)Append a line ending to the end of every command sent to the Mikrofab TFT/Relay boardOn / OffOff (false)¹
Log level (log_level) — AdvancedDetail level written to the log file; applied after restartDEBUG / INFO / WARNING / ERRORINFO
ℹ️
Note ¹ In default_config.json the top-level switch_append_newline key comes as true; however, the descriptive default of the control in the General panel is false. The actual behavior follows the saved configuration value. Leave it off if the command sent to the real board does not expect a line ending.
ℹ️
Note Turning off Simulation Mode is not a live action; because it changes device behavior it is staged and takes effect only with Save.

2.2 Appearance

🎓 What is it for? — Appearance Settings

The Appearance tab sets how the interface looks and which language it is in: light/dark theme, font, application and help language, plus interface complexity by role. These do not change the measurement result, they only improve your working comfort — it is like adjusting the seat and mirrors to suit yourself while driving the same car.

  • Why it is done: to make the interface comfortable to work with, suited to your eyes and language.
  • What it teaches / measures: theme, font, language/guide language, user mode and plot grid.
  • Where it is used: personal preference; training/presentation (simple mode) or advanced use (expert/developer mode).
Setting (key)MeaningValuesDefault
Theme (theme)Light or dark interface theme; applied instantlylight / darklight²
Font (ui_font_family)Interface font family; empty = embedded InterAny installed font (embedded: Inter, Geist)"" (Inter)
Language (language)Application interface language; applied instantlytr / enen
Guide language (guide_language)Language of help and guide textstr / enen
User mode (user_mode)Adjusts interface complexity by role; takes effect after restartoperator / simple / expert / developerexpert
Plot grid (plot_show_grid)Show guide grid lines on plot axesOn / OffOn (true)
ℹ️
Note ² The descriptive default of the theme control in the Appearance panel is dark, while the factory configuration is light. Which theme appears at startup depends on the saved theme value.
Tip Theme, font and language are live-previewed — you see them on screen as soon as you select them; if you do not like them, they are instantly reverted with Cancel. For a language change to fully propagate to all menus, the software may be restarted once.

2.3 Measurement

🎓 What is it for? — Measurement Settings

The Measurement tab determines the default behavior of the measurement panels: how numbers are displayed, which SMU channel is connected to drain/gate, and which current/voltage/time values new measurements start with. If you define the correct "starting values" once here, you avoid entering the same settings by hand for every new measurement.

  • Why it is done: to set up recurring measurements consistently and quickly; to predetermine the noise/speed balance.
  • What it teaches / measures: number format, channel mapping and central SMU defaults (compliance limit, NPLC, settling time…).
  • Where it is used: setting up the lab's standard measurement recipe once and spreading it to all panels.

Number format and readout

Setting (key)MeaningValuesDefault
Data entry number format (input_number_format)Display format of numbers in input fields2/4 decimals × engineering / scientific / fixed2-Engineering
Graph axis number format (graph_number_format)Format of numbers on graph axes(same options)2-Engineering
Readout panel decimals (readout_decimals)Decimal places of values in the right Readout panel; the report is not affectedInteger 0–62
Open Readings window on measurement start (reading_window_autoopen_on_start)Automatically open the floating Readings window when a measurement beginsOn / OffOff (false)
ℹ️
Note Number format options: 2-Engineering, 2-Scientific, 2-Fixed, 4-Engineering, 4-Scientific, 4-Fixed. "Engineering" keeps exponents at multiples of 3 (compatible with SI prefixes: n, µ, m, k, M…), "scientific" uses a single-digit mantissa, and "fixed" shows decimals without an exponent.

Channel mapping

Setting (key)MeaningValuesDefault
Drain SMU (smu_mapping.drain)SMU channel assigned to the drain terminalChannel A / Channel Ba (Channel A)
Gate SMU (smu_mapping.gate)SMU channel assigned to the gate terminalChannel A / Channel Bb (Channel B)

Central SMU defaults

Central SMU defaults (default_smu.*) — new measurement panels seed their relevant inputs from these values:

Parameter (key)UnitRangeDescriptionDefault
Current compliance (current_compliance)A0 – 1Default SMU current compliance limit0.0001 (100 µA)
Voltage limit (voltage_limit)V0 – 210Default voltage limit20.0
Power limit (power_limit)W0 – 22Default power limit2.0
NPLC (nplc)PLC0.01 – 25Integration time; high = low noise, slow1.0
Settling time (settling_time_s)s0 – 10Wait after the source is set, before measuring0.05
Measurement delay (measurement_delay_s)s0 – 10Additional delay between each measurement point0.02
Averages (averages)1 – 100Number of readings averaged per point1
Tip NPLC (Number of Power-Line Cycles) suppresses mains noise by aligning the integration to whole multiples of the line frequency (50/60 Hz). 1 PLC (20 ms at 50 Hz) is a good balance for most DC measurements; for noise at low currents you can increase it to 10 PLC.

2.4 Safety & Interlock

🎓 What is it for? — Safety & Interlock Limits

This panel shows the absolute voltage/current/power ceilings the measurement engine will never exceed; it exists to reject a request that could burn the sample or the instrument before it is even sent. It is read-only so it cannot be changed by accident — think of it like a fuse in a circuit: normally invisible, but it cuts the circuit if something goes too far.

  • Why it is done: to prevent sample and instrument damage and dangerous overload.
  • What it teaches / measures: the highest allowed absolute voltage, current compliance and power limits.
  • Where it is used: setup safety; the factory values are effectively unlimited and should be tightened from the configuration file in a real lab.

This category is an information panel (not a form). The limits below are enforced at the hardware level by the measurement engine and are read-only here so they cannot be changed by accident. To change them, the advanced configuration file is used.

Limit (key)MeaningFactory value
Max. absolute voltage (safety_limits.max_abs_voltage)Highest allowed absolute voltage1 000 000 V (effectively unlimited)
Max. current compliance (safety_limits.max_current_compliance)Highest allowed current compliance1 000 000 A (effectively unlimited)
Max. power (safety_limits.max_power)Highest allowed power1 000 000 W (effectively unlimited)
⚠️
Warning The factory values are very large so as to be effectively unlimited; in a real installation these limits should be tightened, via the hardware profile/configuration file, to the safe range of your instrument and sample. If a measurement attempts to exceed this limit, the engine rejects the request.

2.5 Data & File

🎓 What is it for? — Data & File Formats

This setting determines which file types are produced when a measurement is saved (CSV, TXT, Excel, HDF5). You choose based on which program you will process the results with — xlsx if your colleague uses Excel, csv if you will process it with your own script; you can select more than one at the same time.

  • Why it is done: to export results in a format compatible with the tools you will use.
  • What it teaches / measures: the active export formats (export_formats) and the default selection.
  • Where it is used: data sharing, archiving and external analysis workflows.
Setting (key)MeaningValuesDefault
Data format (export_formats)File formats produced when saving/exporting (multiple may be selected)CSV, TXT (tab-separated), Excel XLSX, HDF5 (.h5)["csv","txt","xlsx"]
ℹ️
Note Excel .xlsx uses openpyxl; if it is not installed, the software produces a minimal Excel file with the standard library. HDF5 requires the relevant library.

2.6 Analysis & Computation

🎓 What is it for? — Analysis & Computation Settings

The Analysis workspace extracts metrics (e.g. temporal-response times) from the measurement files you have saved; this tab sets that workspace's defaults — which module comes pre-selected, where files are imported from, and at what percentages the temporal-response thresholds are. If you make the analysis type you use most the default, you start with a single click on every launch.

  • Why it is done: to speed up repeated analyses and work with consistent thresholds.
  • What it teaches / measures: the default analysis module, the import folder and the lower/upper threshold percentages (10%/90%).
  • Where it is used: extracting metrics from loaded data; the routine analysis flow.
Setting (key)MeaningValuesDefault
Default analysis module (analysis.default_module)The module pre-selected when the analysis workspace opensOne of the registered analysis modulestemporal_response

Related keys (not visible in the panel, present in the JSON):

KeyMeaningDefault
analysis.import_directoryFolder for files imported for analysisanalysis_imports
analysis.default_threshold_low_pctLower threshold (%) in temporal-response analysis10.0
analysis.default_threshold_high_pctUpper threshold (%) in temporal-response analysis90.0

2.7 Hardware

🎓 What is it for? — Hardware Settings

The Hardware tab defines how the software talks to real instruments: the VISA address to connect to, the connection timeout, and calibration tracking. Here you tell the computer which instrument to find and where — like saving the instrument's number in a contact list.

  • Why it is done: to connect correctly and reliably to devices such as the SMU and relay board.
  • What it teaches / measures: the VISA resource/timeout, SMU setup mode, switch port and calibration reminder.
  • Where it is used: real hardware setup and troubleshooting connection problems.
Hardware workspace: panel with VISA resource, instrument connection and calibration settings
Figure. Hardware-related workspace — VISA resource, connection and instrument management.
Setting (key)MeaningValuesDefault
VISA resource (visa_resource)VISA address string of the device to connect toE.g. GPIB0::24::INSTR, TCPIP0::192.168.1.10::inst0::INSTR""
VISA timeout (visa_timeout_ms) — AdvancedTimeout for device polling/connection testing (a device-specific value takes precedence)100 – 60 000 ms3000
Calibration reminder (calibration_reminder_enabled)Write a warning to the log at startup when the calibration period has expiredOn / OffOff (false)
Last calibration date (calibration_last_date)Date of last calibration (YYYY-MM-DD)Date text""
Calibration interval (calibration_interval_days) — AdvancedNumber of days between two calibrations1 – 3650 days365

At the bottom of the Hardware panel, the Instruments… button opens the Instrument Registry dialog (see §2.12). Advanced hardware keys present in the JSON:

KeyMeaningDefault
smu_setup_modeSMU setup modedual_channel
dual_channel_model / dual_channel_resource / dual_channel_connection_typeDual-channel SMU model, VISA address, connection type2614B / "" / USB (USBTMC)
smu1_*, smu2_*, diode_smu_*Single/diode SMU model + resource + connection2450 / "" / USB (USBTMC)
switch_port / switch_baudrateSwitch Matrix COM port and baud rate"" / 9600
relay_enabledRelay/Switch Matrix control enabledtrue
selected_tft, tft_mappingSelected TFT and TFT → relay command mappingTFT 1 / 5-entry table

2.8 Lab & Environment (Weather)

🎓 What is it for? — Lab & Environment (Weather)

This feature shows the outdoor weather in a small badge based on the location of the lab you work in. It does not directly affect the measurement; but in sensitive measurements where ambient conditions such as temperature/humidity can influence the results, it is a practical reminder to keep the conditions at the time of recording in mind.

  • Why it is done: to keep ambient conditions in mind and for daily working comfort.
  • What it teaches / measures: weather-badge settings such as location, latitude/longitude and refresh interval.
  • Where it is used: context in environment-sensitive measurements; an optional convenience.
Setting (key)MeaningValues / RangeDefault
Show weather (weather.enabled)Enable the outdoor weather badgeOn / OffOff (false)
Location (city) (weather.location_name)Weather location name (city/district search)Text""
Latitude (weather.latitude) — AdvancedGeographic latitude−90 … 90 °0.0
Longitude (weather.longitude) — AdvancedGeographic longitude−180 … 180 °0.0
Refresh interval (weather.refresh_minutes) — AdvancedHow often the weather data is refreshed5 … 720 min30

Related JSON key: weather.timeout_s (network timeout, default 8.0).

2.9 Account & License

🎓 What is it for? — Account & License

This panel shows the software's license status and is where you activate it: you copy the Machine ID and send it to the vendor, then paste and activate the license key you receive. Without a license, real-device measurements are limited; simulation mode, on the other hand, is always unlimited.

  • Why it is done: to unlock/authorize the full version of the software for real measurements.
  • What it teaches / measures: the Machine ID, license status (Active/Unlicensed) and remaining trial allowance.
  • Where it is used: first purchase/activation and license renewal.

This category is an information/action panel that shows license activation directly within settings:

  • Machine ID: Device-specific identifier; copied to the clipboard with Copy (sent to the vendor to obtain a license).
  • Status: Active (green) or Unlicensed (red) + remaining trial measurement allowance. Simulation mode is unlimited.
  • License Key: Paste the key in PAYLOAD.SIGNATURE format and press Activate License.

Related JSON key: license_check_online (online license check, default true).

2.10 Notifications

🎓 What is it for? — Notifications (Telemetry & Update)

This tab manages the software's two limited contacts with the outside world: anonymous usage telemetry and new-version checking. Telemetry sends only anonymous events such as "which setting changed"; raw measurement data, values or serial numbers are never sent — you can turn it off with a single click if you wish.

  • Why it is done: to make an anonymous contribution to the software's improvement and stay up to date; you decide the privacy preference.
  • What it teaches / measures: the on/off state of telemetry and update checking (and the related JSON keys).
  • Where it is used: turning off telemetry for privacy; stopping update checks on offline/air-gapped networks.
Setting (key)MeaningValuesDefault
Send anonymous usage data (telemetry_enabled)Send anonymous usage telemetry; raw data/serial number is never sentOn / OffOn (true)
Update check enabled (update_check_enabled)Check at startup whether a new version is availableOn / OffOn (true)

Telemetry / privacy — JSON keys

KeyMeaningDefault
telemetry_endpointTelemetry event endpointhttps://telemetry.mikrofab.com/api/events
telemetry_batch_sizeNumber of events collected in a single submission50
telemetry_timeout_sTelemetry network timeout3.0
telemetry.install_idAnonymous installation identifier""
environmentRuntime environment labelbeta
glitchtip_dsn / sentry_dsnError-tracking endpointsGlitchTip filled / Sentry empty
ℹ️
Note Telemetry sends events only at the key level (e.g. "which setting changed"); values and raw measurement data are not sent. During Save, only the name of the changed setting is reported, not its content.

Update — JSON keys

KeyMeaningDefault
update_manifest_urlVersion notification (manifest) addresshttps://download.mikrofab.com/suite/latest.json
update_check_interval_hoursUpdate check frequency24
update_timeout_sUpdate check timeout8.0
update_skip_versionVersion to skip""
info_feed_enabled / info_feed_url / info_feed_timeout_sAnnouncement feed enabled / address / timeouttrue / announcement URL / 8.0

2.11 Feedback

🎓 What is it for? — Feedback

This form lets you send a suggestion, bug or question that occurs to you while using the software directly to the developers — without leaving the application, optionally attaching a file such as a screenshot. The user who experiences a bug describes it best; that is why the feedback that comes from here plays a direct role in improving the software.

  • Why it is done: to record problems and requests and deliver them to the developers.
  • What it teaches / measures: the category, rating, message, contact and attachment fields.
  • Where it is used: bug reporting, feature requests and sharing general opinions.

This category shows the feedback form directly within settings: category (suggestion/bug/question/other), rating (1–5 or none), message, contact (optional) and attachment (≤ 5 MB). It is submitted with Send Feedback.

2.12 Instrument Registry

🎓 What is it for? — Instrument Registry

The registry gathers all the instruments in your lab into a single inventory: you define each instrument once with an understandable name, and measurements refer to it by that name. If an instrument's address changes, you update only here and all measurements adapt automatically — like the contact list on your phone: when a number changes you update the contact, you do not retype the number on every call.

  • Why it is done: to manage device addresses from one place and abstract measurements away from hardware detail.
  • What it teaches / measures: the device's type, model, VISA address and connection form; connection testing with *IDN?.
  • Where it is used: multi-instrument setups, address changes and connection verification.

The Instruments… button in the Hardware category (or the same button in the top bar) opens an NI-MAX / KickStart-style instrument inventory. The logic: you define a device once (understandable name + type + model + VISA address + connection), and measurements refer to it by name. When the address changes, you update it only here.

FieldValues
Type (itype)SMU · Relay/TFT Board · LCR · Other
ModelKnown model keys (dropdown) or free text
Address (VISA) (resource)VISA resource string
Connection (connection)USB (USBTMC) · GPIB · LAN (TCPIP) · RS-232 (Serial)
  • Manage the inventory with Add / Edit / Delete.
  • The Test (*IDN?) button verifies the connection with a *IDN? query without running a measurement; the result appears as ✓/✗ in the row's Status column (it also works in simulation mode).
Tip From the Tools menu at the top right, "Open configuration folder" opens the folder containing the user_config.json file, and "Raw configuration (JSON)" lets you inspect the merged configuration read-only.

3. Troubleshooting

The table below summarizes the most common problems and their solution steps.

3.1 Device not found / cannot connect

  1. Is Simulation Mode on? If mock_mode is on in the General tab, the software never connects to a real device; it generates mock data. For real measurements, turn it off and press Save.
  2. Is the VISA runtime installed? For a real device, NI-VISA, Keysight IO Libraries or R&S VISA must be installed. Not required in simulation.
  3. Is the address correct? Enter the correct VISA string in the visa_resource field of the Hardware tab (e.g. GPIB0::24::INSTR). If auto-discovery fails, enter the address manually.
  4. Test it: Select the device in the Instrument Registry and verify the connection with Test (*IDN?). If it returns ✗, check the address/connection type/power state.
  5. Timeout: On slow GPIB/LAN networks, increase the visa_timeout_ms value (Advanced).

3.2 VISA errors (timeout, resource busy, IO error)

  • Timeout: Increase visa_timeout_ms; check the cable/switch; verify the device responds to *IDN?.
  • Resource busy: If another program is holding the device (e.g. another VISA session, the NI-MAX panel), close it.
  • IO error: There may be a GPIB address conflict or a wrong USBTMC interface; try a clean connection with a single device.

3.3 COM port / Switch Matrix (relay) problems

  • The Switch Matrix is controlled over the COM port with PySerial. Auto-discovery scans for the strings Switch Matrix, Mega, CH340, USB Serial, USB-SERIAL.
  • Port: Select the correct COM port (switch_port); verify the port number from Device Manager.
  • Baud rate: Default 9600; change it if the board expects 115200.
  • No command response: If the board expects a line ending at the end of a command, enable switch_append_newline in the General tab. The command to turn off all relays is a.

3.4 Compliance / limit violation

  • If the measurement current/voltage is hitting the compliance limit you set, the device clamps the current/voltage; the curve looks "flat". Increase current_compliance / voltage_limit from the central SMU defaults to suit your sample.
  • If a request exceeds the Safety & Interlock limits, the engine rejects the request. These limits are read-only; if needed, they are set from the configuration file.
⚠️
Warning Before raising a limit, confirm the safe operating range of your sample and instrument.

3.5 Startup freeze / slow startup

  • On first launch, the packaged .exe shows a splash screen while loading heavy libraries; this is normal, do not click again.
  • If startup truly freezes: temporarily disable the checks that wait for network access — set update_check_enabled and info_feed_enabled to false (the network timeouts are as long as update_timeout_s/info_feed_timeout_s).
  • With Tools → Open configuration folder you can open user_config.json and fix a corrupted value; in the worst case you can return to a clean state with Reset to Defaults.
The software's log console window: timestamped event lines and level filters
Figure. Log console — opened with Ctrl+` when diagnosing startup/connection problems.

3.6 Other common situations

SymptomPossible cause / solution
Save button is disabledNo changes or a numeric field is out of range (red error). Fix the offending row.
Language did not fully changeA restart is requested for some menus; choose "Continue" in the dialog.
.xlsx does not openIf openpyxl is missing, a minimal Excel is produced; install openpyxl for full format.
License is "Unlicensed"Paste the correct key (PAYLOAD.SIGNATURE); verify that the Machine ID matches the one given to the vendor.
Readout panel has too few/too many digitsAdjust with readout_decimals (0–6); the report and results page are not affected.

4. Frequently Asked Questions (FAQ)

Q: I changed my settings but nothing happened?

A: Changes are staged; non-live settings take effect only with Save (or Apply). Theme/font/language, on the other hand, are previewed instantly.

Q: Where are settings stored?

A: The user configuration is in the user_config.json file (Tools → Open configuration folder). The factory defaults come from config/default_config.json and are merged with the user file.

Q: Can I revert a single setting without resetting all settings?

A: Yes. The on a row reverts it to the last saved value; right-clicking the row label and choosing "Reset to default" reverts it to the factory value.

Q: Can I store sets of settings for different setups?

A: Yes. Using Profiles in the bottom bar, save/load named snapshots or Export/Import as *.json. If a profile was saved with a different version, a (non-blocking) incompatibility warning is shown.

Q: What data does telemetry send?

A: Only anonymous usage events and the name of the changed setting — its value, raw measurement data and serial number are never sent. You can turn it off with telemetry_enabled.

Q: Is there a measurement limit in simulation mode?

A: No. Simulation (Mock) mode is unlimited. The unlicensed trial limit applies only to real-device measurements.

Q: I don't know my VISA address.

A: You can read it from tools such as NI-MAX / Keysight Connection Expert, or verify the connection with Test (*IDN?) in the Instrument Registry.

Q: Why can't I change the safety limits?

A: They are read-only to prevent accidental changes; they are set via the hardware profile / advanced configuration.

Q: Which file formats are supported?

A: CSV, TXT (tab-separated), Excel XLSX and HDF5. You can select more than one from the Data & File tab.

5. Glossary (Terms and Abbreviations)

The definitions below are given with the quantities used in the measurement/analysis modules, their units and (where applicable) the standards they are based on.

5.1 TFT / Semiconductor

TermDescriptionUnit
Vth (Threshold voltage)The gate voltage at which the transistor turns on. Extracted via max-gm tangent extrapolation or the Y-function: Vth = Vgs* − Id*/gm,max.V
SS (Subthreshold swing)The gate voltage required to increase the drain current by one decade; an indicator of interface quality. SS = dVgs / d(log₁₀ Id). Standard: IEEE 1620-2008.mV/dec
µFE (Field-effect mobility)The mobility of carriers within the channel; extracted from gm and device geometry (W, L, C_ox).cm²/V·s
gm (Transconductance)gm = dId/dVgs; used in extracting mobility and Vth.S
Ion/Ioff (On-off ratio)The ratio of the highest to the lowest |Id|: Ion/Ioff = max|Id| / min|Id|.
Dit (Interface trap density)The trap state density at the insulator-semiconductor interface (from the SS or admittance method).cm⁻²·eV⁻¹
λ (Channel length modulation)The output conductance parameter in saturation; Early voltage Va = 1/λ.1/V

5.2 Photovoltaic (PV) / Solar Cell

TermDescriptionUnitStandard
Voc (Open-circuit voltage)The cell voltage when the current is zero.VIEC 60904-1
Isc / Jsc (Short-circuit current / current density)The current when the voltage is zero (or per unit area, mA/cm²).A · mA/cm²IEC 60904-1
FF (Fill factor)FF = P_max / (Voc·Isc); the "rectangularity" of the curve. Physically FF ≤ 1.IEC 60904-1/3
PCE / η (Power conversion efficiency)PCE = P_max / P_in · 100. Under 1000 W/m², PCE[%] = Jsc[mA/cm²]·Voc[V]·FF.%IEC 60904-1/3, GUM
MPP (Maximum power point)The (V_mpp, I_mpp) point where the P = V·I product peaks.
Rs / Rsh (Series / shunt resistance)Parasitic resistances extracted by a window fit from the end regions of the I-V curve.Ω (or Ω·cm²)IEC 60904-1
HI (Hysteresis index)The PCE difference between the forward/reverse scan: HI = (PCE_rev − PCE_fwd)/PCE_rev.
STC (Standard test conditions)1000 W/m², 25 °C, AM1.5G reference spectrum. With missing metadata, the result is stamped ⚠ non-STC (non_stc).IEC 60904-3

5.3 Photodetector

TermDescriptionUnitStandard
R (Responsivity)The ratio of photocurrent to incident optical power: R = I_photo / P_in.A/WIEC 60904-8
EQE (External quantum efficiency)The ratio of collected electrons to incident photons; EQE[%] = R·(h·c)/(q·λ)·100.%
IQE (Internal quantum efficiency)Reflection-corrected quantum efficiency; IQE ≥ EQE.%
NEP (Noise-equivalent power)The minimum optical power that gives unity SNR: NEP = noise_density / R.W/√Hz (or W)GUM
D* (Specific detectivity)Area- and band-normalized responsivity: D* = R·√(A·Δf) / i_noise. ~10¹² for Si; >10¹⁴ is suspicious.Jones (cm·√Hz/W)GUM
τ_rise / τ_fall (Rise/fall time)Transition times between thresholds (e.g. 10%–90%).s
LDR (Linear dynamic range)The power range over which the response remains linear.dBIEC 60904-10

5.4 LCR / Impedance

TermDescriptionUnit
C–V / Mott-SchottkyCarrier density and built-in voltage from the depletion capacitance: 1/C² is linear in bias; N from the slope, V_bi from the intercept.F, V, cm⁻³
V_bi (Built-in potential)The equilibrium potential across the junction (from the Mott-Schottky intercept).V
N_eff / N_D (Effective doping / donor density)The ionized dopant density obtained from the Mott-Schottky slope.cm⁻³
W_d (Depletion region width)W = √(2ε(V_bi−V)/(qN)).nm
E_U (Urbach energy)The band-tail characteristic energy of the trap state density.meV
TAS (Thermal admittance spectroscopy)Gives the trap activation energy E_A and attempt frequency ν₀ from an Arrhenius analysis of the C–f inflection frequencies.eV, s⁻¹
τ_n (Recombination lifetime)Carrier lifetime from the equivalent-circuit fit: τ = R_rec·C_µ.s

5.5 RPS / RUS and Uncertainty

TermDescriptionUnit
RPS (Resonant piezoelectric spectroscopy)Extracts f₀, Q and the relative piezo response from the resonance of the piezoelectric response with frequency.Hz, —
RUS (Resonant ultrasound spectroscopy)Extracts the full elastic tensor (C_ij) and elastic moduli (forward/inverse problem) from a sample's resonance spectrum.GPa
Q (Quality factor)The sharpness of the resonance; proportional to the inverse of the acoustic damping.
C_ij (Elastic tensor components)The stiffness matrix elements of the material.GPa
GUMGuide to the Uncertainty in Measurement (JCGM 100:2008). Uncertainties are propagated from the fit covariance at k = 1 (standard uncertainty); this is the framework for all uncertainty reporting in this software.
PLC / NPLCNumber of power-line cycles; suppresses noise by aligning the integration to 50/60 Hz.PLC
ℹ️
Note The single formatter in the software (format_quantity) writes the ± uncertainty term for a value only when the standard uncertainty > 0 and there are at least 2 measurements; if the value is missing it shows an em dash (never 0). Numbers are shown with SI prefixes (n, µ, m, k, M…); %, dB and Jones take no prefix.

6. Keyboard Shortcuts

ShortcutFunction
Ctrl+K / Ctrl+POpen the command palette (workspaces + registry search)
Ctrl+,Open the Settings (Preferences) workspace
Ctrl+OOpen a CSV/measurement file
Ctrl+RGenerate a report
Ctrl+FFocus the top-bar search box
Ctrl+QQuit the application
Ctrl+`Toggle the log console
F11Toggle full screen
Alt+Left / Alt+RightNavigate back / forward (browser-style; the mouse side buttons also work)
EscStop the measurement if one is running; otherwise cancel field editing/the panel
ℹ️
Note Back/Forward is bound to the platform's standard shortcuts (on Windows Alt+Left/Alt+Right) and to the dedicated browser keys on the keyboard. When modal windows are open, Esc closes that window and does not interfere with navigation.
Tip To see all the configuration keys in this section live, use the Tools → Raw configuration (JSON) window; the values it shows match the tables in this guide exactly.