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:
|
laser | Integer | Supported laser platforms (submit ID only):
|
laser_mode | String | Supported laser modes (submit exact terms, e.g. 'Wavefront WaveScan'):
|
intervention | String |
|
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:
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").
|
topography_axis_pre | Integer | Only for Alcon EX500 ("laser":3) and CONTOURA ("laser_mode":"CONTOURA").
|
{
"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%) |