JV File
The JV file contains a table with the JV parameters. Followed by the JV scan itself.
File structure¶
Updated header structure
As of v2.4.0, the file headers are updated to include all available settings. The legacy version is still available by setting FileHeaderVersion = 1 in the configuration file.
Due to the large amount of different configuration for any measurement, the file structure is dynamic and will change based on the configuration:
[General Info]:Temperatureis included only if a temperature sensor is configured.[Environment Settings]shows the fixedIrradiance (mW/cm²)value instead if no environment is selected.[Day-Night Settings]is only included if it is configured.[Environment]shows the value of the associated sensors during the JV. It is only included if an environment is selected.- If
Forward OnlyorReverse Onlyis selected as the scan order, the columns for the scan which is not performed are omitted. - Columns are always sorted
V_FW J_FW V_RV J_RV. Even ifRV then FWis selected as the scan order
Example data¶
Below you can find several example header structures based on which settings are configured. The v1 (legacy) header is static and doesn't change based on the settings.
## Header ##
[General info]
User Cicci Research
Device Sample
Cell area (cm2) 1
Test Stability (JV)
Date 2026-04-15
Time 12:03:16
Note SMU 1A
[Channel Settings]
Voltage Range 10 V
Current Range 18 mA (L)
[Cell Settings]
Inverted No
Type Cell
Cell Area (cm2) 1
#Cells 1
[JV Settings]
Vmin (V) -0.1
Vmax (V) 1.2
Voltage Step (mV) 20
Scan Rate (mV/s) 100
Scan Direction FW then RV
Auto-detect Voc Yes
Overvoltage (%) 10
[Environment Settings]
Irradiance (mW/cm²) 100
## Parameters ##
[Forward]
Voc (V) 0.42734
Jsc (A/cm²) 1.2063E-3
V_MPP (V) 0.31782
J_MPP (A/cm²) 9.08699E-4
P_MPP (W/cm²) 2.88804E-4
Rs (Ohm) 5.70E+1
R// (Ohm) 1.70E+3
FF (%) 56.024
Eff (%) 0.289
[Reverse]
Voc (V) 0.42772
Jsc (A/cm²) 1.2053E-3
V_MPP (V) 0.31959
J_MPP (A/cm²) 9.03369E-4
P_MPP (W/cm²) 2.88704E-4
Rs (Ohm) 5.68E+1
R// (Ohm) 1.66E+3
FF (%) 55.999
Eff (%) 0.289
## Data ##
V_FW (V) J_FW (A/cm²) V_RV (V) J_RV (A/cm²)
-7.79197E-2 1.25566E-3 4.76568E-1 -1.35698E-3
-5.72929E-2 1.24190E-3 4.58934E-1 -7.10248E-4
-3.83118E-2 1.22759E-3 4.38779E-1 -2.26132E-4
-1.70949E-2 1.21721E-3 4.19906E-1 1.39897E-4
2.08288E-3 1.20497E-3 3.99207E-1 3.99430E-4
...
## Header ##
[General info]
User Cicci Research
Device Sample
Cell area (cm2) 1
Test Stability (JV)
Date 2026-02-24
Time 11:49:25
Temperature 25.63
Note SMU 1A
[Channel Settings]
Voltage Range 10 V
Current Range 18 mA (L)
[Cell Settings]
Inverted No
Type Cell
Cell Area (cm2) 1
#Cells 1
[JV Settings]
Vmin (V) -0.1
Vmax (V) 0.7
Voltage Step (mV) 40
Scan Rate (mV/s) 200
Scan Order FW then RV
Auto-detect Voc Yes
Overvoltage (%) 0
[Environment Settings]
Name Light Soaker
Humidity Square4x6:Humidity
Temperature Square4x6:Temperature
Luminosity Pyranometer:lum
[Environment]
Irradiance (mW/cm²) 98.13
Temperature (°C) 25.63
Humidity (%) 56.2
## Parameters ##
[Forward]
Voc (V) 0.42734
Jsc (A/cm²) 1.2063E-3
V_MPP (V) 0.31782
J_MPP (A/cm²) 9.08699E-4
P_MPP (W/cm²) 2.88804E-4
Rs (Ohm) 5.70E+1
R// (Ohm) 1.70E+3
FF (%) 56.024
Eff (%) 0.289
[Reverse]
Voc (V) 0.42772
Jsc (A/cm²) 1.2053E-3
V_MPP (V) 0.31959
J_MPP (A/cm²) 9.03369E-4
P_MPP (W/cm²) 2.88704E-4
Rs (Ohm) 5.68E+1
R// (Ohm) 1.66E+3
FF (%) 55.999
Eff (%) 0.289
## Data ##
V_FW (V) J_FW (A/cm²) V_RV (V) J_RV (A/cm²)
-7.79197E-2 1.25566E-3 4.76568E-1 -1.35698E-3
-5.72929E-2 1.24190E-3 4.58934E-1 -7.10248E-4
-3.83118E-2 1.22759E-3 4.38779E-1 -2.26132E-4
-1.70949E-2 1.21721E-3 4.19906E-1 1.39897E-4
2.08288E-3 1.20497E-3 3.99207E-1 3.99430E-4
...
## Header ##
[General info]
User Cicci Research
Device Sample
Cell area (cm2) 1
Test Stability (JV)
Date 2026-02-24
Time 11:49:25
Temperature 25.63
Note SMU 1A
[Channel Settings]
Voltage Range 10 V
Current Range 18 mA (L)
[Cell Settings]
Inverted No
Type Cell
Cell Area (cm2) 1
#Cells 1
[JV Settings]
Vmin (V) -0.1
Vmax (V) 0.7
Voltage Step (mV) 40
Scan Rate (mV/s) 200
Scan Order FW then RV
Auto-detect Voc Yes
Overvoltage (%) 0
[Environment Settings]
Name Light Soaker
Humidity Square4x6:Humidity
Temperature Square4x6:Temperature
Luminosity Pyranometer:lum
[Day-Night Settings]
Sensor lum
Unit mW/cm²
Threshold Value 10
Threshold Duration 5
Night Algorithm Fixed Voltage
Night JV Disable
Constant Output 0
[Environment]
Irradiance (mW/cm²) 98.13
Temperature (°C) 25.63
Humidity (%) 56.2
## Parameters ##
[Forward]
Voc (V) 0.42734
Jsc (A/cm²) 1.2063E-3
V_MPP (V) 0.31782
J_MPP (A/cm²) 9.08699E-4
P_MPP (W/cm²) 2.88804E-4
Rs (Ohm) 5.70E+1
R// (Ohm) 1.70E+3
FF (%) 56.024
Eff (%) 0.289
[Reverse]
Voc (V) 0.42772
Jsc (A/cm²) 1.2053E-3
V_MPP (V) 0.31959
J_MPP (A/cm²) 9.03369E-4
P_MPP (W/cm²) 2.88704E-4
Rs (Ohm) 5.68E+1
R// (Ohm) 1.66E+3
FF (%) 55.999
Eff (%) 0.289
## Data ##
V_FW (V) J_FW (A/cm²) V_RV (V) J_RV (A/cm²)
-7.79197E-2 1.25566E-3 4.76568E-1 -1.35698E-3
-5.72929E-2 1.24190E-3 4.58934E-1 -7.10248E-4
-3.83118E-2 1.22759E-3 4.38779E-1 -2.26132E-4
-1.70949E-2 1.21721E-3 4.19906E-1 1.39897E-4
2.08288E-3 1.20497E-3 3.99207E-1 3.99430E-4
...
## Header ##
[General info]
User Cicci Research
Device Silicon
Cell area (cm2) 1
Test Stability (JV)
Date 2026-01-13
Time 16:53:26
Note SMU 1D
[JV Settings]
Vmin (V) -0.100
Vmax (V) 0.700
Voltage Step (mV) 20.000
Scan Rate (mV/s) 100.000
Auto-detect Voc Yes
Scan direction FW then RV
Voltage Range (V) 10 V
Current Range (V) L
Inverted No
Auto-range On
[Cell Settings]
Tipology Cell
Cell Area (cm2) 1.00
#Cells 1.00
W cell area (cm2) 1.00
#W cells 1.00
## Data ##
Scan Voc Jsc V_MPP J_MPP P_MPP Rs R// FF Eff
V mA/cm² V mA/cm² mW/cm² Ohm Ohm % %
FW 0.458325 1.059331 0.364180 0.932366 0.339549 3.75E+1 6.20E+5 69.94 0.34
RV 0.458902 1.059199 0.357920 0.941816 0.337095 3.65E+1 8.73E+4 69.35 0.34
V_FW (V) J_FW (mA/cm²) V_RV (V) J_RV (mA/cm²)
-1.10653E-1 1.05974E+0 5.20086E-1 -4.66223E+0
-9.06952E-2 1.06152E+0 5.02734E-1 -2.51252E+0
-7.07408E-2 1.05924E+0 4.84707E-1 -1.11390E+0
-5.01796E-2 1.06117E+0 4.67572E-1 -2.65807E-1
-3.05984E-2 1.06002E+0 4.46978E-1 2.46510E-1
-1.06036E-2 1.05916E+0 4.27515E-1 5.44715E-1
1.03375E-2 1.05961E+0 4.07865E-1 7.32007E-1
2.93350E-2 1.05967E+0 3.87815E-1 8.44080E-1
4.88898E-2 1.05894E+0 3.67467E-1 9.14722E-1
6.97690E-2 1.05831E+0 3.49364E-1 9.62141E-1
...