Nomogram

Description

Returns the nomogram refraction (sphere, cylinder and axis) for a single patient with specific preoperative and operational conditions.
Allows treatment path calculations for Alcon EX500 laser with WFO or CONTOURA laser mode.

Background
Nomograms are algorithm that may help adjusting refractive surgery plans with reference to the preoperative manifest refraction, age of the patient, the used laser treatment (LASIK, PRK), the laser mode and optical zone, and refractive targets. Zubisoft's laser nomograms and technologies are unique and the best in their class. They use proprietary algorithm with up to nine different factors to calculate accurate laser performance profiles. Polynomial and best-fit regression analysis is applied to Zubisoft's global and national reference databases with more than 400'000 refractive treatments from a wide range of treatment methods (LASIK, Trans-PRK, PRK), laser modes (WFO, CONTOURA, Aspheric, Wavefront Guided), and excimer lasers (Alcon, Schwind, VISX, Zeiss). Nomogram refraction in combination with other treatment relevant parameters will allow the surgeon to decide on the refractive correction finally applied.

URL

POST https://www.zubisoft.com/api/nomogram

Permission

Standard authentication with public key, hashed private key and user key is required.

Parameters

The following parameters are required. Please use exact naming as provided in the comment column. Please submit only ID of the laser.

Name Format Comment
date_birth_year Integer 1955
date_birth_month Integer 10
date_birth_day Integer 25
manifest_sphere_pre Float Pre-operational sphere (-25 to 25)
manifest_cylinder_pre Float Pre-operational cylinder (-20 to 20)
manifest_axis_pre Integer Pre-operational axis (-180 to 180)
method String Supported methods for excimer laser:
  • LASIK
  • PRK
  • Trans-PRK
  • LASEK
Supported methods for femto laser:
  • Lenticule Extraction
Please note that not all methods may return a result (contact us for more details)
laser Integer Supported laser platforms (submit ID only):
  • ID=2 (Alcon WaveLight Eye-Q)
  • ID=3 (Alcon WaveLight EX500)
  • ID=6 (Johnson & Johnson VISX S4)
  • ID=8 (Ziemer Aquariuz)
  • ID=9 (Ziemer LDV)
  • ID=10 (Schwind Amaris 500E)
  • ID=11 (Schwind Amaris 750S)
  • ID=12 (Schwind Amaris 1050RS)
  • ID=13 (Schwind ATOS)
  • ID=15 (ZEISS Mel 80)
  • ID=16 (ZEISS Mel 90)
  • ID=17 (ZEISS VisuMax)
  • ID=19 (Bausch Technolas 217)
  • ID=21 (NIDEK EC-5000)
laser_mode String Supported laser modes (submit exact terms, e.g. 'Wavefront WaveScan'):
  • Alcon WaveLight: WFO, CONTOURA, Topography guided, Wavefront guided
  • VISX S4: Conventional, Wavefront WaveScan, Wavefront iDesign
  • Schwind Amaris: Aspheric aberration-free, Corneal wavefront, Ocular wavefront
  • ZEISS MEL 80 / MEL 90: Aspheric
  • ZEISS VisuMax: SMILE
  • Bausch Technolas z217: Aspheric
  • NIDEK EX-5000: Aspheric
Please note that not all laser modes may return a result (contact us for more details)
intervention String
  • first (needs to be first, in the future 'second' will be added for nomograms on retreatment data)
laser_optical_zone Float 1 to 10
target_sphere Float -20 to 20
target_cylinder Float -15 to 15
treatment_path String Only for Alcon EX500 ("laser":3) and WFO ("laser_mode":"WFO") or CONTOURA. Supported paths:
  • with WFO: B0 = no adjustment
  • with WFO: B1 = with intelligent rounding
  • with WFO: B2 = with intelligent rounding + age adjustment
  • CONTOURA: T0 = Topography Modified Refraction (50/50 Mix)
  • CONTOURA: T1 = Topography Modified Refraction (70/30 Mix)
CONTOURA paths T0 and T1 require topography_cylinder_pre AND topography_axis_pre values (see below).
Please note that paths outputs are for research and comparison purpose only (contact us for more details).
topography_cylinder_pre Float Only for Alcon EX500 ("laser":3) and CONTOURA ("laser_mode":"CONTOURA").
  • Result only show if topography_cylinder_pre AND topography_axis_pre values are provided
  • Result only show if treatment_path is set to T0 or T1
  • Works only with negative cylinders, e.g. -2.45
topography_axis_pre Integer Only for Alcon EX500 ("laser":3) and CONTOURA ("laser_mode":"CONTOURA").
  • Result only show if topography_cylinder_pre AND topography_axis_pre values are provided
  • Result only show if treatment_path is set to T0 or T1
  • Range of axis values: 0 to 180 degrees, e.g. 85

{
	"date_birth_year":"1992",
	"date_birth_month":"11",
	"date_birth_day":"25",
	"manifest_sphere_pre":-5.25,
	"manifest_cylinder_pre":-1.75,
	"manifest_axis_pre":95,
	"method": "LASIK",
	"laser":3,
	"laser_mode":"WFO",
	"intervention":"first",
	"laser_optical_zone":6.5,
	"target_sphere":0,
	"target_cylinder":0
}


{
	"date_birth_year":"1992",
	"date_birth_month":"11",
	"date_birth_day":"25",
	"manifest_sphere_pre":-5.25,
	"manifest_cylinder_pre":-1.75,
	"manifest_axis_pre":95,
	"method": "LASIK",
	"laser":3,
	"laser_mode":"WFO",
	"intervention":"first",
	"laser_optical_zone":6.5,
	"target_sphere":0,
	"target_cylinder":0,
	"treatment_path":"B2"
}


{
	"date_birth_year":"1992",
	"date_birth_month":"11",
	"date_birth_day":"25",
	"manifest_sphere_pre":-5.25,
	"manifest_cylinder_pre":-1.75,
	"manifest_axis_pre":95,
	"method": "LASIK",
	"laser":3,
	"laser_mode":"CONTOURA",
	"intervention":"first",
	"laser_optical_zone":6.5,
	"target_sphere":0,
	"target_cylinder":0,
	"treatment_path":"T0",
	"topography_cylinder_pre":-2.45,
	"topography_axis_pre":85
}


curl --location --request POST 'https://www.zubisoft.com/api/nomogram' \
--header 'Content-Type: application/json' \
--header 'X-Public-Key: yourPublicKey' \
--header 'X-Private-Key: hashOfYourPrivateKey' \
--header 'X-User-Key: yourUserKey' \
--data-raw '{
	"date_birth_year": "1996",
	"date_birth_month":"08",
	"date_birth_day":"14",
	"manifest_sphere_pre":-4.75,
	"manifest_cylinder_pre": -0.25,
	"manifest_axis_pre": 10,
	"method": "Lenticule Extraction",
	"laser": 17,
	"laser_mode": "SMILE",
	"intervention": "first",
	"laser_optical_zone": 6.5,
	"target_sphere": 0,
	"target_cylinder": 0
}'

Response

Response is nomogram refraction and prediction (estimation of effective correction if treatment is not adjusted)

Name Format [Unit] Example Comment
nomogram_sphere Float [diopter] -5.21
nomogram_cylinder Float [diopter] -1.399
nomogram_axis Float [degree] 95
prediction_sphere Float [diopter] -5.3
prediction_cylinder Float [diopter] -2.139
prediction_axis Float [degree] 95
treatment_path_sphere Float [diopter] -5.75 Alcon EX500 laser only (laser ID=3)
treatment_path_cylinder Float [diopter] -1.25 Alcon EX500 laser only (laser ID=3)
treatment_path_axis Float [degree] 95 Alcon EX500 laser only (laser ID=3)

{
    "nomogram_sphere": -5.21,
    "nomogram_cylinder": -1.399,
    "nomogram_axis": 95,
    "prediction_sphere": -5.3,
    "prediction_cylinder": -2.139,
    "prediction_axis": 95
}


{
    "nomogram_sphere": -5.21,
    "nomogram_cylinder": -1.399,
    "nomogram_axis": 95,
    "prediction_sphere": -5.3,
    "prediction_cylinder": -2.139,
    "prediction_axis": 95,
    "treatment_path_sphere": -5.75,
    "treatment_path_cylinder": -1.25,
    "treatment_path_axis": 95
}


{
    "nomogram_sphere": -4.956,
    "nomogram_cylinder": -1.752,
    "nomogram_axis": 95,
    "prediction_sphere": -5.59,
    "prediction_cylinder": -1.748,
    "prediction_axis": 95,
    "treatment_path_sphere": -4.776,
    "treatment_path_cylinder": -2.123,
    "treatment_path_axis": 85
}

Error Messages

The following messages are returned in case of an error in the provided nomogram data or calculation. Please also note general HTTP Response Codes (here).

Error Feedback Description
Incorrect format of: {field name} Provided data is in the wrong format, e.g. string "laser":"Alcon EX500", instead of integer "laser":3
Incorrect range of parameter: {field name} Provided data is out of allowed range, e.g. for "manifest_axis_pre":240, but value should be between 0 and 180
Missing mandatory parameter: {field name} Mandatory field is missing or incorrectly worded, e.g. "meth":"PRK", instead of "method":"PRK"
Incorrect number of request parameters: {number of provided fields} If the minimium of required fields / parameters (n=13) is not provided
Reference data out of range In case the nomogram values show a very high deviation from preop. refraction (difference>20%)