Skip to main content

CSV Bulk calculations specifications: DIA

This type of CSV allows to get, for each row, adjusted scores according to duration of diabetes.

Adjusts conventional FRAX® estimates of fracture probability in diabetes. Where BMD is entered, the adjustment uses the duration of diabetes. Where BMD is not entered, duration is not used and the probability is recalculated with diabetes entered as a cause of secondary osteoporosis.

Input Variables

A CSV input file should always have 14 columns. An optional header can be sent as first line of the CSV file:

Score unit,Country,Age,Sex,BMI,Previous fracture,Parental history,Current smoker,Gluccocorticoid,Rheumatoid Arthritis,Secondary osteoporosis,Alcohol,Femoral neck BMD,Duration

The first columns are the FRAX variables:

# Col Variable Description Possible Values
1 A Score unit Unit for variable 13 t: T-score, z: Z-score. Unit for parameter 13 (BMD) described below.
2 B Country Code for country and ethnicity Integer. Get valid countries' id from the API.
3 C Age Age in years Positive real number (40-90), can have decimals. Out of bound values are capped before the calculation. An age below 40 is set to 40. An age above 90 is set to 90. No message is added to the output line. The output file repeats each input line exactly as you submitted it.
4 D Sex Gender 0: men, 1: women
5 E BMI Body Mass Index Positive real number from 5 to 125 (kg/m²), can have decimals. Out of bound values are rejected. In this case, the row is not calculated. An error message is added at the end of the output line.
6 F Previous fracture History of previous fracture 0: no, 1: yes
7 G Parental history Parent(s) with hip fracture history 0: no, 1: yes
8 H Current smoker Current smoking status 0: no, 1: yes
9 I Gluccocorticoid Gluccocorticoid use 0: no, 1: yes
10 J Rheumatoid Arthritis Presence of rheumatoid arthritis 0: no, 1: yes
11 K Secondary osteoporosis Presence of secondary osteoporosis 0: no, 1: yes
12 L Alcohol More than two drinks a day 0: no, 1: yes
13 M Femoral neck BMD Bone mineral density measurement Real number (T-score or Z-score). The T-score for both genders should be derived by comparing the individual BMD to the young normal FEMALE NHANES III reference range for the make of scanner that you are using. This value is optional, submit an empty string for a calculation without BMD only. T-scores and Z-scores are not capped.

Then we need the adjustment variable:

# Col Variable Description Possible Values
14 N Duration Duration of diabetes <5y Less than five years, 5-10y between five and ten years, >10y more than ten years. This value is only used when column 13 (Femoral neck BMD) is filled in. Submit an empty string for a calculation without BMD.

Output Results

Once processed, you will receive an output file with, for each row, the results append to the original line (the variables above).

# Col Result Description
15 O FRAX MOF wo BMD major osteoporotic fracture risk without BMD
16 P FRAX Hip wo BMD hip fracture risk without BMD
17 Q FRAX MOF w BMD major osteoporotic fracture risk with BMD
18 R FRAX HIP w BMD hip fracture risk with BMD
19 S DIA MOF wo BMD Adjusted MOF without BMD according to duration of diabetes
20 T DIA Hip wo BMD Adjusted HIP without BMD according to duration of diabetes
21 U DIA MOF w BMD Adjusted MOF with BMD according to duration of diabetes
22 V DIA Hip w BMD Adjusted HIP with BMD according to duration of diabetes

Output warning or error reporting

If an error for any adjustments of the row has been triggered, a specific message will be added at the end of the line.

# Col Processor messages
23 W Warning or error messages