Enums

Enum classes provide type-safe configuration options for chart formatting and styling.

ArrowHead

import datawrapper as dw
connector = dw.ConnectorLine(arrow_head=dw.ArrowHead.TRIANGLE)

Name	Value
`LINES`	`"lines"`
`TRIANGLE`	`"triangle"`
`NONE`	`"False"`

ConnectorLineType

import datawrapper as dw
connector = dw.ConnectorLine(type=dw.ConnectorLineType.CURVE_RIGHT)

Name	Value
`STRAIGHT`	`"straight"`
`CURVE_RIGHT`	`"curveRight"`
`CURVE_LEFT`	`"curveLeft"`

DateFormat

import datawrapper as dw
chart = dw.LineChart(x_grid_format=dw.DateFormat.MONTH_ABBREVIATED_WITH_YEAR)

Name	Value
`AUTO`	`"auto"`
`YEAR_FULL`	`"YYYY"`
`YEAR_TWO_DIGIT`	`"YY"`
`YEAR_ABBREVIATED`	`"'YY"`
`YEAR_ABBREVIATED_FIRST`	`"YYYY~~'YY"`
`QUARTER`	`"Q"`
`YEAR_QUARTER`	`"YYYY [Q]Q"`
`YEAR_QUARTER_MULTILINE`	`"YYYY\\|[Q]Q"`
`MONTH_FULL`	`"MMMM"`
`MONTH_ABBREVIATED`	`"MMM"`
`MONTH_NUMBER_PADDED`	`"MM"`
`MONTH_NUMBER`	`"M"`
`MONTH_ABBREVIATED_WITH_YEAR`	`"MMM 'YY"`
`YEAR_MONTH_MULTILINE`	`"YYYY\\|MMM"`
`WEEK_OF_YEAR_PADDED`	`"ww"`
`WEEK_OF_YEAR`	`"w"`
`WEEK_OF_YEAR_ORDINAL`	`"wo"`
`DAY_PADDED`	`"DD"`
`DAY`	`"D"`
`DAY_ORDINAL`	`"Do"`
`MONTH_DAY_MULTILINE`	`"MMM\\|DD"`
`MONTH_DAY_YEAR_FULL`	`"MMMM D, YYYY"`
`DAY_OF_WEEK_FULL`	`"dddd"`
`DAY_OF_WEEK_SHORT`	`"ddd"`
`DAY_OF_WEEK_MIN`	`"dd"`
`DAY_OF_WEEK_NUMBER`	`"d"`
`SPORT_SEASON_FULL`	`"BB"`
`SPORT_SEASON_ABBREVIATED`	`"B"`
`HOUR_24_PADDED`	`"HH"`
`HOUR_24`	`"H"`
`HOUR_12_PADDED`	`"hh"`
`HOUR_12`	`"h"`
`HOUR_24_ALT_PADDED`	`"kk"`
`HOUR_24_ALT`	`"k"`
`MINUTE_PADDED`	`"mm"`
`MINUTE`	`"m"`
`SECOND_PADDED`	`"ss"`
`SECOND`	`"s"`
`MILLISECOND`	`"SSS"`
`AM_PM_UPPER`	`"A"`
`AM_PM_LOWER`	`"a"`
`TIMEZONE_OFFSET`	`"Z"`
`TIMEZONE_OFFSET_NO_COLON`	`"ZZ"`
`UNIX_TIMESTAMP_SECONDS`	`"X"`
`UNIX_TIMESTAMP_MILLISECONDS`	`"x"`
`LOCALE_DATE_SHORT`	`"L"`
`LOCALE_DATE_LONG`	`"LL"`
`LOCALE_DATETIME_SHORT`	`"LLL"`
`LOCALE_DATETIME_LONG`	`"LLLL"`
`LOCALE_TIME`	`"LT"`

GridDisplay

import datawrapper as dw
chart = dw.LineChart(x_grid_display=dw.GridDisplay.ON)

Name	Value
`OFF`	`"off"`
`ON`	`"on"`
`TICKS`	`"ticks"`
`LINES`	`"lines"`

GridLabelAlign

import datawrapper as dw
chart = dw.BarChart(axis_label_align=dw.GridLabelAlign.CENTER)

Name	Value
`LEFT`	`"left"`
`RIGHT`	`"right"`

GridLabelPosition

import datawrapper as dw
chart = dw.ColumnChart(y_grid_label_position=dw.GridLabelPosition.INSIDE)

Name	Value
`AUTO`	`"auto"`
`INSIDE`	`"inside"`
`OUTSIDE`	`"outside"`
`OFF`	`"off"`
`ON`	`"on"`

LineDash

import datawrapper as dw
line = dw.Line(column="temperature", dash=dw.LineDash.DASHED)

Name	Value
`SOLID`	`"style0"`
`SHORT_DASH`	`"style1"`
`MEDIUM_DASH`	`"style2"`
`LONG_DASH`	`"style3"`

LineInterpolation

import datawrapper as dw
line = dw.Line(column="temperature", interpolation=dw.LineInterpolation.CURVED)

Name	Value
`LINEAR`	`"linear"`
`STEP`	`"step"`
`STEP_AFTER`	`"step-after"`
`STEP_BEFORE`	`"step-before"`
`CARDINAL`	`"cardinal"`
`MONOTONE`	`"monotone-x"`
`MONOTONE_X`	`"monotone-x"`
`CURVED`	`"monotone-x"`
`NATURAL`	`"natural"`

LineWidth

import datawrapper as dw
line = dw.Line(column="temperature", width=dw.LineWidth.THICK)

Name	Value
`THINNEST`	`"style3"`
`THIN`	`"style0"`
`MEDIUM`	`"style1"`
`THICK`	`"style2"`
`INVISIBLE`	`"invisible"`

NumberDivisor

import datawrapper as dw
col_format = dw.ColumnFormat(column="revenue", number_divisor=dw.NumberDivisor.DIVIDE_BY_MILLION)

Name	Value
`NO_CHANGE`	`"0"`
`AUTO_DETECT`	`"auto"`
`DIVIDE_BY_THOUSAND`	`"3"`
`DIVIDE_BY_MILLION`	`"6"`
`DIVIDE_BY_BILLION`	`"9"`
`MULTIPLY_BY_HUNDRED`	`"-2"`
`MULTIPLY_BY_THOUSAND`	`"-3"`
`MULTIPLY_BY_MILLION`	`"-6"`
`MULTIPLY_BY_BILLION`	`"-9"`
`MULTIPLY_BY_TRILLION`	`"-12"`

NumberFormat

import datawrapper as dw
chart = dw.BarChart(axis_label_format=dw.NumberFormat.THOUSANDS_SEPARATOR)

Name	Value
`AUTO`	`"auto"`
`THOUSANDS_WITH_OPTIONAL_DECIMALS`	`"0,0.[00]"`
`INTEGER`	`"0"`
`ONE_DECIMAL`	`"0.0"`
`TWO_DECIMALS`	`"0.00"`
`THREE_DECIMALS`	`"0.000"`
`UP_TO_ONE_DECIMAL`	`"0.[0]"`
`UP_TO_TWO_DECIMALS`	`"0.[00]"`
`PERCENT_INTEGER`	`"0%"`
`PERCENT_ONE_DECIMAL`	`"0.0%"`
`PERCENT_TWO_DECIMALS`	`"0.00%"`
`PERCENT_UP_TO_ONE_DECIMAL`	`"0.[0]%"`
`PERCENT_UP_TO_TWO_DECIMALS`	`"0.[00]%"`
`THOUSANDS_SEPARATOR`	`"0,0"`
`ORDINAL`	`"0o"`
`ABBREVIATED`	`"0a"`
`ABBREVIATED_ONE_DECIMAL`	`"0.[0]a"`
`ABBREVIATED_TWO_DECIMALS`	`"0.[00]a"`
`ABBREVIATED_THREE_DECIMALS`	`"0.[000] a"`
`PLUS_SIGN`	`"+0"`
`PLUS_SIGN_PERCENT`	`"+0%"`
`CURRENCY_ABBREVIATED_WITH_PLUS`	`"+$0.[00]a"`
`CURRENCY_ABBREVIATED`	`"$0.[00]a"`
`CURRENCY_OPTIONAL_DECIMALS`	`"$0.[00]"`
`ZERO_PADDED`	`"0000"`
`PARENTHESES_FOR_NEGATIVES`	`"(0,0.00)"`
`LEADING_DECIMAL`	`".000"`
`SCIENTIFIC_NOTATION`	`"0,0e+0"`
`SCIENTIFIC_NOTATION_DECIMALS`	`"0.[00]e+0"`
`ABSOLUTE_VALUE`	`"\\|0.0\\|"`

RegressionMethod

import datawrapper as dw
chart = dw.ScatterPlot(regression_method=dw.RegressionMethod.LINEAR)

Name	Value
`LINEAR`	`"linear"`
`QUADRATIC`	`"quadratic"`
`CUBIC`	`"cubic"`
`EXPONENTIAL`	`"exponential"`
`LOGARITHMIC`	`"logarithmic"`
`POWER`	`"power"`

ReplaceFlagsType

import datawrapper as dw
chart = dw.BarChart(replace_flags=dw.ReplaceFlagsType.FOUR_BY_THREE)

Name	Value
`OFF`	`"off"`
`FOUR_BY_THREE`	`"4x3"`
`ONE_BY_ONE`	`"1x1"`
`CIRCLE`	`"circle"`

ScatterAxisPosition

import datawrapper as dw
chart = dw.ScatterPlot(x_axis_position=dw.ScatterAxisPosition.BOTTOM)

Name	Value
`BOTTOM`	`"bottom"`
`TOP`	`"top"`
`LEFT`	`"left"`
`RIGHT`	`"right"`
`ZERO`	`"zero"`
`OFF`	`"off"`

ScatterGridLines

import datawrapper as dw
chart = dw.ScatterPlot(x_grid_lines=dw.ScatterGridLines.ON)

Name	Value
`ON`	`"on"`
`OFF`	`"off"`
`NO_LABELS`	`"no-labels"`
`JUST_LABELS`	`"just-labels"`

ScatterShape

import datawrapper as dw
chart = dw.ScatterPlot(shape=dw.ScatterShape.CIRCLE)

Name	Value
`CIRCLE`	`"symbolCircle"`
`SQUARE`	`"symbolSquare"`
`DIAMOND`	`"symbolDiamond"`
`TRIANGLE`	`"symbolTriangle"`
`TRIANGLE_DOWN`	`"symbolTriangleDown"`
`CROSS`	`"symbolCross"`
`STAR`	`"symbolStar"`
`WYE`	`"symbolWye"`

ScatterSize

import datawrapper as dw
chart = dw.ScatterPlot(size=dw.ScatterSize.MEDIUM)

Name	Value
`FIXED`	`"fixed"`
`DYNAMIC`	`"dynamic"`

StrokeType

import datawrapper as dw
connector = dw.RangeAnnotation(stroke_type=dw.StrokeType.DASHED)

Name	Value
`SOLID`	`"solid"`
`DASHED`	`"dashed"`
`DOTTED`	`"dotted"`

StrokeWidth

import datawrapper as dw
connector = dw.ConnectorLine(stroke=dw.StrokeWidth.MEDIUM)

Name	Value
`THIN`	`1`
`MEDIUM`	`2`
`THICK`	`3`

SymbolDisplay

import datawrapper as dw
symbol = dw.LineSymbol(display=dw.SymbolDisplay.FIRST_LAST)

Name	Value
`EVERY`	`"every"`
`FIRST`	`"first"`
`LAST`	`"last"`
`BOTH`	`"both"`

SymbolShape

import datawrapper as dw
symbol = dw.LineSymbol(shape=dw.SymbolShape.CIRCLE)

Name	Value
`CIRCLE`	`"circle"`
`SQUARE`	`"square"`
`DIAMOND`	`"diamond"`
`TRIANGLE`	`"triangle"`
`CROSS`	`"cross"`

SymbolStyle

import datawrapper as dw
symbol = dw.LineSymbol(style=dw.SymbolStyle.OUTLINED)

Name	Value
`HOLLOW`	`"hollow"`
`FILL`	`"fill"`

TextAlign

import datawrapper as dw
chart = dw.TextAnnotation(align=dw.TextAlign.TOP_LEFT)

Name	Value
`TOP_LEFT`	`"tl"`
`TOP_CENTER`	`"tc"`
`TOP_RIGHT`	`"tr"`
`MIDDLE_LEFT`	`"ml"`
`MIDDLE_CENTER`	`"mc"`
`MIDDLE_RIGHT`	`"mr"`
`BOTTOM_LEFT`	`"bl"`
`BOTTOM_CENTER`	`"bc"`
`BOTTOM_RIGHT`	`"br"`

ValueLabelAlignment

import datawrapper as dw
chart = dw.BarChart(value_label_alignment=dw.ValueLabelAlignment.CENTER)

Name	Value
`LEFT`	`"left"`
`RIGHT`	`"right"`

ValueLabelDisplay

import datawrapper as dw
chart = dw.ColumnChart(show_value_labels=dw.ValueLabelDisplay.ALWAYS)

Name	Value
`HOVER`	`"hover"`
`ALWAYS`	`"always"`
`OFF`	`"off"`

ValueLabelMode

import datawrapper as dw
value_label = dw.LineValueLabel(mode=dw.ValueLabelMode.ALWAYS)

Name	Value
`LEFT`	`"left"`
`DIVERGING`	`"diverging"`

ValueLabelPlacement

import datawrapper as dw
chart = dw.ColumnChart(value_labels_placement=dw.ValueLabelPlacement.OUTSIDE)

Name	Value
`INSIDE`	`"inside"`
`OUTSIDE`	`"outside"`
`BELOW`	`"below"`