Visivo
Visivo IO Project Files
| Type | object |
|---|---|
| File match |
visivo.yml
visivo.yaml
visivo_project.yml
visivo_project.yaml
*.visivo.yml
*.visivo.yaml
|
| Schema URL | https://catalog.lintel.tools/schemas/schemastore/visivo/latest.json |
| Source | https://docs.visivo.io/assets/visivo_schema.json |
Validate with Lintel
npx @lintel/lintel check
Properties
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The version of the CLI that created the project.
[]
[]
[]
A list of source objects.
[]
[]
[]
[]
[]
[]
[]
[]
[]
Definitions
The options for aggregating table columns. Details on the calculations below:
**count** - Finds the number of rows in a group<br>
**extent** - Finds the minimum and maximum values of a group of rows<br>
**max** - Finds the maximum value of a group of rows<br>
**mean** - Finds the average value of a group of rows<br>
**median** - Finds the median value of a group of rows<br>
**min** - Finds the minimum value of a group of rows<br>
**sum** - sums the values of a group of rows<br>
**uniqueCount** - Finds the number of unique values of a group of rows<br>
**unique** - Finds the unique values of a group of rows
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
A EvalString that must evaluate to true for the alert to fire
[]
A unique path to this object
SqliteSources hold the connection information to SQLite data sources.
!!! example {% raw %}
=== "Simple"
``` yaml
sources:
- name: sqlite_source
database: local/file/local.db
type: sqlite
```
=== "Additional Attached"
Attaching other SQLite databases allows you to join models between databases.
``` yaml
sources:
- name: sqlite_source
database: local/file/local.db
type: sqlite
attach:
- schema_name: static
name: static_source
database: local/static/file/local.db
type: sqlite
```
The above source can be then used in a model and the sql for that model might look similar to: `SELECT * FROM local AS l JOIN static.data AS sd ON l.static_id=sd.id`
{% endraw %}
!!! note
Recommended environment variable use is covered in the [sources overview.](/topics/sources/)
12 nested properties
The database that the Visivo project will use in queries.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The port of the database.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
List of other local SQLite database sources to attach in the connection that will be available in the base SQL query.
BigQuerySources hold the connection information to Google BigQuery instances.
!!! info "BigQuery Authentication"
You can authenticate BigQuery in one of two ways:
1. Pass a base64 encoded service account key to the credentials_base64 field.
2. Set the absolute file path to the credentials file in a environment variable named GOOGLE_APPLICATION_CREDENTIALS.
=== "Base64 Encoded Credentials"
Using encoding the service key json credential file to base64 can be a useful way to authenticate BigQuery
without logging into Google Cloud Console each time and makes it easier to manage credentials in CI/CD pipelines.
However utilizing base64 encoding requires a few extra steps:
1. Create a Google Cloud Service Account
1. Go to the [Google Cloud Console](https://console.cloud.google.com)
2. Select your project
3. Navigate to "IAM & Admin" > "Service Accounts"
4. Click "Create Service Account"
5. Give it a name and description
6. Grant it the "BigQuery Admin" role (or more restrictive custom role)
7. Click "Done"
2. Create and download credentials
1. Find your service account in the list
2. Click the three dots menu > "Manage keys"
3. Click "Add Key" > "Create new key"
4. Choose JSON format
5. Click "Create" - this downloads your credentials file
3. Convert credentials to base64
```bash
# On Linux/Mac
python -m base64 < credentials.json > encoded.txt
# On Windows PowerShell
[Convert]::ToBase64String([System.IO.File]::ReadAllBytes("credentials.json")) > encoded.txt
```
4. Use the contents of encoded.txt as your credentials_base64 value. You can store the single line key in your untracked env file and use the `{% raw %}{{ env_var('VAR_NAME') }}{% endraw %}` syntax to reference the environment variable in your Visivo config.
=== "`GOOGLE_APPLICATION_CREDENTIALS` Environment Variable"
If you use gcloud locally you probably have this environment variable configured already.
Run `echo $GOOGLE_APPLICATION_CREDENTIALS` in your terminal. If it returns your crendetials then
you're all set. and can configure a BigQuerySource without the `credentials_base64` field.
If you don't have the environment variable, follow these steps:
1. Create a Google Cloud Service Account
1. Go to the [Google Cloud Console](https://console.cloud.google.com)
2. Select your project
3. Navigate to "IAM & Admin" > "Service Accounts"
4. Click "Create Service Account"
5. Give it a name and description
6. Grant it the "BigQuery Admin" role (or more restrictive custom role)
7. Click "Done"
2. Create and download credentials
1. Find your service account in the list
2. Click the three dots menu > "Manage keys"
3. Click "Add Key" > "Create new key"
4. Choose JSON format
5. Click "Create" - this downloads your credentials file
3. Set the environment variable
You can set the environment variable in your shell profile file.
```bash
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/credentials.json"
```
or in your untracked .env file.
```
GOOGLE_APPLICATION_CREDENTIALS=/path/to/your/credentials.json
```
This method is easier to manage and does not require any extra steps to authenticate.
The service account needs at minimum the "BigQuery User" role to execute queries.
For more restricted access, you can create a custom role with just the required permissions:
- bigquery.jobs.create
- bigquery.tables.get
- bigquery.tables.getData
- bigquery.tables.list
!!! example
=== "Simple"
``` yaml
sources:
- name: bigquery_source
type: bigquery
project: my-project-id
database: my_dataset
credentials_base64: {% raw %}{{ env_var('BIGQUERY_BASE64_ENCODED_CREDENTIALS') }}{% endraw %}
```
Note: Recommended environment variable use is covered in the sources overview.
The Google Cloud project ID that contains your BigQuery dataset.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The port of the database.
The default BigQuery dataset to use for queries.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
The Google Cloud service account credentials JSON string base64 encoded. Turn your JSON into a base64 string in the command line with python -m base64 < credentials.json > encoded.txt. Not required if GOOGLE_APPLICATION_CREDENTIALS environment variable is set.
The pool size that is used for this connection.
Path to the CSV file.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
CSV delimiter.
CSV file encoding.
Whether CSV has a header row.
Overview
Charts enable you to combine one or more traces with layout configurations (titles, axis labels, ect.).
!!! tip
You can add traces of **different types** to a chart. For example, you may want to display an [`indicator`](../Trace/Props/Indicator/)
on top of a [`bar`](../Trace/Props/Bar/) to show how what the bars add up to.
You can also configure interactivity in your charts by setting up a selector.
Common Configurations
Single Trace
This is the most common and simplest chart setup. You will use this when you want to display a single trace. !!! example "Single Trace"
??? note "Code"
``` yaml
models:
- name: Array of Numbers
args: ["curl", "-s", "<https://raw.githubusercontent.com/visivo-io/data/refs/heads/main/y_values.csv>"]
traces:
- name: Simple Scatter
model: ref(Array of Numbers)
props:
type: scatter
x: ?{ ln(numbers_column)}
y: ?{numbers_column}
mode: markers
marker:
size: ?{ abs(sin(exp(numbers_column) - 5)*100) }
opacity: ?{ abs(cos(exp(numbers_column) - 5)*100)/100 }
filters:
- ?{ numbers_column < 400 }
order_by:
- ?{numbers_column}
charts:
- name: Single Trace Chart
traces:
- ref(Simple Scatter)
layout:
title:
text: "Single Trace"
```

Duel Axis
When you want to display two different types of data on the same chart, duel axis can come in handy. !!! tip
You can actually create a third, and fourth axis ([see plotly docs](https://plotly.com/javascript/multiple-axes/#multiple-y-axes)), however, we do not recommended using more than two yaxes.
Here's a working example that you can copy and paste into your project: !!! example "Duel Y Axes"
??? note "Code"
``` yaml
models:
- name: Series of Numbers
args: ["curl", "-s", "<https://raw.githubusercontent.com/visivo-io/data/refs/heads/main/y_values.csv>"]
traces:
- name: Yaxis Trace
model: ref(Series of Numbers)
props:
type: bar
y: ?{numbers_column}
marker:
color: '#713B57'
opacity: .7
order_by:
- ?{numbers_column}
- name: Yaxis2 Trace
model: ref(Series of Numbers)
props:
type: scatter
y: ?{ (500 - numbers_column) }
yaxis: 'y2'
line:
shape: spline
smoothing: .1
color: orange
order_by:
- ?{numbers_column}
charts:
- name: Duel Axis
traces:
- ref(Yaxis2 Trace)
- ref(Yaxis Trace)
layout:
title:
text: "Dual Axis"
legend:
orientation: "h"
yaxis:
title:
text: "yaxis title"
font:
size: 18
color: '#713B57'
yaxis2:
title:
text: "yaxis2 title"
font:
size: 18
color: orange
side: right
overlaying: 'y'
anchor: 'y'
showgrid: false
```

Position Traces with Domains
You can use domains to position traces on your chart. This is useful when you want to display multiple traces on your chart.
The domain attribute in the trace props enables you to position your traces relative to 0,0 coordinates of the chart.
Here's some working examples that you can copy and paste into your project: !!! example "Trend Line + Multiple Indicators"
??? note "Code"
``` yaml
models:
- name: Numbers From Remote CSV
args: ["curl", "-s", "<https://raw.githubusercontent.com/visivo-io/data/refs/heads/main/y_values.csv>"]
traces:
- name: Line Trace
model: ref(Numbers From Remote CSV)
props:
type: scatter
y: ?{numbers_column}
line:
shape: spline
color: orange
- name: Average Value
model: ref(Numbers From Remote CSV)
columns:
avg_numbers_column: avg(numbers_column)
props:
type: indicator
value: column(avg_numbers_column)[0]
number:
font:
size: 35
suffix: " avg"
domain:
y: [0, .7]
x: [.5, 1]
- name: Total Value
model: ref(Numbers From Remote CSV)
columns:
sum_numbers_column: sum(numbers_column)
props:
type: indicator
value: column(sum_numbers_column)[0]
number:
font:
size: 35
suffix: " sum"
domain:
y: [.5, 1]
x: [.2, .5]
charts:
- name: Big Number Over Line Chart
traces:
- ref(Average Value)
- ref(Total Value)
- ref(Line Trace)
layout:
title:
text: "Indicator + Scatter Plot"
```

A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The selector for the choosing which trace data is shown.
A list of traces either written in line in the chart or called using the ref() function. Supports both for backward compatibility and future interactivity features.
[]
A list of insights either written in line in the chart or called using the ref() function. Supports both for backward compatibility and future interactivity features.
[]
A layout configuration that must adhere to the layout.schema.json file.
ClickhouseSources hold the connection information to ClickHouse data sources. Supports both self-hosted ClickHouse and ClickHouse Cloud.
!!! example
=== "Simple (Self-hosted with Native TCP)"
``` yaml
sources:
- name: clickhouse_source
type: clickhouse
host: localhost
port: 9000
database: default
username: default
password: {% raw %}{{ env_var('CLICKHOUSE_PASSWORD') }}{% endraw %}
```
=== "HTTP Protocol"
``` yaml
sources:
- name: clickhouse_http
type: clickhouse
host: localhost
port: 8123
database: default
username: default
password: {% raw %}{{ env_var('CLICKHOUSE_PASSWORD') }}{% endraw %}
protocol: http
```
=== "ClickHouse Cloud"
``` yaml
sources:
- name: clickhouse_cloud
type: clickhouse
host: your-instance.clickhouse.cloud
port: 8443
database: default
username: default
password: {% raw %}{{ env_var('CLICKHOUSE_PASSWORD') }}{% endraw %}
protocol: http
secure: true
```
!!! note
Recommended environment variable use is covered in the [sources overview.](/topics/sources/)
The database that the Visivo project will use in queries.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The ClickHouse port. Default 9000 for native TCP, use 8123 for HTTP.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
Connection protocol: 'native' (TCP, recommended) or 'http'.
Use secure TLS connection. Required for ClickHouse Cloud with HTTP protocol.
The pool size that is used for this connection.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
CSV Script Models are a type of model that executes a command with a given set of args. This command needs to return a well formatted :fontawesome-solid-file-csv: with a header row to stdout.
Visivo will be able to access the generate file as a model by storing a duckdb file in the source directory.
!!! example {% raw %}
=== "Echo"
Echoing all of your data is probably not a very practical example, but it does nicely demonstrate how the feature works!
``` yaml
models:
- name: csv
table_name: csv
args:
- echo
- |
x,y
1,9
2,1
3,2
4,3
5,5
6,8
```
=== "Python Script"
In this example we'll use python to generate a csv of processes running on your machine and make that csv available to Visivo as
a model for analysis.
``` python title="created_processes_csv.py"
import subprocess
import csv
import sys
# Define the CSV file to write
csv_file = "data/processes.csv"
# Execute the 'ps aux' command
result = subprocess.run(["ps", "aux"], stdout=subprocess.PIPE, text=True)
# Split the output into lines
lines = result.stdout.strip().split("/n")
# Write CSV to stdout
writer = csv.writer(sys.stdout)
writer.writerow(
["USER","PID","%CPU","%MEM","VSZ","RSS","TTY","STAT","START","TIME","COMMAND"]
) # Header
for line in lines[1:]: # Skip the header line from the ps output
row = line.split(None, 10) # Split on whitespace, but only for the first 10 columns
writer.writerow(row)
```
With your script ready to go, all you have to do is convert `python create_processes_csv.py` into the args list format in a model.
``` yaml
models:
- name: processes
table_name: processes
args:
- python
- create_processes_csv.py
```{% endraw %}
=== "CSV File"
One of the best use cases for this type of model is to store a static csv in your project and cat it into a model.
This great because it's simple and allows you to version control your csv data.
``` csv title="file.csv"
columns,go,up,here
1,text,more text,6
2,stuff,more stuff,7
```
Then just `cat` the csv file in a model.
``` yaml
models:
- name: file_model
table_name: file_model
args:
- cat
- file.csv
```
The args are python subprocess list args and you can read their source documentation here.
The unique name of the object across the entire project.
An array of the variables that build your command to run.
A unique path to this object
The path to the file that contains the object definition.
The name to give the resulting models table
Whether to allow the command to return an empty csv.
Dashboards are lists of rows that enable you to build your dashboard grid.
!!! tip
By leveraging [`visivo serve`](./../../../cli/#serve) while building you can quickly optimize your layout. Simply re-size your row heights and item widths, save the file and quickly see the new layout of your dashboard on localhost:8000.
Within the rows you are able to organize and display charts, tables, selectors and markdown from your project as items.

!!! note
``` yaml title="visivo.project.yml"
dashboards:
- name: Layout Example
rows:
- height: medium
items: #item.width default is 1
- chart: ...
- chart: ...
- chart: ...
- height: large
items:
- width: 2
table: ...
- width: 1
markdown: ...
- height: small
items:
- width: 2
selector: ...
- chart: ...
- chart: ...
- width: 2
chart: ...
```
Above you can see how changing the row heights and item widths impacts the layout of the dashboard.
!!! example
`row.height` defaults to `medium` and `item.width` defaults to `1`. Specifying those fields are optional if you want to use the default values
``` yaml
dashboards:
- name: any-name-you-want #unique name of your dashboard
rows:
- height: medium
items:
- width: 2 #widths are evaluated relative to other items in the row
table: ref(a-table-name)
- width 1 #this chart will be 1/3 of the row
chart: ref(a-chart-name)
- height: small
items:
- markdown: "# Some inline **markdown**"
- chart: ref(another-chart)
- width: 2
chart: ref(a-third-chart)
```
The unique name of the dashboard across the entire project
A unique path to this object
The path to the file that contains the object definition.
The importance level of the dashboard (either an index number or level title)
A list of tags associated with the dashboard
A description of the dashboard's purpose and contents
The type of dashboard (always 'internal')
Configuration for pulling models and sources from a dbt project.
The integration will create models and sources from the dbt project and store them in the output directory.
It will pull all the "targets" defined in the profiles.yml file as sources. Each of these sources will be named in the format "prefix + dbt_profile + dbt_target".
Then it will create each of the dbt models as Visivo models pointing to the default profile and target. These models will be named in the format "prefix + dbt_model".
Using all the default values:
dbt:
enabled: true
Or specify the input and/or output file and locations:
dbt:
output_file: includes/dbt.yml
dbt_project_yml_location: dbt
profiles_yml_location: dbt
Whether to enable the dbt phase. Defaults to true.
The file to store the dbt models and sources relative to the working directory. Defaults to the '$output_directory/dbt.yml'. It is useful to store the file in a different location so it can be checked into source control.
Location for the dbt_project.yml file relative to the working directory. Defaults to the current working directory.
Location for the profiles.yml file relative to the working directory. Defaults to the current working directory.
Prefix for the dbt models and sources. Defaults to no prefix. You may want to add one if the dbt model names are in conflict with other models in your project.
The name of an alert defined elsewhere in the Visivo project.
The name of a source defined elsewhere in the Visivo project.
The number of threads to use when running queries.
Enables you to customize the project level view of your dashboards. Ordered list of dashboard levels with titles and descriptions
Controls whether anonymous usage telemetry is collected for this project. When set to false, no telemetry data will be sent. Can also be disabled globally via VISIVO_TELEMETRY_DISABLED environment variable.
A Dimension represents a computed field at the row level that can be used for grouping or filtering.
Unlike metrics which are aggregates, dimensions are calculated for each row and can be used in GROUP BY clauses or as filter conditions. They allow you to define reusable calculated fields without repeating the logic in every query.
!!! example
yaml models: - name: orders sql: SELECT * FROM orders_table dimensions: - name: order_month expression: "DATE_TRUNC('month', order_date)" description: "Month when the order was placed" - name: is_high_value expression: "CASE WHEN amount > 1000 THEN true ELSE false END" description: "Whether this is a high-value order"
SQL expression that computes the dimension value for each row. Can reference any field from the parent model.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
SQL data type of the dimension (e.g., VARCHAR, INTEGER, DATE). Automatically detected for implicit dimensions extracted from model columns.
Human-readable description of what this dimension represents.
A unique path to this object
DuckdbSources hold the connection information to DuckDB data sources.
!!! example
=== "Simple"
``` yaml
sources:
- name: duckdb_source
type: duckdb
database: local/file/database.db
connection_pool_size: 2
```
!!! note
Recommended environment variable use is covered in the [sources overview.](/topics/sources/)
12 nested properties
The database that the Visivo project will use in queries.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The port of the database.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
The pool size that is used for this connection.
List of other local Duckdb database sources to attach in the connection that will be available in the base SQL query.
DuckdbSources hold the connection information to DuckDB data sources.
!!! example
=== "Simple"
``` yaml
sources:
- name: duckdb_source
type: duckdb
database: local/file/database.db
connection_pool_size: 2
```
!!! note
Recommended environment variable use is covered in the [sources overview.](/topics/sources/)
The database that the Visivo project will use in queries.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The port of the database.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
The pool size that is used for this connection.
List of other local Duckdb database sources to attach in the connection that will be available in the base SQL query.
You can configure email destinations for any SMTP provider. Here's an example of this configuration looks in your yaml file:
destinations:
- name: email-destination #any unique name of your choosing
type: email
subject: "[ALERT] Your Visivo Tests Have Failed" #can be any message you want
to: someone@your_company.com
port: 2525 #is this port by default
host: your_company_email_server.com
username: someones_username
password: {% raw %}{{ env_var('EMAIL_PASSWORD')}}{% endraw %} #We'd recommend using environment variables here for security
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The type of alert destination.
Subject of the alert email.
The email to send the alert to.
The port of the email server that the destination is connecting to.
The host of the email server that the destination is connecting to.
The username for authenticating the email server.
The password for authenticating the email server.
Path to the Excel file.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
Excel delimiter.
Excel file encoding.
Whether Excel has a header row.
Represents an external dashboard that links to another system or URL
The unique name of the dashboard across the entire project
URL to the external dashboard
A unique path to this object
The path to the file that contains the object definition.
The importance level of the dashboard (either an index number or level title)
A list of tags associated with the dashboard
A description of the dashboard's purpose and contents
The type of dashboard (always 'external')
Include's can be used to break apart a project file with references to other files. This includes files from remote github repositories.
The path or git reference to external yml files or directories to include in this project
Directory traversal depth. None=fully recursive, 0=current directory only, 1=one level deep, etc. Only applies to directory paths.
Patterns to exclude from directory inclusion. Supports glob patterns and regex. Only applies to directory paths.
[]
The Insight is the central visualization object in Visivo Interactivity 2.0.
Insights replace Traces, providing a cleaner separation between server-side data preparation and client-side interactivity. Unlike traces, insights generate flat JSON structures that can be manipulated in the browser for responsive dashboards.
Why Insights?
- Simpler Mental Model – No more mixing cohort logic or trace naming rules
- Interactive by Default – Client-side filtering, splitting, and sorting
- Reusable – Insights can appear in multiple charts & tables
- Fast – Pre-computed data cached server-side, interactions run locally
Core Components
- model: The SQL model or reference that defines the server-side dataset
- props: Visualization config (chart type, axes, encodings)
- interactions: Client-side transformations (filter, split, sort)
Example
insights:
- name: revenue-by-month
description: "Monthly revenue trends"
props:
type: scatter
mode: lines+markers
x: ?{ date_trunc('month', created_at) }
y: ?{ sum(amount) }
interactions:
- filter: ?{ month >= ${ref(date-range).start} }
- split: ?{ region }
- sort: ?{ month ASC }
In the example above:
- Server-side: Revenue is aggregated by month.
- Client-side: A date-range filter and region split are applied instantly in the browser.
Interactions
Interactions define how users can manipulate data locally:
- Filter: Subset rows by conditions (
WHERElogic) - Split: Break a single insight into multiple series (replaces
cohort_on) - Sort: Order data dynamically
Example:
interactions:
- filter: ?{ sales_amount > 1000 AND region = ${ref(sales-region).value} }
- split: ?{ product_category }
- sort: ?{ date DESC, amount ASC }
Migration from Traces
cohort_on→splitinteraction
The unique name of the insight across the entire project.
A unique path to this object
The path to the file that contains the object definition.
Optional description of what this insight represents.
Leverage Inputs to create client-side interactions that will be applied to the insight data.
A schema to validate plotly layout
88 nested properties
2 nested properties
Sets the color filling the active selection' interior.
Sets the opacity of the active selection.
2 nested properties
Sets the color filling the active shape' interior.
Sets the opacity of the active shape.
Determines whether or not a layout width or height that has been left undefined by the user is initialized on each relayout. Note that, regardless of this attribute, an undefined layout width or height is always initialized on the first call to plot.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. This is the default value; however it could be overridden for individual axes.
Sets the default calendar system to use for interpreting and displaying dates throughout the plot.
Determines the mode of single click interactions. event is the default value and emits the plotly_click event. In addition this mode emits the plotly_selected event in drag modes lasso and select, but with no event data attached (kept for compatibility reasons). The select flag enables selecting single data points via click. This mode also supports persistent selections, meaning that pressing Shift while clicking, adds to / subtracts from an existing selection. select with hovermode: x can be confusing, consider explicitly setting hovermode: closest when using this feature. Selection events are sent accordingly as long as event flag is set as well. When the event flag is missing, plotly_click and plotly_selected events are not fired.
9 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here corresponding trace color array(s)) or the bounds set in cmin and cmax Defaults to false when cmin and cmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as corresponding trace color array(s) and if set, cmin must be set as well.
Sets the mid-point of the color domain by scaling cmin and/or cmax to be equidistant to this point. Value should have the same units as corresponding trace color array(s). Has no effect when cauto is false.
Sets the lower bound of the color domain. Value should have the same units as corresponding trace color array(s) and if set, cmax must be set as well.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use cmin and cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Reverses the color mapping if true. If true, cmin will correspond to the last color in the array and cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace.
3 nested properties
Sets the default diverging colorscale. Note that autocolorscale must be true for this attribute to work.
Sets the default sequential colorscale for positive values. Note that autocolorscale must be true for this attribute to work.
Sets the default sequential colorscale for negative values. Note that autocolorscale must be true for this attribute to work.
Sets the default trace colors.
Placeholder for exporting automargin-impacting values namely margin.t, margin.b, margin.l and margin.r in full-json mode.
If provided, a changed value tells Plotly.react that one or more data arrays has changed. This way you can modify arrays in-place rather than making a complete new copy for an incremental change. If NOT provided, Plotly.react assumes that data arrays are being treated as immutable, thus any data array with a different identity from its predecessor contains new data.
Determines the mode of drag interactions. select and lasso apply only to scatter traces with markers or text. orbit and turntable apply only to 3D scenes.
Controls persistence of user-driven changes in editable: true configuration, other than trace names and axis titles. Defaults to layout.uirevision.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
32 nested properties
Set the background color of the map
Sets the coastline color.
Sets the coastline stroke width (in px).
Sets line color of the country boundaries.
Sets line width (in px) of the country boundaries.
Determines if this subplot's view settings are auto-computed to fit trace data. On scoped maps, setting fitbounds leads to center.lon and center.lat getting auto-filled. On maps with a non-clipped projection, setting fitbounds leads to center.lon, center.lat, and projection.rotation.lon getting auto-filled. On maps with a clipped projection, setting fitbounds leads to center.lon, center.lat, projection.rotation.lon, projection.rotation.lat, lonaxis.range and lataxis.range getting auto-filled. If locations, only the trace's visible locations are considered in the fitbounds computations. If geojson, the entire trace input geojson (if provided) is considered in the fitbounds computations, Defaults to false.
Sets the color the frame.
Sets the stroke width (in px) of the frame.
Sets the color of the lakes.
Sets the land mass color.
Sets the ocean color
Sets the resolution of the base layers. The values have units of km/mm e.g. 110 corresponds to a scale ratio of 1:110,000,000.
Sets color of the rivers.
Sets the stroke width (in px) of the rivers.
Set the scope of the map.
Sets whether or not the coastlines are drawn.
Sets whether or not country boundaries are drawn.
Sets whether or not a frame is drawn around the map.
Sets whether or not lakes are drawn.
Sets whether or not land masses are filled in color.
Sets whether or not oceans are filled in color.
Sets whether or not rivers are drawn.
Sets whether or not boundaries of subunits within countries (e.g. states, provinces) are drawn.
Sets the color of the subunits boundaries.
Sets the stroke width (in px) of the subunits boundaries.
Controls persistence of user-driven changes in the view (projection and center). Defaults to layout.uirevision.
Sets the default visibility of the base layers.
12 nested properties
The number of columns in the grid. If you provide a 2D subplots array, the length of its longest row is used as the default. If you give an xaxes array, its length is used as the default. But it's also possible to have a different length, if you want to leave a row at the end for non-cartesian subplots.
If no subplots, xaxes, or yaxes are given but we do have rows and columns, we can generate defaults using consecutive axis IDs, in two ways: coupled gives one x axis per column and one y axis per row. independent uses a new xy pair for each cell, left-to-right across each row then iterating rows according to roworder.
Is the first row the top or the bottom? Note that columns are always enumerated from left to right.
The number of rows in the grid. If you provide a 2D subplots array or a yaxes array, its length is used as the default. But it's also possible to have a different length, if you want to leave a row at the end for non-cartesian subplots.
Used for freeform grids, where some axes may be shared across subplots but others are not. Each entry should be a cartesian subplot id, like xy or x3y2, or ** to leave that cell empty. You may reuse x axes within the same column, and y axes within the same row. Non-cartesian subplots and traces that support domain can place themselves in this grid separately using the gridcell attribute.
Used with yaxes when the x and y axes are shared across columns and rows. Each entry should be an x axis id like x, x2, etc., or ** to not put an x axis in that column. Entries other than ** must be unique. Ignored if subplots is present. If missing but yaxes is present, will generate consecutive IDs.
Horizontal space between grid cells, expressed as a fraction of the total width available to one cell. Defaults to 0.1 for coupled-axes grids and 0.2 for independent grids.
Sets where the x axis labels and titles go. bottom means the very bottom of the grid. bottom plot is the lowest plot that each x axis is used in. top and top plot are similar.
Used with yaxes when the x and y axes are shared across columns and rows. Each entry should be an y axis id like y, y2, etc., or ** to not put a y axis in that row. Entries other than ** must be unique. Ignored if subplots is present. If missing but xaxes is present, will generate consecutive IDs.
Vertical space between grid cells, expressed as a fraction of the total height available to one cell. Defaults to 0.1 for coupled-axes grids and 0.3 for independent grids.
Sets where the y axis labels and titles go. left means the very left edge of the grid. left plot is the leftmost plot that each y axis is used in. right and right plot are similar.
Sets the plot's height (in px).
Determines whether or not a text link citing the data source is placed at the bottom-right cored of the figure. Has only an effect only on graphs that have been generated via forked graphs from the Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise).
Sets the default distance (in pixels) to look for data to add hover labels (-1 means no cutoff, 0 means no looking for data). This is only a real distance for hovering on point-like objects, like scatter points. For area-like objects (bars, scatter fills, etc) hovering is on inside the area and off outside, but these objects will not supersede hover on point-like objects in case of conflict.
6 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the background color of all hover labels on graph
Sets the border color of all hover labels on graph.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Determines the mode of hover interactions. If closest, a single hoverlabel will appear for the closest point within the hoverdistance. If x (or y), multiple hoverlabels will appear for multiple points at the closest x- (or y-) coordinate within the hoverdistance, with the caveat that no more than one hoverlabel will appear per trace. If x unified (or y unified), a single hoverlabel will appear multiple points at the closest x- (or y-) coordinate within the hoverdistance with the caveat that no more than one hoverlabel will appear per trace. In this mode, spikelines are enabled by default perpendicular to the specified axis. If false, hover interactions are disabled.
Determines expansion of hover effects to other subplots If single just the axis pair of the primary point is included without overlaying subplots. If overlaying all subplots using the main axis and occupying the same space are included. If axis, also include stacked subplots using the same axis when hovermode is set to x, x unified, y or y unified.
27 nested properties
Sets the legend background color. Defaults to layout.paper_bgcolor.
Sets the color of the border enclosing the legend.
Sets the width (in px) of the border enclosing the legend.
Sets the width (in px or fraction) of the legend. Use 0 to size the entry based on the text width, when entrywidthmode is set to pixels.
Determines what entrywidth means.
Determines the behavior on legend group item click. toggleitem toggles the visibility of the individual item clicked on the graph. togglegroup toggles the visibility of all items in the same legendgroup as the item clicked on the graph.
Sets the indentation (in px) of the legend entries.
Determines the behavior on legend item click. toggle toggles the visibility of the item clicked on the graph. toggleothers makes the clicked item the sole visible item on the graph. false disables legend item click interactions.
Determines the behavior on legend item double-click. toggle toggles the visibility of the item clicked on the graph. toggleothers makes the clicked item the sole visible item on the graph. false disables legend item double-click interactions.
Determines if the legend items symbols scale with their corresponding trace attributes or remain constant independent of the symbol size on the graph.
Sets the width (in px) of the legend item symbols (the part other than the title.text).
Sets the max height (in px) of the legend, or max height ratio (reference height * ratio) if less than one. Default value is: 0.5 for horizontal legends; 1 for vertical legends. The minimum allowed height is 30px. For a ratio of 0.5, the legend will take up to 50% of the reference height before displaying a scrollbar. The reference height is the full layout height except for vertically oriented legends with a yref of "paper", where the reference height is the plot height.
Sets the orientation of the legend.
Sets the amount of vertical space (in px) between legend groups.
Determines the order at which the legend items are displayed. If normal, the items are displayed top-to-bottom in the same order as the input data. If reversed, the items are displayed in the opposite order as normal. If grouped, the items are displayed in groups (when a trace legendgroup is provided). if grouped+reversed, the items are displayed in the opposite order as grouped.
Controls persistence of legend-driven changes in trace and pie label visibility. Defaults to layout.uirevision.
Sets the vertical alignment of the symbols with respect to their associated text.
Determines whether or not this legend is visible.
Sets the x position with respect to xref (in normalized coordinates) of the legend. When xref is paper, defaults to 1.02 for vertical legends and defaults to 0 for horizontal legends. When xref is container, defaults to 1 for vertical legends and defaults to 0 for horizontal legends. Must be between 0 and 1 if xref is container. and between -2 and 3 if xref is paper.
Sets the legend's horizontal position anchor. This anchor binds the x position to the left, center or right of the legend. Value auto anchors legends to the right for x values greater than or equal to 2/3, anchors legends to the left for x values less than or equal to 1/3 and anchors legends with respect to their center otherwise.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref (in normalized coordinates) of the legend. When yref is paper, defaults to 1 for vertical legends, defaults to -0.1 for horizontal legends on graphs w/o range sliders and defaults to 1.1 for horizontal legends on graph with one or multiple range sliders. When yref is container, defaults to 1. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets the legend's vertical position anchor This anchor binds the y position to the top, middle or bottom of the legend. Value auto anchors legends at their bottom for y values less than or equal to 1/3, anchors legends to at their top for y values greater than or equal to 2/3 and anchors legends with respect to their middle otherwise.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
9 nested properties
Sets the bearing angle of the map in degrees counter-clockwise from North (map.bearing).
Sets the pitch angle of the map (in degrees, where 0 means perpendicular to the surface of the map) (map.pitch).
Defines the map layers that are rendered by default below the trace layers defined in data, which are themselves by default rendered below the layers defined in layout.map.layers. These layers can be defined either explicitly as a Map Style object which can contain multiple layer definitions that load data from any public or private Tile Map Service (TMS or XYZ) or Web Map Service (WMS) or implicitly by using one of the built-in style objects which use WMSes or by using a custom style URL Map Style objects are of the form described in the MapLibre GL JS documentation available at https://maplibre.org/maplibre-style-spec/ The built-in plotly.js styles objects are: basic, carto-darkmatter, carto-darkmatter-nolabels, carto-positron, carto-positron-nolabels, carto-voyager, carto-voyager-nolabels, dark, light, open-street-map, outdoors, satellite, satellite-streets, streets, white-bg.
Controls persistence of user-driven changes in the view: center, zoom, bearing, pitch. Defaults to layout.uirevision.
Sets the zoom level of the map (map.zoom).
10 nested properties
Sets the mapbox access token to be used for this mapbox map. Alternatively, the mapbox access token can be set in the configuration options under mapboxAccessToken. Note that accessToken are only required when style (e.g with values : basic, streets, outdoors, light, dark, satellite, satellite-streets ) and/or a layout layer references the Mapbox server.
Sets the bearing angle of the map in degrees counter-clockwise from North (mapbox.bearing).
Sets the pitch angle of the map (in degrees, where 0 means perpendicular to the surface of the map) (mapbox.pitch).
Defines the map layers that are rendered by default below the trace layers defined in data, which are themselves by default rendered below the layers defined in layout.mapbox.layers. These layers can be defined either explicitly as a Mapbox Style object which can contain multiple layer definitions that load data from any public or private Tile Map Service (TMS or XYZ) or Web Map Service (WMS) or implicitly by using one of the built-in style objects which use WMSes which do not require any access tokens, or by using a default Mapbox style or custom Mapbox style URL, both of which require a Mapbox access token Note that Mapbox access token can be set in the accesstoken attribute or in the mapboxAccessToken config option. Mapbox Style objects are of the form described in the Mapbox GL JS documentation available at https://docs.mapbox.com/mapbox-gl-js/style-spec The built-in plotly.js styles objects are: carto-darkmatter, carto-positron, open-street-map, stamen-terrain, stamen-toner, stamen-watercolor, white-bg The built-in Mapbox styles are: basic, streets, outdoors, light, dark, satellite, satellite-streets Mapbox style URLs are of the form: mapbox://mapbox.mapbox-
Controls persistence of user-driven changes in the view: center, zoom, bearing, pitch. Defaults to layout.uirevision.
Sets the zoom level of the map (mapbox.zoom).
6 nested properties
Turns on/off margin expansion computations. Legends, colorbars, updatemenus, sliders, axis rangeselector and rangeslider are allowed to push the margins by defaults.
Sets the bottom margin (in px).
Sets the left margin (in px).
Sets the amount of padding (in px) between the plotting area and the axis lines
Sets the right margin (in px).
Sets the top margin (in px).
Sets the source reference on Chart Studio Cloud for meta.
Minimum height of the plot with margin.automargin applied (in px)
Minimum width of the plot with margin.automargin applied (in px)
9 nested properties
Sets the color of the active or hovered on icons in the modebar.
Determines which predefined modebar buttons to add. Please note that these buttons will only be shown if they are compatible with all trace types used in a graph. Similar to config.modeBarButtonsToAdd option. This may include v1hovermode, hoverclosest, hovercompare, togglehover, togglespikelines, drawline, drawopenpath, drawclosedpath, drawcircle, drawrect, eraseshape.
Sets the source reference on Chart Studio Cloud for add.
Sets the background color of the modebar.
Sets the color of the icons in the modebar.
Sets the orientation of the modebar.
Determines which predefined modebar buttons to remove. Similar to config.modeBarButtonsToRemove option. This may include autoScale2d, autoscale, editInChartStudio, editinchartstudio, hoverCompareCartesian, hovercompare, lasso, lasso2d, orbitRotation, orbitrotation, pan, pan2d, pan3d, reset, resetCameraDefault3d, resetCameraLastSave3d, resetGeo, resetSankeyGroup, resetScale2d, resetViewMap, resetViewMapbox, resetViews, resetcameradefault, resetcameralastsave, resetsankeygroup, resetscale, resetview, resetviews, select, select2d, sendDataToCloud, senddatatocloud, tableRotation, tablerotation, toImage, toggleHover, toggleSpikelines, togglehover, togglespikelines, toimage, zoom, zoom2d, zoom3d, zoomIn2d, zoomInGeo, zoomInMap, zoomInMapbox, zoomOut2d, zoomOutGeo, zoomOutMap, zoomOutMapbox, zoomin, zoomout.
Sets the source reference on Chart Studio Cloud for remove.
Controls persistence of user-driven changes related to the modebar, including hovermode, dragmode, and showspikes at both the root level and inside subplots. Defaults to layout.uirevision.
2 nested properties
Describes how a new selection is created. If immediate, a new selection is created after first mouse up. If gradual, a new selection is not created after first mouse. By adding to and subtracting from the initial selection, this option allows declaring extra outlines of the selection.
15 nested properties
When dragmode is set to drawrect, drawline or drawcircle this limits the drag to be horizontal, vertical or diagonal. Using diagonal there is no limit e.g. in drawing lines in any direction. ortho limits the draw to be either horizontal or vertical. horizontal allows horizontal extend. vertical allows vertical extend.
Sets the color filling new shapes' interior. Please note that if using a fillcolor with alpha greater than half, drag inside the active shape starts moving the shape underneath, otherwise a new shape could be started over.
Determines the path's interior. For more info please visit https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/fill-rule
Specifies whether new shapes are drawn below gridlines (below), between gridlines and traces (between) or above traces (above).
Sets the reference to a legend to show new shape in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for new shape. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
Sets the legend rank for new shape. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items.
Sets the width (in px or fraction) of the legend for new shape.
Sets new shape name. The name appears as the legend item.
Sets the opacity of new shapes.
Determines whether or not new shape is shown in the legend.
Determines whether or not new shape is visible. If legendonly, the shape is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the background color of the paper where the graph is drawn.
Sets the background color of the plotting area in-between x and y axes.
8 nested properties
Set the background color of the subplot
Determines if the radial axis grid lines and angular axis line are drawn as circular sectors or as linear (polygon) sectors. Has an effect only when the angular axis has type category. Note that radialaxis.angle is snapped to the angle of the closest vertex when gridshape is circular (so that radial axis scale is the same as the data scale).
Sets the fraction of the radius to cut out of the polar subplot.
Sets angular span of this polar subplot with two angles (in degrees). Sector are assumed to be spanned in the counterclockwise direction with 0 corresponding to rightmost limit of the polar subplot.
Controls persistence of user-driven changes in axis attributes, if not overridden in the individual axes. Defaults to layout.uirevision.
12 nested properties
If cube, this scene's axes are drawn as a cube, regardless of the axes' ranges. If data, this scene's axes are drawn in proportion with the axes' ranges. If manual, this scene's axes are drawn in proportion with the input of aspectratio (the default behavior if aspectratio is provided). If auto, this scene's axes are drawn using the results of data except when one axis is more than four times the size of the two others, where in that case the results of cube are used.
Determines the mode of drag interactions for this scene.
Determines the mode of hover interactions for this scene.
Controls persistence of user-driven changes in camera attributes. Defaults to layout.uirevision.
When dragmode is set to select, this limits the selection of the drag to horizontal, vertical or diagonal. h only allows horizontal selection, v only vertical, d only diagonal and any sets no limit.
Controls persistence of user-driven changes in selected points from all traces.
Sets the decimal and thousand separators. For example, *. * puts a '.' before decimals and a space between thousands. In English locales, dflt is ., but other locales may alter this default.
Determines whether or not a legend is drawn. Default is true if there is a trace to show and any of these: a) Two or more traces would by default be shown in the legend. b) One pie trace is shown in the legend. c) One trace is explicitly given with showlegend: true.
4 nested properties
Set the background color of the subplot
Sets the default distance (in pixels) to look for data to draw spikelines to (-1 means no cutoff, 0 means no looking for data). As with hoverdistance, distance does not apply to area-like objects. In addition, some objects can be hovered on but will not generate spikelines, such as scatter fills.
Default attributes to be applied to the plot. Templates can be created from existing plots using Plotly.makeTemplate, or created manually. They should be objects with format: {layout: layoutTemplate, data: {[type]: [traceTemplate, ...]}, ...} layoutTemplate and traceTemplate are objects matching the attribute structure of layout and a data trace. Trace templates are applied cyclically to traces of each type. Container arrays (eg annotations) have special handling: An object ending in defaults (eg annotationdefaults) is applied to each array item. But if an item has a templateitemname key we look in the template array for an item with matching name and apply that instead. If no matching name is found we mark the item invisible. Any named template item not referenced is appended to the end of the array, so you can use this for a watermark annotation or a logo image, for example. To omit one of these items on the plot, make an item with matching templateitemname and visible: false.
7 nested properties
Set the background color of the subplot
The number each triplet should sum to, and the maximum range of each axis
Controls persistence of user-driven changes in axis min and title, if not overridden in the individual axes. Defaults to layout.uirevision.
11 nested properties
Determines whether the title can automatically push the figure margins. If yref='paper' then the margin will expand to ensure that the title doesn’t overlap with the edges of the container. If yref='container' then the margins will ensure that the title doesn’t overlap with the plot area, tick labels, and axis titles. If automargin=true and the margins need to be expanded, then y will be set to a default 1 and yanchor will be set to an appropriate default to ensure that minimal margin space is needed. Note that when yref='paper', only 1 or 0 are allowed y values. Invalid values will be reset to the default 1.
Sets the plot's title.
Sets the x position with respect to xref in normalized coordinates from 0 (left) to 1 (right).
Sets the title's horizontal alignment with respect to its x position. left means that the title starts at x, right means that the title ends at x and center means that the title's center is at x. auto divides xref by three and calculates the xanchor value automatically based on the value of x.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref in normalized coordinates from 0 (bottom) to 1 (top). auto places the baseline of the title onto the vertical center of the top margin.
Sets the title's vertical alignment with respect to its y position. top means that the title's cap line is at y, bottom means that the title's baseline is at y and middle means that the title's midline is at y. auto divides yref by three and calculates the yanchor value automatically based on the value of y.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
3 nested properties
The duration of the transition, in milliseconds. If equal to zero, updates are synchronous.
The easing function used for the transition
Determines whether the figure's layout or traces smoothly transitions during updates that make both traces and layout change.
Used to allow user interactions with the plot to persist after Plotly.react calls that are unaware of these interactions. If uirevision is omitted, or if it is given and it changed from the previous Plotly.react call, the exact new figure is used. If uirevision is truthy and did NOT change, any attribute that has been affected by user interactions and did not receive a different value in the new figure will keep the interaction value. layout.uirevision attribute serves as the default for uirevision attributes in various sub-containers. For finer control you can set these sub-attributes directly. For example, if your app separately controls the data on the x and y axes you might set xaxis.uirevision=*time* and yaxis.uirevision=*cost*. Then if only the y data is changed, you can update yaxis.uirevision=*quantity* and the y axis range will reset but the x axis range will retain any user-driven zoom.
2 nested properties
Sets the minimum text size between traces of the same type.
Determines how the font size for various text elements are uniformed between each trace type. If the computed text sizes were smaller than the minimum size defined by uniformtext.minsize using hide option hides the text; and using show option shows the text without further downscaling. Please note that if the size defined by minsize is greater than the font size defined by trace, then the minsize is used.
Sets the plot's width (in px).
91 nested properties
If set to an opposite-letter axis id (e.g. x2, y), this axis is bound to the corresponding opposite-letter axis. If set to free, this axis' position is determined by position.
Determines whether long tick labels automatically grow the figure margins.
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
When tickangle is set to auto, it will be set to the first angle in this array that is large enough to prevent label overlap.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines how that happens: by increasing the range, or by decreasing the domain. Default is domain for axes containing image traces, range otherwise.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines which direction we push the originally specified plot area. Options are left, center (default), and right for x axes, and top, middle (default), and bottom for y axes.
Sets the color of the dividers Only has an effect on multicategory axes.
Sets the width (in px) of the dividers Only has an effect on multicategory axes.
Sets the domain of this axis (in plot fraction).
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Could be used to set the desired inside range of this axis (excluding the labels) when ticklabelposition of the anchored axis has inside. Not implemented for axes with type log. This would be ignored when range is provided.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
If set to another axis id (e.g. x2, y), the range of this axis will match the range of the corresponding axis in data-coordinates space. Moreover, matching axes share auto-range values, category lists and histogram auto-bins. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Moreover, note that matching axes must have the same type.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis, with traces and axes visible for both axes. If false, this axis does not overlay any same-letter axes. In this case, for axes with overlapping domains only the highest-numbered axis will be visible.
Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if anchor is set to free.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
If set to another axis id (e.g. x2, y), the range of this axis changes together with the range of the corresponding axis such that the scale of pixels per unit is in a constant ratio. Both axes are still zoomable, but when you zoom one, the other will zoom the same amount, keeping a fixed midpoint. constrain and constraintoward determine how we enforce the constraint. You can chain these, ie yaxis: {scaleanchor: *x*}, xaxis2: {scaleanchor: *y*} but you can only link axes of the same type. The linked axis can have the opposite letter (to constrain the aspect ratio) or the same letter (to match scales across subplots). Loops (yaxis: {scaleanchor: *x*}, xaxis: {scaleanchor: *y*} or longer) are redundant and the last constraint encountered will be ignored to avoid possible inconsistent constraints via scaleratio. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Setting false allows to remove a default constraint (occasionally, you may need to prevent a default scaleanchor constraint from being applied, eg. when having an image trace yaxis: {scaleanchor: "x"} is set automatically in order for pixels to be rendered as squares, setting yaxis: {scaleanchor: false} allows to remove the constraint).
If this axis is linked to another by scaleanchor, this determines the pixel to unit scale ratio. For example, if this value is 10, then every unit on this axis spans 10 times the number of pixels as a unit on the linked axis. Use this for example to create an elevation profile where the vertical scale is exaggerated a fixed amount with respect to the horizontal.
If "true", even 4-digit integers are separated
Determines whether or not a dividers are drawn between the category levels of this axis. Only has an effect on multicategory axes.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not spikes (aka droplines) are drawn for this axis. Note: This only takes affect when hovermode = closest
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether a x (y) axis is positioned at the bottom (left) or top (right) of the plotting area.
Sets the spike color. If undefined, will use the series color
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the drawing mode for the spike line If toaxis, the line is drawn from the data point to the axis the series is plotted on. If across, the line is drawn across the entire plot area, and supercedes toaxis. If marker, then a marker dot is drawn on the axis the series is plotted on
Determines whether spikelines are stuck to the cursor or to the closest datapoints.
Sets the width (in px) of the zero line.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Only for axes with type date or linear. Instead of drawing the major tick label, draw the label for the minor tick that is n positions away from the major tick. E.g. to always draw the label for the minor tick before each major tick, choose ticklabelindex -1. This is useful for date axes with ticklabelmode period if you want to label the period that ends with each major tick instead of the period that begins there.
Sets the source reference on Chart Studio Cloud for ticklabelindex.
Determines where tick labels are drawn with respect to their corresponding ticks and grid lines. Only has an effect for axes of type date When set to period, tick labels are drawn in the middle of the period between ticks.
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. Otherwise on category and multicategory axes the default is allow. In other cases the default is hide past div.
Determines where tick labels are drawn with respect to the axis Please note that top or bottom has no effect on x axes or when ticklabelmode is set to period. Similarly left or right has no effect on y axes or when ticklabelmode is set to period. Has no effect on multicategory axes or when tickson is set to boundaries. When used on axes linked by matches or scaleanchor, no extra padding for inside labels would be added by autorange, so that the scales could match.
Shifts the tick labels by the specified number of pixels in parallel to the axis. Positive values move the labels in the positive direction of the axis.
Sets the standoff distance (in px) between the axis tick labels and their default position. A positive ticklabelstandoff moves the labels farther away from the plot area if ticklabelposition is outside, and deeper into the plot area if ticklabelposition is inside. A negative ticklabelstandoff works in the opposite direction, moving outside ticks towards the plot area and inside ticks towards the outside. If the negative value is large enough, inside ticks can even end up outside and vice versa.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided). If sync, the number of ticks will sync with the overlayed axis set by overlaying property.
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Determines where ticks and grid lines are drawn with respect to their corresponding tick labels. Only has an effect for axes of type category or multicategory. When set to boundaries, ticks and grid lines are drawn half a category to the left/bottom of labels.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Controls persistence of user-driven changes in axis range, autorange, and title if in editable: true configuration. Defaults to layout.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
91 nested properties
If set to an opposite-letter axis id (e.g. x2, y), this axis is bound to the corresponding opposite-letter axis. If set to free, this axis' position is determined by position.
Determines whether long tick labels automatically grow the figure margins.
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
Automatically reposition the axis to avoid overlap with other axes with the same overlaying value. This repositioning will account for any shift amount applied to other axes on the same side with autoshift is set to true. Only has an effect if anchor is set to free.
When tickangle is set to auto, it will be set to the first angle in this array that is large enough to prevent label overlap.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines how that happens: by increasing the range, or by decreasing the domain. Default is domain for axes containing image traces, range otherwise.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines which direction we push the originally specified plot area. Options are left, center (default), and right for x axes, and top, middle (default), and bottom for y axes.
Sets the color of the dividers Only has an effect on multicategory axes.
Sets the width (in px) of the dividers Only has an effect on multicategory axes.
Sets the domain of this axis (in plot fraction).
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Could be used to set the desired inside range of this axis (excluding the labels) when ticklabelposition of the anchored axis has inside. Not implemented for axes with type log. This would be ignored when range is provided.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
If set to another axis id (e.g. x2, y), the range of this axis will match the range of the corresponding axis in data-coordinates space. Moreover, matching axes share auto-range values, category lists and histogram auto-bins. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Moreover, note that matching axes must have the same type.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis, with traces and axes visible for both axes. If false, this axis does not overlay any same-letter axes. In this case, for axes with overlapping domains only the highest-numbered axis will be visible.
Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if anchor is set to free.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
If set to another axis id (e.g. x2, y), the range of this axis changes together with the range of the corresponding axis such that the scale of pixels per unit is in a constant ratio. Both axes are still zoomable, but when you zoom one, the other will zoom the same amount, keeping a fixed midpoint. constrain and constraintoward determine how we enforce the constraint. You can chain these, ie yaxis: {scaleanchor: *x*}, xaxis2: {scaleanchor: *y*} but you can only link axes of the same type. The linked axis can have the opposite letter (to constrain the aspect ratio) or the same letter (to match scales across subplots). Loops (yaxis: {scaleanchor: *x*}, xaxis: {scaleanchor: *y*} or longer) are redundant and the last constraint encountered will be ignored to avoid possible inconsistent constraints via scaleratio. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Setting false allows to remove a default constraint (occasionally, you may need to prevent a default scaleanchor constraint from being applied, eg. when having an image trace yaxis: {scaleanchor: "x"} is set automatically in order for pixels to be rendered as squares, setting yaxis: {scaleanchor: false} allows to remove the constraint).
If this axis is linked to another by scaleanchor, this determines the pixel to unit scale ratio. For example, if this value is 10, then every unit on this axis spans 10 times the number of pixels as a unit on the linked axis. Use this for example to create an elevation profile where the vertical scale is exaggerated a fixed amount with respect to the horizontal.
If "true", even 4-digit integers are separated
Moves the axis a given number of pixels from where it would have been otherwise. Accepts both positive and negative values, which will shift the axis either right or left, respectively. If autoshift is set to true, then this defaults to a padding of -3 if side is set to left. and defaults to +3 if side is set to right. Defaults to 0 if autoshift is set to false. Only has an effect if anchor is set to free.
Determines whether or not a dividers are drawn between the category levels of this axis. Only has an effect on multicategory axes.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not spikes (aka droplines) are drawn for this axis. Note: This only takes affect when hovermode = closest
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether a x (y) axis is positioned at the bottom (left) or top (right) of the plotting area.
Sets the spike color. If undefined, will use the series color
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the drawing mode for the spike line If toaxis, the line is drawn from the data point to the axis the series is plotted on. If across, the line is drawn across the entire plot area, and supercedes toaxis. If marker, then a marker dot is drawn on the axis the series is plotted on
Determines whether spikelines are stuck to the cursor or to the closest datapoints.
Sets the width (in px) of the zero line.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Only for axes with type date or linear. Instead of drawing the major tick label, draw the label for the minor tick that is n positions away from the major tick. E.g. to always draw the label for the minor tick before each major tick, choose ticklabelindex -1. This is useful for date axes with ticklabelmode period if you want to label the period that ends with each major tick instead of the period that begins there.
Sets the source reference on Chart Studio Cloud for ticklabelindex.
Determines where tick labels are drawn with respect to their corresponding ticks and grid lines. Only has an effect for axes of type date When set to period, tick labels are drawn in the middle of the period between ticks.
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. Otherwise on category and multicategory axes the default is allow. In other cases the default is hide past div.
Determines where tick labels are drawn with respect to the axis Please note that top or bottom has no effect on x axes or when ticklabelmode is set to period. Similarly left or right has no effect on y axes or when ticklabelmode is set to period. Has no effect on multicategory axes or when tickson is set to boundaries. When used on axes linked by matches or scaleanchor, no extra padding for inside labels would be added by autorange, so that the scales could match.
Shifts the tick labels by the specified number of pixels in parallel to the axis. Positive values move the labels in the positive direction of the axis.
Sets the standoff distance (in px) between the axis tick labels and their default position. A positive ticklabelstandoff moves the labels farther away from the plot area if ticklabelposition is outside, and deeper into the plot area if ticklabelposition is inside. A negative ticklabelstandoff works in the opposite direction, moving outside ticks towards the plot area and inside ticks towards the outside. If the negative value is large enough, inside ticks can even end up outside and vice versa.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided). If sync, the number of ticks will sync with the overlayed axis set by overlaying property.
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Determines where ticks and grid lines are drawn with respect to their corresponding tick labels. Only has an effect for axes of type category or multicategory. When set to boundaries, ticks and grid lines are drawn half a category to the left/bottom of labels.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Controls persistence of user-driven changes in axis range, autorange, and title if in editable: true configuration. Defaults to layout.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
Sets the rounding of bar corners. May be an integer number of pixels, or a percentage of bar width (as a string ending in %).
Sets the gap (in plot fraction) between bars of adjacent location coordinates.
Sets the gap (in plot fraction) between bars of the same location coordinate.
Determines how bars at the same location coordinate are displayed on the graph. With stack, the bars are stacked on top of one another With relative, the bars are stacked on top of one another, with negative values below the axis, positive values above With group, the bars are plotted next to one another centered around the shared location. With overlay, the bars are plotted over one another, you might need to reduce opacity to see multiple bars.
Sets the normalization for bar traces on the graph. With fraction, the value of each bar is divided by the sum of all values at that location coordinate. percent is the same but multiplied by 100 to show percentages.
Sets the gap (in plot fraction) between boxes of adjacent location coordinates. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between boxes of the same location coordinate. Has no effect on traces that have width set.
Determines how boxes at the same location coordinate are displayed on the graph. If group, the boxes are plotted next to one another centered around the shared location. If overlay, the boxes are plotted over one another, you might need to set opacity to see them multiple boxes. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between bars of adjacent location coordinates.
Sets the gap (in plot fraction) between bars of the same location coordinate.
Determines how bars at the same location coordinate are displayed on the graph. With stack, the bars are stacked on top of one another With group, the bars are plotted next to one another centered around the shared location. With overlay, the bars are plotted over one another, you might need to reduce opacity to see multiple bars.
If true, the funnelarea slice colors (whether given by funnelareacolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default funnelarea slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendfunnelareacolors.
hiddenlabels is the funnelarea & pie chart analog of visible:'legendonly' but it can contain many labels, and can simultaneously hide slices from several pies/funnelarea charts
Sets the source reference on Chart Studio Cloud for hiddenlabels.
If true, the icicle slice colors (whether given by iciclecolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default icicle slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendiciclecolors.
If true, the pie slice colors (whether given by piecolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default pie slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendpiecolors.
Sets the gap (in plot fraction) between scatter points of adjacent location coordinates. Defaults to bargap.
Determines how scatter points at the same location coordinate are displayed on the graph. With group, the scatter points are plotted next to one another centered around the shared location. With overlay, the scatter points are plotted over one another, you might need to reduce opacity to see multiple scatter points.
If true, the sunburst slice colors (whether given by sunburstcolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default sunburst slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendsunburstcolors.
If true, the treemap slice colors (whether given by treemapcolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default treemap slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendtreemapcolors.
Sets the gap (in plot fraction) between violins of adjacent location coordinates. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between violins of the same location coordinate. Has no effect on traces that have width set.
Determines how violins at the same location coordinate are displayed on the graph. If group, the violins are plotted next to one another centered around the shared location. If overlay, the violins are plotted over one another, you might need to set opacity to see them multiple violins. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between bars of adjacent location coordinates.
Sets the gap (in plot fraction) between bars of the same location coordinate.
Determines how bars at the same location coordinate are displayed on the graph. With group, the bars are plotted next to one another centered around the shared location. With overlay, the bars are plotted over one another, you might need to reduce opacity to see multiple bars.
Represents a client-side interaction that can be applied to insight data.
Filter expression to apply to the data on the client side
Column or expression to split data into multiple traces
Column or expression to sort data by
The Item houses a single chart, table, selector, markdown, or input object.
It also informs the width that the chart, table or markdown should occupy within a row. Widths are evaluated for each item in a row relative to all of the other items in the row.
In the example below, the markdown would take up 1/4th of the row and would be positioned on the left edge. The table would also take up 1/4th of the page and would sit to the right of the markdown. The chart would take up 1/2 of the page and would touch the right edge of the row.
items:
- width: 1
markdown: ref(welcome-markdown)
- width: 1
table: ref(table-name)
- width: 2
chart: ref(chart-name)
- width: 1
selector: ref(selector-name)
- width: 1
input: ref(input-name)
Markdown
Reference a markdown object to add formatted text to your dashboard:
markdowns:
- name: welcome-markdown
content: |
# Welcome to Visivo
This is **formatted** text.
align: center
justify: start
dashboards:
- name: my-dashboard
rows:
- items:
- markdown: ref(welcome-markdown)
Markdown content supports CommonMark and GitHub Flavored Markdown. You can also render raw HTML within your markdown.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The width of the Item determines is evaluated relative to the other items in a row.
A Markdown object defined inline, a ref() to a markdown, or a markdown string (deprecated).
DEPRECATED: Use the align property on the Markdown model instead. Alignment of markdown content. Only valid when markdown is set. Options are 'left', 'center', or 'right'.
DEPRECATED: Use the justify property on the Markdown model instead. Justification of markdown content within its container. Options are 'start', 'end', 'center', 'between', 'around', or 'evenly'.
A chart object defined inline or a ref() to a chart.
A Table object defined inline or a ref() to a table
A Selector object defined inline or a ref() to a selector
An Input object defined inline or a ref() to a input
A schema to validate plotly layout
2 nested properties
Sets the color filling the active selection' interior.
Sets the opacity of the active selection.
2 nested properties
Sets the color filling the active shape' interior.
Sets the opacity of the active shape.
Determines whether or not a layout width or height that has been left undefined by the user is initialized on each relayout. Note that, regardless of this attribute, an undefined layout width or height is always initialized on the first call to plot.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. This is the default value; however it could be overridden for individual axes.
Sets the default calendar system to use for interpreting and displaying dates throughout the plot.
Determines the mode of single click interactions. event is the default value and emits the plotly_click event. In addition this mode emits the plotly_selected event in drag modes lasso and select, but with no event data attached (kept for compatibility reasons). The select flag enables selecting single data points via click. This mode also supports persistent selections, meaning that pressing Shift while clicking, adds to / subtracts from an existing selection. select with hovermode: x can be confusing, consider explicitly setting hovermode: closest when using this feature. Selection events are sent accordingly as long as event flag is set as well. When the event flag is missing, plotly_click and plotly_selected events are not fired.
9 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here corresponding trace color array(s)) or the bounds set in cmin and cmax Defaults to false when cmin and cmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as corresponding trace color array(s) and if set, cmin must be set as well.
Sets the mid-point of the color domain by scaling cmin and/or cmax to be equidistant to this point. Value should have the same units as corresponding trace color array(s). Has no effect when cauto is false.
Sets the lower bound of the color domain. Value should have the same units as corresponding trace color array(s) and if set, cmax must be set as well.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use cmin and cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Reverses the color mapping if true. If true, cmin will correspond to the last color in the array and cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace.
3 nested properties
Sets the default diverging colorscale. Note that autocolorscale must be true for this attribute to work.
Sets the default sequential colorscale for positive values. Note that autocolorscale must be true for this attribute to work.
Sets the default sequential colorscale for negative values. Note that autocolorscale must be true for this attribute to work.
Sets the default trace colors.
Placeholder for exporting automargin-impacting values namely margin.t, margin.b, margin.l and margin.r in full-json mode.
If provided, a changed value tells Plotly.react that one or more data arrays has changed. This way you can modify arrays in-place rather than making a complete new copy for an incremental change. If NOT provided, Plotly.react assumes that data arrays are being treated as immutable, thus any data array with a different identity from its predecessor contains new data.
Determines the mode of drag interactions. select and lasso apply only to scatter traces with markers or text. orbit and turntable apply only to 3D scenes.
Controls persistence of user-driven changes in editable: true configuration, other than trace names and axis titles. Defaults to layout.uirevision.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
32 nested properties
Set the background color of the map
2 nested properties
Sets the latitude of the map's center. For all projection types, the map's latitude center lies at the middle of the latitude range by default.
Sets the longitude of the map's center. By default, the map's longitude center lies at the middle of the longitude range for scoped projection and above projection.rotation.lon otherwise.
Sets the coastline color.
Sets the coastline stroke width (in px).
Sets line color of the country boundaries.
Sets line width (in px) of the country boundaries.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this geo subplot . Note that geo subplots are constrained by domain. In general, when projection.scale is set to 1. a map will fit either its x or y domain, but not both.
If there is a layout grid, use the domain for this row in the grid for this geo subplot . Note that geo subplots are constrained by domain. In general, when projection.scale is set to 1. a map will fit either its x or y domain, but not both.
Sets the horizontal domain of this geo subplot (in plot fraction). Note that geo subplots are constrained by domain. In general, when projection.scale is set to 1. a map will fit either its x or y domain, but not both.
Sets the vertical domain of this geo subplot (in plot fraction). Note that geo subplots are constrained by domain. In general, when projection.scale is set to 1. a map will fit either its x or y domain, but not both.
Determines if this subplot's view settings are auto-computed to fit trace data. On scoped maps, setting fitbounds leads to center.lon and center.lat getting auto-filled. On maps with a non-clipped projection, setting fitbounds leads to center.lon, center.lat, and projection.rotation.lon getting auto-filled. On maps with a clipped projection, setting fitbounds leads to center.lon, center.lat, projection.rotation.lon, projection.rotation.lat, lonaxis.range and lataxis.range getting auto-filled. If locations, only the trace's visible locations are considered in the fitbounds computations. If geojson, the entire trace input geojson (if provided) is considered in the fitbounds computations, Defaults to false.
Sets the color the frame.
Sets the stroke width (in px) of the frame.
Sets the color of the lakes.
Sets the land mass color.
7 nested properties
Sets the graticule's longitude/latitude tick step.
Sets the graticule's stroke color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the graticule's stroke width (in px).
Sets the range of this axis (in degrees), sets the map's clipped coordinates.
Sets whether or not graticule are shown on the map.
Sets the graticule's starting tick longitude/latitude.
7 nested properties
Sets the graticule's longitude/latitude tick step.
Sets the graticule's stroke color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the graticule's stroke width (in px).
Sets the range of this axis (in degrees), sets the map's clipped coordinates.
Sets whether or not graticule are shown on the map.
Sets the graticule's starting tick longitude/latitude.
Sets the ocean color
6 nested properties
For satellite projection type only. Sets the distance from the center of the sphere to the point of view as a proportion of the sphere’s radius.
For conic projection types only. Sets the parallels (tangent, secant) where the cone intersects the sphere.
Zooms in or out on the map view. A scale of 1 corresponds to the largest zoom level that fits the map's lon and lat ranges.
For satellite projection type only. Sets the tilt angle of perspective projection.
Sets the projection type.
Sets the resolution of the base layers. The values have units of km/mm e.g. 110 corresponds to a scale ratio of 1:110,000,000.
Sets color of the rivers.
Sets the stroke width (in px) of the rivers.
Set the scope of the map.
Sets whether or not the coastlines are drawn.
Sets whether or not country boundaries are drawn.
Sets whether or not a frame is drawn around the map.
Sets whether or not lakes are drawn.
Sets whether or not land masses are filled in color.
Sets whether or not oceans are filled in color.
Sets whether or not rivers are drawn.
Sets whether or not boundaries of subunits within countries (e.g. states, provinces) are drawn.
Sets the color of the subunits boundaries.
Sets the stroke width (in px) of the subunits boundaries.
Controls persistence of user-driven changes in the view (projection and center). Defaults to layout.uirevision.
Sets the default visibility of the base layers.
12 nested properties
The number of columns in the grid. If you provide a 2D subplots array, the length of its longest row is used as the default. If you give an xaxes array, its length is used as the default. But it's also possible to have a different length, if you want to leave a row at the end for non-cartesian subplots.
2 nested properties
Sets the horizontal domain of this grid subplot (in plot fraction). The first and last cells end exactly at the domain edges, with no grout around the edges.
Sets the vertical domain of this grid subplot (in plot fraction). The first and last cells end exactly at the domain edges, with no grout around the edges.
If no subplots, xaxes, or yaxes are given but we do have rows and columns, we can generate defaults using consecutive axis IDs, in two ways: coupled gives one x axis per column and one y axis per row. independent uses a new xy pair for each cell, left-to-right across each row then iterating rows according to roworder.
Is the first row the top or the bottom? Note that columns are always enumerated from left to right.
The number of rows in the grid. If you provide a 2D subplots array or a yaxes array, its length is used as the default. But it's also possible to have a different length, if you want to leave a row at the end for non-cartesian subplots.
Used for freeform grids, where some axes may be shared across subplots but others are not. Each entry should be a cartesian subplot id, like xy or x3y2, or ** to leave that cell empty. You may reuse x axes within the same column, and y axes within the same row. Non-cartesian subplots and traces that support domain can place themselves in this grid separately using the gridcell attribute.
Used with yaxes when the x and y axes are shared across columns and rows. Each entry should be an x axis id like x, x2, etc., or ** to not put an x axis in that column. Entries other than ** must be unique. Ignored if subplots is present. If missing but yaxes is present, will generate consecutive IDs.
Horizontal space between grid cells, expressed as a fraction of the total width available to one cell. Defaults to 0.1 for coupled-axes grids and 0.2 for independent grids.
Sets where the x axis labels and titles go. bottom means the very bottom of the grid. bottom plot is the lowest plot that each x axis is used in. top and top plot are similar.
Used with yaxes when the x and y axes are shared across columns and rows. Each entry should be an y axis id like y, y2, etc., or ** to not put a y axis in that row. Entries other than ** must be unique. Ignored if subplots is present. If missing but xaxes is present, will generate consecutive IDs.
Vertical space between grid cells, expressed as a fraction of the total height available to one cell. Defaults to 0.1 for coupled-axes grids and 0.3 for independent grids.
Sets where the y axis labels and titles go. left means the very left edge of the grid. left plot is the leftmost plot that each y axis is used in. right and right plot are similar.
Sets the plot's height (in px).
Determines whether or not a text link citing the data source is placed at the bottom-right cored of the figure. Has only an effect only on graphs that have been generated via forked graphs from the Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise).
Sets the default distance (in pixels) to look for data to add hover labels (-1 means no cutoff, 0 means no looking for data). This is only a real distance for hovering on point-like objects, like scatter points. For area-like objects (bars, scatter fills, etc) hovering is on inside the area and off outside, but these objects will not supersede hover on point-like objects in case of conflict.
6 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the background color of all hover labels on graph
Sets the border color of all hover labels on graph.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Determines the mode of hover interactions. If closest, a single hoverlabel will appear for the closest point within the hoverdistance. If x (or y), multiple hoverlabels will appear for multiple points at the closest x- (or y-) coordinate within the hoverdistance, with the caveat that no more than one hoverlabel will appear per trace. If x unified (or y unified), a single hoverlabel will appear multiple points at the closest x- (or y-) coordinate within the hoverdistance with the caveat that no more than one hoverlabel will appear per trace. In this mode, spikelines are enabled by default perpendicular to the specified axis. If false, hover interactions are disabled.
Determines expansion of hover effects to other subplots If single just the axis pair of the primary point is included without overlaying subplots. If overlaying all subplots using the main axis and occupying the same space are included. If axis, also include stacked subplots using the same axis when hovermode is set to x, x unified, y or y unified.
27 nested properties
Sets the legend background color. Defaults to layout.paper_bgcolor.
Sets the color of the border enclosing the legend.
Sets the width (in px) of the border enclosing the legend.
Sets the width (in px or fraction) of the legend. Use 0 to size the entry based on the text width, when entrywidthmode is set to pixels.
Determines what entrywidth means.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Determines the behavior on legend group item click. toggleitem toggles the visibility of the individual item clicked on the graph. togglegroup toggles the visibility of all items in the same legendgroup as the item clicked on the graph.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the indentation (in px) of the legend entries.
Determines the behavior on legend item click. toggle toggles the visibility of the item clicked on the graph. toggleothers makes the clicked item the sole visible item on the graph. false disables legend item click interactions.
Determines the behavior on legend item double-click. toggle toggles the visibility of the item clicked on the graph. toggleothers makes the clicked item the sole visible item on the graph. false disables legend item double-click interactions.
Determines if the legend items symbols scale with their corresponding trace attributes or remain constant independent of the symbol size on the graph.
Sets the width (in px) of the legend item symbols (the part other than the title.text).
Sets the max height (in px) of the legend, or max height ratio (reference height * ratio) if less than one. Default value is: 0.5 for horizontal legends; 1 for vertical legends. The minimum allowed height is 30px. For a ratio of 0.5, the legend will take up to 50% of the reference height before displaying a scrollbar. The reference height is the full layout height except for vertically oriented legends with a yref of "paper", where the reference height is the plot height.
Sets the orientation of the legend.
3 nested properties
Determines the location of legend's title with respect to the legend items. Defaulted to top with orientation is h. Defaulted to left with orientation is v. The top left options could be used to expand top center and top right are for horizontal alignment legend area in both x and y sides.
Sets the title of the legend.
Sets the amount of vertical space (in px) between legend groups.
Determines the order at which the legend items are displayed. If normal, the items are displayed top-to-bottom in the same order as the input data. If reversed, the items are displayed in the opposite order as normal. If grouped, the items are displayed in groups (when a trace legendgroup is provided). if grouped+reversed, the items are displayed in the opposite order as grouped.
Controls persistence of legend-driven changes in trace and pie label visibility. Defaults to layout.uirevision.
Sets the vertical alignment of the symbols with respect to their associated text.
Determines whether or not this legend is visible.
Sets the x position with respect to xref (in normalized coordinates) of the legend. When xref is paper, defaults to 1.02 for vertical legends and defaults to 0 for horizontal legends. When xref is container, defaults to 1 for vertical legends and defaults to 0 for horizontal legends. Must be between 0 and 1 if xref is container. and between -2 and 3 if xref is paper.
Sets the legend's horizontal position anchor. This anchor binds the x position to the left, center or right of the legend. Value auto anchors legends to the right for x values greater than or equal to 2/3, anchors legends to the left for x values less than or equal to 1/3 and anchors legends with respect to their center otherwise.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref (in normalized coordinates) of the legend. When yref is paper, defaults to 1 for vertical legends, defaults to -0.1 for horizontal legends on graphs w/o range sliders and defaults to 1.1 for horizontal legends on graph with one or multiple range sliders. When yref is container, defaults to 1. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets the legend's vertical position anchor This anchor binds the y position to the top, middle or bottom of the legend. Value auto anchors legends at their bottom for y values less than or equal to 1/3, anchors legends to at their top for y values greater than or equal to 2/3 and anchors legends with respect to their middle otherwise.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
9 nested properties
Sets the bearing angle of the map in degrees counter-clockwise from North (map.bearing).
4 nested properties
Sets the maximum longitude of the map (in degrees East) if west, south and north are declared.
Sets the maximum latitude of the map (in degrees North) if east, west and south are declared.
Sets the minimum latitude of the map (in degrees North) if east, west and north are declared.
Sets the minimum longitude of the map (in degrees East) if east, south and north are declared.
2 nested properties
Sets the latitude of the center of the map (in degrees North).
Sets the longitude of the center of the map (in degrees East).
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this map subplot .
If there is a layout grid, use the domain for this row in the grid for this map subplot .
Sets the horizontal domain of this map subplot (in plot fraction).
Sets the vertical domain of this map subplot (in plot fraction).
Sets the pitch angle of the map (in degrees, where 0 means perpendicular to the surface of the map) (map.pitch).
Defines the map layers that are rendered by default below the trace layers defined in data, which are themselves by default rendered below the layers defined in layout.map.layers. These layers can be defined either explicitly as a Map Style object which can contain multiple layer definitions that load data from any public or private Tile Map Service (TMS or XYZ) or Web Map Service (WMS) or implicitly by using one of the built-in style objects which use WMSes or by using a custom style URL Map Style objects are of the form described in the MapLibre GL JS documentation available at https://maplibre.org/maplibre-style-spec/ The built-in plotly.js styles objects are: basic, carto-darkmatter, carto-darkmatter-nolabels, carto-positron, carto-positron-nolabels, carto-voyager, carto-voyager-nolabels, dark, light, open-street-map, outdoors, satellite, satellite-streets, streets, white-bg.
Controls persistence of user-driven changes in the view: center, zoom, bearing, pitch. Defaults to layout.uirevision.
Sets the zoom level of the map (map.zoom).
10 nested properties
Sets the mapbox access token to be used for this mapbox map. Alternatively, the mapbox access token can be set in the configuration options under mapboxAccessToken. Note that accessToken are only required when style (e.g with values : basic, streets, outdoors, light, dark, satellite, satellite-streets ) and/or a layout layer references the Mapbox server.
Sets the bearing angle of the map in degrees counter-clockwise from North (mapbox.bearing).
4 nested properties
Sets the maximum longitude of the map (in degrees East) if west, south and north are declared.
Sets the maximum latitude of the map (in degrees North) if east, west and south are declared.
Sets the minimum latitude of the map (in degrees North) if east, west and north are declared.
Sets the minimum longitude of the map (in degrees East) if east, south and north are declared.
2 nested properties
Sets the latitude of the center of the map (in degrees North).
Sets the longitude of the center of the map (in degrees East).
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this mapbox subplot .
If there is a layout grid, use the domain for this row in the grid for this mapbox subplot .
Sets the horizontal domain of this mapbox subplot (in plot fraction).
Sets the vertical domain of this mapbox subplot (in plot fraction).
Sets the pitch angle of the map (in degrees, where 0 means perpendicular to the surface of the map) (mapbox.pitch).
Defines the map layers that are rendered by default below the trace layers defined in data, which are themselves by default rendered below the layers defined in layout.mapbox.layers. These layers can be defined either explicitly as a Mapbox Style object which can contain multiple layer definitions that load data from any public or private Tile Map Service (TMS or XYZ) or Web Map Service (WMS) or implicitly by using one of the built-in style objects which use WMSes which do not require any access tokens, or by using a default Mapbox style or custom Mapbox style URL, both of which require a Mapbox access token Note that Mapbox access token can be set in the accesstoken attribute or in the mapboxAccessToken config option. Mapbox Style objects are of the form described in the Mapbox GL JS documentation available at https://docs.mapbox.com/mapbox-gl-js/style-spec The built-in plotly.js styles objects are: carto-darkmatter, carto-positron, open-street-map, stamen-terrain, stamen-toner, stamen-watercolor, white-bg The built-in Mapbox styles are: basic, streets, outdoors, light, dark, satellite, satellite-streets Mapbox style URLs are of the form: mapbox://mapbox.mapbox-
Controls persistence of user-driven changes in the view: center, zoom, bearing, pitch. Defaults to layout.uirevision.
Sets the zoom level of the map (mapbox.zoom).
6 nested properties
Turns on/off margin expansion computations. Legends, colorbars, updatemenus, sliders, axis rangeselector and rangeslider are allowed to push the margins by defaults.
Sets the bottom margin (in px).
Sets the left margin (in px).
Sets the amount of padding (in px) between the plotting area and the axis lines
Sets the right margin (in px).
Sets the top margin (in px).
Sets the source reference on Chart Studio Cloud for meta.
Minimum height of the plot with margin.automargin applied (in px)
Minimum width of the plot with margin.automargin applied (in px)
9 nested properties
Sets the color of the active or hovered on icons in the modebar.
Determines which predefined modebar buttons to add. Please note that these buttons will only be shown if they are compatible with all trace types used in a graph. Similar to config.modeBarButtonsToAdd option. This may include v1hovermode, hoverclosest, hovercompare, togglehover, togglespikelines, drawline, drawopenpath, drawclosedpath, drawcircle, drawrect, eraseshape.
Sets the source reference on Chart Studio Cloud for add.
Sets the background color of the modebar.
Sets the color of the icons in the modebar.
Sets the orientation of the modebar.
Determines which predefined modebar buttons to remove. Similar to config.modeBarButtonsToRemove option. This may include autoScale2d, autoscale, editInChartStudio, editinchartstudio, hoverCompareCartesian, hovercompare, lasso, lasso2d, orbitRotation, orbitrotation, pan, pan2d, pan3d, reset, resetCameraDefault3d, resetCameraLastSave3d, resetGeo, resetSankeyGroup, resetScale2d, resetViewMap, resetViewMapbox, resetViews, resetcameradefault, resetcameralastsave, resetsankeygroup, resetscale, resetview, resetviews, select, select2d, sendDataToCloud, senddatatocloud, tableRotation, tablerotation, toImage, toggleHover, toggleSpikelines, togglehover, togglespikelines, toimage, zoom, zoom2d, zoom3d, zoomIn2d, zoomInGeo, zoomInMap, zoomInMapbox, zoomOut2d, zoomOutGeo, zoomOutMap, zoomOutMapbox, zoomin, zoomout.
Sets the source reference on Chart Studio Cloud for remove.
Controls persistence of user-driven changes related to the modebar, including hovermode, dragmode, and showspikes at both the root level and inside subplots. Defaults to layout.uirevision.
2 nested properties
3 nested properties
Sets the line color. By default uses either dark grey or white to increase contrast with background color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the line width (in px).
Describes how a new selection is created. If immediate, a new selection is created after first mouse up. If gradual, a new selection is not created after first mouse. By adding to and subtracting from the initial selection, this option allows declaring extra outlines of the selection.
15 nested properties
When dragmode is set to drawrect, drawline or drawcircle this limits the drag to be horizontal, vertical or diagonal. Using diagonal there is no limit e.g. in drawing lines in any direction. ortho limits the draw to be either horizontal or vertical. horizontal allows horizontal extend. vertical allows vertical extend.
Sets the color filling new shapes' interior. Please note that if using a fillcolor with alpha greater than half, drag inside the active shape starts moving the shape underneath, otherwise a new shape could be started over.
Determines the path's interior. For more info please visit https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/fill-rule
8 nested properties
Sets padding (in px) between edge of label and edge of new shape.
Sets the text to display with the new shape. It is also used for legend item if name is not provided.
Sets the angle at which the label text is drawn with respect to the horizontal. For lines, angle auto is the same angle as the line. For all other shapes, angle auto is horizontal.
Sets the position of the label text relative to the new shape. Supported values for rectangles, circles and paths are top left, top center, top right, middle left, middle center, middle right, bottom left, bottom center, and bottom right. Supported values for lines are start, middle, and end. Default: middle center for rectangles, circles, and paths; middle for lines.
Template string used for rendering the new shape's label. Note that this will override text. Variables are inserted using %{variable}, for example "x0: %{x0}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{x0:$.2f}". See https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{x0|%m %b %Y}". See https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. A single multiplication or division operation may be applied to numeric variables, and combined with d3 number formatting, for example "Length in cm: %{x02.54}", "%{slope60:.1f} meters per second." For log axes, variable values are given in log units. For date axes, x/y coordinate variables and center variables use datetimes, while all other variable values use values in ms. Finally, the template string has access to variables x0, x1, y0, y1, slope, dx, dy, width, height, length, xcenter and ycenter.
Sets the label's horizontal position anchor This anchor binds the specified textposition to the left, center or right of the label text. For example, if textposition is set to top right and xanchor to right then the right-most portion of the label text lines up with the right-most edge of the new shape.
Sets the label's vertical position anchor This anchor binds the specified textposition to the top, middle or bottom of the label text. For example, if textposition is set to top right and yanchor to top then the top-most portion of the label text lines up with the top-most edge of the new shape.
Specifies whether new shapes are drawn below gridlines (below), between gridlines and traces (between) or above traces (above).
Sets the reference to a legend to show new shape in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for new shape. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
Sets the title of the legend group.
Sets the legend rank for new shape. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items.
Sets the width (in px or fraction) of the legend for new shape.
3 nested properties
Sets the line color. By default uses either dark grey or white to increase contrast with background color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the line width (in px).
Sets new shape name. The name appears as the legend item.
Sets the opacity of new shapes.
Determines whether or not new shape is shown in the legend.
Determines whether or not new shape is visible. If legendonly, the shape is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the background color of the paper where the graph is drawn.
Sets the background color of the plotting area in-between x and y axes.
8 nested properties
48 nested properties
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the direction corresponding to positive angles.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Set the angular period. Has an effect only when angularaxis.type is category.
Sets that start position (in degrees) of the angular axis By default, polar subplots with direction set to counterclockwise get a rotation of 0 which corresponds to due East (like what mathematicians prefer). In turn, polar with direction set to clockwise get a rotation of 90 which corresponds to due North (like on a compass),
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the format unit of the formatted theta values. Has an effect only when angularaxis.type is linear.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the angular axis type. If linear, set thetaunit to determine the unit in which axis value are shown. If *category, use period to set the number of integer coordinates around polar axis.
Controls persistence of user-driven changes in axis rotation. Defaults to polar<N>.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Set the background color of the subplot
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this polar subplot .
If there is a layout grid, use the domain for this row in the grid for this polar subplot .
Sets the horizontal domain of this polar subplot (in plot fraction).
Sets the vertical domain of this polar subplot (in plot fraction).
Determines if the radial axis grid lines and angular axis line are drawn as circular sectors or as linear (polygon) sectors. Has an effect only when the angular axis has type category. Note that radialaxis.angle is snapped to the angle of the closest vertex when gridshape is circular (so that radial axis scale is the same as the data scale).
Sets the fraction of the radius to cut out of the polar subplot.
55 nested properties
Sets the angle (in degrees) from which the radial axis is drawn. Note that by default, radial axis line on the theta=0 line corresponds to a line pointing right (like what mathematicians prefer). Defaults to the first polar.sector angle.
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
When tickangle is set to auto, it will be set to the first angle in this array that is large enough to prevent label overlap.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. If normal, the range is computed in relation to the extrema of the input data (same behavior as for cartesian axes).
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines on which side of radial axis line the tick and tick labels appear.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Controls persistence of user-driven changes in axis range, autorange, angle, and title if in editable: true configuration. Defaults to polar<N>.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Sets angular span of this polar subplot with two angles (in degrees). Sector are assumed to be spanned in the counterclockwise direction with 0 corresponding to rightmost limit of the polar subplot.
Controls persistence of user-driven changes in axis attributes, if not overridden in the individual axes. Defaults to layout.uirevision.
12 nested properties
If cube, this scene's axes are drawn as a cube, regardless of the axes' ranges. If data, this scene's axes are drawn in proportion with the axes' ranges. If manual, this scene's axes are drawn in proportion with the input of aspectratio (the default behavior if aspectratio is provided). If auto, this scene's axes are drawn using the results of data except when one axis is more than four times the size of the two others, where in that case the results of cube are used.
4 nested properties
4 nested properties
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this scene subplot .
If there is a layout grid, use the domain for this row in the grid for this scene subplot .
Sets the horizontal domain of this scene subplot (in plot fraction).
Sets the vertical domain of this scene subplot (in plot fraction).
Determines the mode of drag interactions for this scene.
Determines the mode of hover interactions for this scene.
Controls persistence of user-driven changes in camera attributes. Defaults to layout.uirevision.
59 nested properties
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the background color of this axis' wall.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Sets the color of the grid lines.
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the axis line color.
Sets the width (in px) of the axis line.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
If "true", even 4-digit integers are separated
Sets whether or not this axis is labeled
Sets whether or not this axis' wall has a background color.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Sets whether or not spikes starting from data points to this axis' wall are shown on hover.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the color of the spikes.
Sets whether or not spikes extending from the projection data points to this axis' wall boundaries are shown on hover.
Sets the thickness (in px) of the spikes.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
59 nested properties
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the background color of this axis' wall.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Sets the color of the grid lines.
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the axis line color.
Sets the width (in px) of the axis line.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
If "true", even 4-digit integers are separated
Sets whether or not this axis is labeled
Sets whether or not this axis' wall has a background color.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Sets whether or not spikes starting from data points to this axis' wall are shown on hover.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the color of the spikes.
Sets whether or not spikes extending from the projection data points to this axis' wall boundaries are shown on hover.
Sets the thickness (in px) of the spikes.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
59 nested properties
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the background color of this axis' wall.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Sets the color of the grid lines.
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the axis line color.
Sets the width (in px) of the axis line.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
If "true", even 4-digit integers are separated
Sets whether or not this axis is labeled
Sets whether or not this axis' wall has a background color.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Sets whether or not spikes starting from data points to this axis' wall are shown on hover.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the color of the spikes.
Sets whether or not spikes extending from the projection data points to this axis' wall boundaries are shown on hover.
Sets the thickness (in px) of the spikes.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
When dragmode is set to select, this limits the selection of the drag to horizontal, vertical or diagonal. h only allows horizontal selection, v only vertical, d only diagonal and any sets no limit.
Controls persistence of user-driven changes in selected points from all traces.
Sets the decimal and thousand separators. For example, *. * puts a '.' before decimals and a space between thousands. In English locales, dflt is ., but other locales may alter this default.
Determines whether or not a legend is drawn. Default is true if there is a trace to show and any of these: a) Two or more traces would by default be shown in the legend. b) One pie trace is shown in the legend. c) One trace is explicitly given with showlegend: true.
4 nested properties
Set the background color of the subplot
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this smith subplot .
If there is a layout grid, use the domain for this row in the grid for this smith subplot .
Sets the horizontal domain of this smith subplot (in plot fraction).
Sets the vertical domain of this smith subplot (in plot fraction).
25 nested properties
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the tick length (in px).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the values at which ticks on this axis appear. Defaults to realaxis.tickvals plus the same as negatives and zero.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
27 nested properties
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines on which side of real axis line the tick and tick labels appear.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the tick length (in px).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If top (bottom), this axis' are drawn above (below) the axis line.
Sets a tick label suffix.
Sets the values at which ticks on this axis appear.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Sets the default distance (in pixels) to look for data to draw spikelines to (-1 means no cutoff, 0 means no looking for data). As with hoverdistance, distance does not apply to area-like objects. In addition, some objects can be hovered on but will not generate spikelines, such as scatter fills.
Default attributes to be applied to the plot. Templates can be created from existing plots using Plotly.makeTemplate, or created manually. They should be objects with format: {layout: layoutTemplate, data: {[type]: [traceTemplate, ...]}, ...} layoutTemplate and traceTemplate are objects matching the attribute structure of layout and a data trace. Trace templates are applied cyclically to traces of each type. Container arrays (eg annotations) have special handling: An object ending in defaults (eg annotationdefaults) is applied to each array item. But if an item has a templateitemname key we look in the template array for an item with matching name and apply that instead. If no matching name is found we mark the item invisible. Any named template item not referenced is appended to the end of the array, so you can use this for a watermark annotation or a logo image, for example. To omit one of these items on the plot, make an item with matching templateitemname and visible: false.
7 nested properties
40 nested properties
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
The minimum value visible on this axis. The maximum is determined by the sum minus the minimum values of the other two axes. The full view corresponds to all the minima set to zero.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Controls persistence of user-driven changes in axis min, and title if in editable: true configuration. Defaults to ternary<N>.uirevision.
40 nested properties
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
The minimum value visible on this axis. The maximum is determined by the sum minus the minimum values of the other two axes. The full view corresponds to all the minima set to zero.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Controls persistence of user-driven changes in axis min, and title if in editable: true configuration. Defaults to ternary<N>.uirevision.
Set the background color of the subplot
40 nested properties
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
The minimum value visible on this axis. The maximum is determined by the sum minus the minimum values of the other two axes. The full view corresponds to all the minima set to zero.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Controls persistence of user-driven changes in axis min, and title if in editable: true configuration. Defaults to ternary<N>.uirevision.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this ternary subplot .
If there is a layout grid, use the domain for this row in the grid for this ternary subplot .
Sets the horizontal domain of this ternary subplot (in plot fraction).
Sets the vertical domain of this ternary subplot (in plot fraction).
The number each triplet should sum to, and the maximum range of each axis
Controls persistence of user-driven changes in axis min and title, if not overridden in the individual axes. Defaults to layout.uirevision.
11 nested properties
Determines whether the title can automatically push the figure margins. If yref='paper' then the margin will expand to ensure that the title doesn’t overlap with the edges of the container. If yref='container' then the margins will ensure that the title doesn’t overlap with the plot area, tick labels, and axis titles. If automargin=true and the margins need to be expanded, then y will be set to a default 1 and yanchor will be set to an appropriate default to ensure that minimal margin space is needed. Note that when yref='paper', only 1 or 0 are allowed y values. Invalid values will be reset to the default 1.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
4 nested properties
The amount of padding (in px) along the bottom of the component.
The amount of padding (in px) on the left side of the component.
The amount of padding (in px) on the right side of the component.
The amount of padding (in px) along the top of the component.
2 nested properties
Sets the plot's subtitle.
Sets the plot's title.
Sets the x position with respect to xref in normalized coordinates from 0 (left) to 1 (right).
Sets the title's horizontal alignment with respect to its x position. left means that the title starts at x, right means that the title ends at x and center means that the title's center is at x. auto divides xref by three and calculates the xanchor value automatically based on the value of x.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref in normalized coordinates from 0 (bottom) to 1 (top). auto places the baseline of the title onto the vertical center of the top margin.
Sets the title's vertical alignment with respect to its y position. top means that the title's cap line is at y, bottom means that the title's baseline is at y and middle means that the title's midline is at y. auto divides yref by three and calculates the yanchor value automatically based on the value of y.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
3 nested properties
The duration of the transition, in milliseconds. If equal to zero, updates are synchronous.
The easing function used for the transition
Determines whether the figure's layout or traces smoothly transitions during updates that make both traces and layout change.
Used to allow user interactions with the plot to persist after Plotly.react calls that are unaware of these interactions. If uirevision is omitted, or if it is given and it changed from the previous Plotly.react call, the exact new figure is used. If uirevision is truthy and did NOT change, any attribute that has been affected by user interactions and did not receive a different value in the new figure will keep the interaction value. layout.uirevision attribute serves as the default for uirevision attributes in various sub-containers. For finer control you can set these sub-attributes directly. For example, if your app separately controls the data on the x and y axes you might set xaxis.uirevision=*time* and yaxis.uirevision=*cost*. Then if only the y data is changed, you can update yaxis.uirevision=*quantity* and the y axis range will reset but the x axis range will retain any user-driven zoom.
2 nested properties
Sets the minimum text size between traces of the same type.
Determines how the font size for various text elements are uniformed between each trace type. If the computed text sizes were smaller than the minimum size defined by uniformtext.minsize using hide option hides the text; and using show option shows the text without further downscaling. Please note that if the size defined by minsize is greater than the font size defined by trace, then the minsize is used.
Sets the plot's width (in px).
91 nested properties
If set to an opposite-letter axis id (e.g. x2, y), this axis is bound to the corresponding opposite-letter axis. If set to free, this axis' position is determined by position.
Determines whether long tick labels automatically grow the figure margins.
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
6 nested properties
Clip autorange maximum if it goes beyond this value. Has no effect when autorangeoptions.maxallowed is provided.
Clip autorange minimum if it goes beyond this value. Has no effect when autorangeoptions.minallowed is provided.
Ensure this value is included in autorange.
Sets the source reference on Chart Studio Cloud for include.
Use this value exactly as autorange maximum.
Use this value exactly as autorange minimum.
When tickangle is set to auto, it will be set to the first angle in this array that is large enough to prevent label overlap.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines how that happens: by increasing the range, or by decreasing the domain. Default is domain for axes containing image traces, range otherwise.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines which direction we push the originally specified plot area. Options are left, center (default), and right for x axes, and top, middle (default), and bottom for y axes.
Sets the color of the dividers Only has an effect on multicategory axes.
Sets the width (in px) of the dividers Only has an effect on multicategory axes.
Sets the domain of this axis (in plot fraction).
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Could be used to set the desired inside range of this axis (excluding the labels) when ticklabelposition of the anchored axis has inside. Not implemented for axes with type log. This would be ignored when range is provided.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
If set to another axis id (e.g. x2, y), the range of this axis will match the range of the corresponding axis in data-coordinates space. Moreover, matching axes share auto-range values, category lists and histogram auto-bins. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Moreover, note that matching axes must have the same type.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
14 nested properties
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the tick color.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis, with traces and axes visible for both axes. If false, this axis does not overlay any same-letter axes. In this case, for axes with overlapping domains only the highest-numbered axis will be visible.
Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if anchor is set to free.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
11 nested properties
Sets the background color of the active range selector button.
Sets the background color of the range selector buttons.
Sets the color of the border enclosing the range selector.
Sets the width (in px) of the border enclosing the range selector.
Determines whether or not this range selector is visible. Note that range selectors are only available for x axes of type set to or auto-typed to date.
Sets the x position (in normalized coordinates) of the range selector.
Sets the range selector's horizontal position anchor. This anchor binds the x position to the left, center or right of the range selector.
Sets the y position (in normalized coordinates) of the range selector.
Sets the range selector's vertical position anchor This anchor binds the y position to the top, middle or bottom of the range selector.
8 nested properties
Determines whether or not the range slider range is computed in relation to the input data. If range is provided, then autorange is set to false.
Sets the background color of the range slider.
Sets the border color of the range slider.
Sets the border width of the range slider.
Sets the range of the range slider. If not set, defaults to the full xaxis range. If the axis type is log, then you must take the log of your desired range. If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears.
The height of the range slider as a fraction of the total plot area height.
Determines whether or not the range slider will be visible. If visible, perpendicular axes will be set to fixedrange
If set to another axis id (e.g. x2, y), the range of this axis changes together with the range of the corresponding axis such that the scale of pixels per unit is in a constant ratio. Both axes are still zoomable, but when you zoom one, the other will zoom the same amount, keeping a fixed midpoint. constrain and constraintoward determine how we enforce the constraint. You can chain these, ie yaxis: {scaleanchor: *x*}, xaxis2: {scaleanchor: *y*} but you can only link axes of the same type. The linked axis can have the opposite letter (to constrain the aspect ratio) or the same letter (to match scales across subplots). Loops (yaxis: {scaleanchor: *x*}, xaxis: {scaleanchor: *y*} or longer) are redundant and the last constraint encountered will be ignored to avoid possible inconsistent constraints via scaleratio. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Setting false allows to remove a default constraint (occasionally, you may need to prevent a default scaleanchor constraint from being applied, eg. when having an image trace yaxis: {scaleanchor: "x"} is set automatically in order for pixels to be rendered as squares, setting yaxis: {scaleanchor: false} allows to remove the constraint).
If this axis is linked to another by scaleanchor, this determines the pixel to unit scale ratio. For example, if this value is 10, then every unit on this axis spans 10 times the number of pixels as a unit on the linked axis. Use this for example to create an elevation profile where the vertical scale is exaggerated a fixed amount with respect to the horizontal.
If "true", even 4-digit integers are separated
Determines whether or not a dividers are drawn between the category levels of this axis. Only has an effect on multicategory axes.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not spikes (aka droplines) are drawn for this axis. Note: This only takes affect when hovermode = closest
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether a x (y) axis is positioned at the bottom (left) or top (right) of the plotting area.
Sets the spike color. If undefined, will use the series color
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the drawing mode for the spike line If toaxis, the line is drawn from the data point to the axis the series is plotted on. If across, the line is drawn across the entire plot area, and supercedes toaxis. If marker, then a marker dot is drawn on the axis the series is plotted on
Determines whether spikelines are stuck to the cursor or to the closest datapoints.
Sets the width (in px) of the zero line.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Only for axes with type date or linear. Instead of drawing the major tick label, draw the label for the minor tick that is n positions away from the major tick. E.g. to always draw the label for the minor tick before each major tick, choose ticklabelindex -1. This is useful for date axes with ticklabelmode period if you want to label the period that ends with each major tick instead of the period that begins there.
Sets the source reference on Chart Studio Cloud for ticklabelindex.
Determines where tick labels are drawn with respect to their corresponding ticks and grid lines. Only has an effect for axes of type date When set to period, tick labels are drawn in the middle of the period between ticks.
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. Otherwise on category and multicategory axes the default is allow. In other cases the default is hide past div.
Determines where tick labels are drawn with respect to the axis Please note that top or bottom has no effect on x axes or when ticklabelmode is set to period. Similarly left or right has no effect on y axes or when ticklabelmode is set to period. Has no effect on multicategory axes or when tickson is set to boundaries. When used on axes linked by matches or scaleanchor, no extra padding for inside labels would be added by autorange, so that the scales could match.
Shifts the tick labels by the specified number of pixels in parallel to the axis. Positive values move the labels in the positive direction of the axis.
Sets the standoff distance (in px) between the axis tick labels and their default position. A positive ticklabelstandoff moves the labels farther away from the plot area if ticklabelposition is outside, and deeper into the plot area if ticklabelposition is inside. A negative ticklabelstandoff works in the opposite direction, moving outside ticks towards the plot area and inside ticks towards the outside. If the negative value is large enough, inside ticks can even end up outside and vice versa.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided). If sync, the number of ticks will sync with the overlayed axis set by overlaying property.
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Determines where ticks and grid lines are drawn with respect to their corresponding tick labels. Only has an effect for axes of type category or multicategory. When set to boundaries, ticks and grid lines are drawn half a category to the left/bottom of labels.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Sets the standoff distance (in px) between the axis labels and the title text The default value is a function of the axis tick labels, the title font.size and the axis linewidth. Note that the axis title position is always constrained within the margins, so the actual standoff distance is always less than the set or default value. By setting standoff and turning on automargin, plotly.js will push the margins to fit the axis title at given standoff distance.
Sets the title of this axis.
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Controls persistence of user-driven changes in axis range, autorange, and title if in editable: true configuration. Defaults to layout.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
91 nested properties
If set to an opposite-letter axis id (e.g. x2, y), this axis is bound to the corresponding opposite-letter axis. If set to free, this axis' position is determined by position.
Determines whether long tick labels automatically grow the figure margins.
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
6 nested properties
Clip autorange maximum if it goes beyond this value. Has no effect when autorangeoptions.maxallowed is provided.
Clip autorange minimum if it goes beyond this value. Has no effect when autorangeoptions.minallowed is provided.
Ensure this value is included in autorange.
Sets the source reference on Chart Studio Cloud for include.
Use this value exactly as autorange maximum.
Use this value exactly as autorange minimum.
Automatically reposition the axis to avoid overlap with other axes with the same overlaying value. This repositioning will account for any shift amount applied to other axes on the same side with autoshift is set to true. Only has an effect if anchor is set to free.
When tickangle is set to auto, it will be set to the first angle in this array that is large enough to prevent label overlap.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines how that happens: by increasing the range, or by decreasing the domain. Default is domain for axes containing image traces, range otherwise.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines which direction we push the originally specified plot area. Options are left, center (default), and right for x axes, and top, middle (default), and bottom for y axes.
Sets the color of the dividers Only has an effect on multicategory axes.
Sets the width (in px) of the dividers Only has an effect on multicategory axes.
Sets the domain of this axis (in plot fraction).
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Could be used to set the desired inside range of this axis (excluding the labels) when ticklabelposition of the anchored axis has inside. Not implemented for axes with type log. This would be ignored when range is provided.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
If set to another axis id (e.g. x2, y), the range of this axis will match the range of the corresponding axis in data-coordinates space. Moreover, matching axes share auto-range values, category lists and histogram auto-bins. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Moreover, note that matching axes must have the same type.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
14 nested properties
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the tick color.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis, with traces and axes visible for both axes. If false, this axis does not overlay any same-letter axes. In this case, for axes with overlapping domains only the highest-numbered axis will be visible.
Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if anchor is set to free.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
If set to another axis id (e.g. x2, y), the range of this axis changes together with the range of the corresponding axis such that the scale of pixels per unit is in a constant ratio. Both axes are still zoomable, but when you zoom one, the other will zoom the same amount, keeping a fixed midpoint. constrain and constraintoward determine how we enforce the constraint. You can chain these, ie yaxis: {scaleanchor: *x*}, xaxis2: {scaleanchor: *y*} but you can only link axes of the same type. The linked axis can have the opposite letter (to constrain the aspect ratio) or the same letter (to match scales across subplots). Loops (yaxis: {scaleanchor: *x*}, xaxis: {scaleanchor: *y*} or longer) are redundant and the last constraint encountered will be ignored to avoid possible inconsistent constraints via scaleratio. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Setting false allows to remove a default constraint (occasionally, you may need to prevent a default scaleanchor constraint from being applied, eg. when having an image trace yaxis: {scaleanchor: "x"} is set automatically in order for pixels to be rendered as squares, setting yaxis: {scaleanchor: false} allows to remove the constraint).
If this axis is linked to another by scaleanchor, this determines the pixel to unit scale ratio. For example, if this value is 10, then every unit on this axis spans 10 times the number of pixels as a unit on the linked axis. Use this for example to create an elevation profile where the vertical scale is exaggerated a fixed amount with respect to the horizontal.
If "true", even 4-digit integers are separated
Moves the axis a given number of pixels from where it would have been otherwise. Accepts both positive and negative values, which will shift the axis either right or left, respectively. If autoshift is set to true, then this defaults to a padding of -3 if side is set to left. and defaults to +3 if side is set to right. Defaults to 0 if autoshift is set to false. Only has an effect if anchor is set to free.
Determines whether or not a dividers are drawn between the category levels of this axis. Only has an effect on multicategory axes.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not spikes (aka droplines) are drawn for this axis. Note: This only takes affect when hovermode = closest
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether a x (y) axis is positioned at the bottom (left) or top (right) of the plotting area.
Sets the spike color. If undefined, will use the series color
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the drawing mode for the spike line If toaxis, the line is drawn from the data point to the axis the series is plotted on. If across, the line is drawn across the entire plot area, and supercedes toaxis. If marker, then a marker dot is drawn on the axis the series is plotted on
Determines whether spikelines are stuck to the cursor or to the closest datapoints.
Sets the width (in px) of the zero line.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Only for axes with type date or linear. Instead of drawing the major tick label, draw the label for the minor tick that is n positions away from the major tick. E.g. to always draw the label for the minor tick before each major tick, choose ticklabelindex -1. This is useful for date axes with ticklabelmode period if you want to label the period that ends with each major tick instead of the period that begins there.
Sets the source reference on Chart Studio Cloud for ticklabelindex.
Determines where tick labels are drawn with respect to their corresponding ticks and grid lines. Only has an effect for axes of type date When set to period, tick labels are drawn in the middle of the period between ticks.
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. Otherwise on category and multicategory axes the default is allow. In other cases the default is hide past div.
Determines where tick labels are drawn with respect to the axis Please note that top or bottom has no effect on x axes or when ticklabelmode is set to period. Similarly left or right has no effect on y axes or when ticklabelmode is set to period. Has no effect on multicategory axes or when tickson is set to boundaries. When used on axes linked by matches or scaleanchor, no extra padding for inside labels would be added by autorange, so that the scales could match.
Shifts the tick labels by the specified number of pixels in parallel to the axis. Positive values move the labels in the positive direction of the axis.
Sets the standoff distance (in px) between the axis tick labels and their default position. A positive ticklabelstandoff moves the labels farther away from the plot area if ticklabelposition is outside, and deeper into the plot area if ticklabelposition is inside. A negative ticklabelstandoff works in the opposite direction, moving outside ticks towards the plot area and inside ticks towards the outside. If the negative value is large enough, inside ticks can even end up outside and vice versa.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided). If sync, the number of ticks will sync with the overlayed axis set by overlaying property.
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Determines where ticks and grid lines are drawn with respect to their corresponding tick labels. Only has an effect for axes of type category or multicategory. When set to boundaries, ticks and grid lines are drawn half a category to the left/bottom of labels.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Sets the standoff distance (in px) between the axis labels and the title text The default value is a function of the axis tick labels, the title font.size and the axis linewidth. Note that the axis title position is always constrained within the margins, so the actual standoff distance is always less than the set or default value. By setting standoff and turning on automargin, plotly.js will push the margins to fit the axis title at given standoff distance.
Sets the title of this axis.
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Controls persistence of user-driven changes in axis range, autorange, and title if in editable: true configuration. Defaults to layout.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
Sets the rounding of bar corners. May be an integer number of pixels, or a percentage of bar width (as a string ending in %).
Sets the gap (in plot fraction) between bars of adjacent location coordinates.
Sets the gap (in plot fraction) between bars of the same location coordinate.
Determines how bars at the same location coordinate are displayed on the graph. With stack, the bars are stacked on top of one another With relative, the bars are stacked on top of one another, with negative values below the axis, positive values above With group, the bars are plotted next to one another centered around the shared location. With overlay, the bars are plotted over one another, you might need to reduce opacity to see multiple bars.
Sets the normalization for bar traces on the graph. With fraction, the value of each bar is divided by the sum of all values at that location coordinate. percent is the same but multiplied by 100 to show percentages.
Sets the gap (in plot fraction) between boxes of adjacent location coordinates. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between boxes of the same location coordinate. Has no effect on traces that have width set.
Determines how boxes at the same location coordinate are displayed on the graph. If group, the boxes are plotted next to one another centered around the shared location. If overlay, the boxes are plotted over one another, you might need to set opacity to see them multiple boxes. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between bars of adjacent location coordinates.
Sets the gap (in plot fraction) between bars of the same location coordinate.
Determines how bars at the same location coordinate are displayed on the graph. With stack, the bars are stacked on top of one another With group, the bars are plotted next to one another centered around the shared location. With overlay, the bars are plotted over one another, you might need to reduce opacity to see multiple bars.
If true, the funnelarea slice colors (whether given by funnelareacolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default funnelarea slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendfunnelareacolors.
hiddenlabels is the funnelarea & pie chart analog of visible:'legendonly' but it can contain many labels, and can simultaneously hide slices from several pies/funnelarea charts
Sets the source reference on Chart Studio Cloud for hiddenlabels.
If true, the icicle slice colors (whether given by iciclecolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default icicle slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendiciclecolors.
If true, the pie slice colors (whether given by piecolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default pie slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendpiecolors.
Sets the gap (in plot fraction) between scatter points of adjacent location coordinates. Defaults to bargap.
Determines how scatter points at the same location coordinate are displayed on the graph. With group, the scatter points are plotted next to one another centered around the shared location. With overlay, the scatter points are plotted over one another, you might need to reduce opacity to see multiple scatter points.
If true, the sunburst slice colors (whether given by sunburstcolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default sunburst slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendsunburstcolors.
If true, the treemap slice colors (whether given by treemapcolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default treemap slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendtreemapcolors.
Sets the gap (in plot fraction) between violins of adjacent location coordinates. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between violins of the same location coordinate. Has no effect on traces that have width set.
Determines how violins at the same location coordinate are displayed on the graph. If group, the violins are plotted next to one another centered around the shared location. If overlay, the violins are plotted over one another, you might need to set opacity to see them multiple violins. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between bars of adjacent location coordinates.
Sets the gap (in plot fraction) between bars of the same location coordinate.
Determines how bars at the same location coordinate are displayed on the graph. With group, the bars are plotted next to one another centered around the shared location. With overlay, the bars are plotted over one another, you might need to reduce opacity to see multiple bars.
Represents a dashboard level with title and description
Display title for this level
Description of this level's purpose
Local Merge Models are models that allow you to merge data from multiple other models locally.
!!! note
Any joining is done in a local DuckDB database. While more efficient than SQLite,
it's still primarily designed for medium-sized datasets.
!!! example {% raw %}
=== "Internal join External"
Here is an example of merging two models that are defined in your project. One that is external and one that is internal.
``` yaml
models:
- name: local_merge
models:
- ref(first_domain_model)
- ref(external_data_model)
sql: SELECT * FROM first_domain_model.model AS fdm JOIN external_data_model.model AS edm ON fdm.external_id = edm.id
```
{% endraw %}
The sql used to generate your base data
A model object defined inline or a ref() to a model.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The Markdown model represents formatted text content that can be displayed in dashboards.
Markdown supports CommonMark and GitHub Flavored Markdown. You can also render raw HTML within your markdown.
Example
markdowns:
- name: welcome-text
content: |
# Welcome to Visivo
This is **formatted** text with support for:
- Lists
- **Bold** and *italic* text
- [Links](https://visivo.io)
align: center
justify: start
Then reference it in a dashboard item:
items:
- width: 1
markdown: ref(welcome-text)
Alignment Options
=== "Horizontal Alignment (align)" Controls how text aligns horizontally within the container:
`align: left` (default)
```
[Header ]
[Paragraph ]
[List ]
```
`align: center`
```
[ Header ]
[ Paragraph ]
[ List ]
```
`align: right`
```
[ Header]
[ Paragraph]
[ List]
```
=== "Vertical Distribution (justify)" Controls how content blocks are distributed vertically in fixed-height containers:
`justify: start` (default)
```
[Header ]
[Paragraph ]
[List ]
[ ]
[ ]
```
`justify: center`
```
[ ]
[Header ]
[Paragraph ]
[List ]
[ ]
```
`justify: between`
```
[Header ]
[ ]
[Paragraph ]
[ ]
[List ]
```
`justify: around`
```
[ ]
[Header ]
[ ]
[Paragraph ]
[ ]
[List ]
[ ]
```
`justify: evenly`
```
[ ]
[Header ]
[Paragraph ]
[List ]
[ ]
```
`justify: end`
```
[ ]
[ ]
[Header ]
[Paragraph ]
[List ]
```
The markdown text content to display. Supports CommonMark and GitHub Flavored Markdown.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
Horizontal alignment of the markdown content. Options are 'left', 'center', or 'right'.
Vertical distribution of content within its container. Options are 'start', 'end', 'center', 'between', 'around', or 'evenly'.
A Metric represents a reusable aggregate calculation that can be referenced across charts.
Metrics centralize business logic for key measurements, ensuring consistency and making updates easier. They can be defined at the model level (model-scoped) or at the project level (global metrics).
!!! example
=== "Model-scoped Metric"
yaml models: - name: orders sql: SELECT * FROM orders_table metrics: - name: total_revenue expression: "SUM(amount)" description: "Total revenue from all orders"
=== "Global Metric (with multiple models)"
```yaml
metrics:
- name: revenue_per_user
expression: "${ref(orders).total_revenue} / ${ref(users).total_users}"
description: "Average revenue per user"
```
SQL aggregate expression for the metric. For model-scoped metrics, use direct SQL aggregates (e.g., 'SUM(amount)', 'COUNT(DISTINCT id)'). For global metrics, can reference other metrics or fields using ${ref(model).field} or ${ref(metric_name)} syntax. Must be a valid aggregate function and cannot contain raw columns outside of aggregates.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
Human-readable description of what this metric represents.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
Default value configuration for multi-select inputs.
For list-based inputs: use 'values' field For range-based inputs: use 'start' and 'end' fields
Default selected values for list-based inputs. Can be static list, query, 'all' (default), or 'none'.
Default lower bound for range-based inputs.
Default upper bound for range-based inputs.
Display configuration for multi-select inputs.
UI component type for rendering the input.
Default value configuration. If not specified, 'all' is used for list-based.
Multi-select input for choosing multiple values.
Options can be defined in two ways (mutually exclusive):
- List-based ('options' field): Discrete choices from a static list or query
- Range-based ('range' field): Continuous/stepped values with start, end, step
Selected values are accessed using these accessors in filters:
.values- Array of all selected values.min- Minimum of selected values.max- Maximum of selected values.first- First selected value.last- Last selected value
Example YAML (list-based): inputs: - name: regions type: multi-select options: ['East', 'West', 'North', 'South'] display: type: dropdown default: values: ['East', 'West']
insights:
- name: sales_by_region
interactions:
- filter: ?{ region IN (${ref(regions).values}) }
Example YAML (range-based): inputs: - name: price_range type: multi-select range: start: 0 end: 1000 step: 50 display: type: range-slider default: start: 100 end: 500
insights:
- name: products_in_range
interactions:
- filter: ?{ price BETWEEN ${ref(price_range).min} AND ${ref(price_range).max} }
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
Input type identifier.
Label shown to the user
Available options for list-based multi-select. Can be a static list or a query string. Mutually exclusive with 'range'.
Range configuration for range-based multi-select. Defines start, end, and step values. Mutually exclusive with 'options'.
Display configuration including UI component type and default values. If not specified, defaults to dropdown with all options selected.
MysqlSources hold the connection information to MySQL data sources.
!!! example
=== "Simple"
``` yaml
sources:
- name: mysql_source
type: mysql
database: database
username: {% raw %}{{ env_var('MYSQL_USER') }}{% endraw %}
password: {% raw %}{{ env_var('MYSQL_PASSWORD') }}{% endraw %}
connection_pool_size: 2
```
!!! note
Recommended environment variable use is covered in the [sources overview.](/topics/sources/)
The database that the Visivo project will use in queries.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The port of the database.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
The pool size that is used for this connection.
PostgresqlSources hold the connection information to PostgreSQL data sources.
!!! example
=== "Simple"
``` yaml
sources:
- name: postgresql_source
type: postgresql
database: database
username: {% raw %}{{ env_var('PG_USER') }}{% endraw %}
password: {% raw %}{{ env_var('PG_PASSWORD') }}{% endraw %}
connection_pool_size: 2
```
!!! note
Recommended environment variable use is covered in the [sources overview.](/topics/sources/)
The database that the Visivo project will use in queries.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The port of the database.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
The pool size that is used for this connection.
Configuration for range-based multi-select inputs.
Range inputs generate stepped values between start and end bounds. Values are computed at frontend runtime, not during compile/run.
Lower bound. Can be static value, query, or date expression.
Upper bound. Can be static value, query, or date expression.
Step increment. Required. Can be static value, query, or time unit string.
RedshiftSources hold the connection information to Amazon Redshift data sources.
!!! example
=== "Basic Username/Password"
``` yaml
sources:
- name: redshift_source
type: redshift
database: dev
host: my-cluster.abcdefghij.us-east-1.redshift.amazonaws.com
port: 5439
username: {% raw %}{{ env_var('REDSHIFT_USER') }}{% endraw %}
password: {% raw %}{{ env_var('REDSHIFT_PASSWORD') }}{% endraw %}
db_schema: public
```
=== "IAM Authentication"
``` yaml
sources:
- name: redshift_source
type: redshift
database: dev
host: my-cluster.abcdefghij.us-east-1.redshift.amazonaws.com
port: 5439
username: {% raw %}{{ env_var('REDSHIFT_USER') }}{% endraw %}
cluster_identifier: my-cluster
region: us-east-1
iam: true
db_schema: public
```
!!! note
Recommended environment variable use is covered in the [sources overview.](/topics/sources/)
The database that the Visivo project will use in queries.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The port of the database.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
The cluster identifier for IAM authentication.
The AWS region where your Redshift cluster is located.
Use IAM authentication instead of username/password.
Use SSL connection to Redshift.
The pool size that is used for this connection.
A Relation defines how two models can be joined together.
Relations enable cross-model analysis by declaring the join conditions between models. This allows metrics to combine data from multiple models and enables the system to automatically generate the necessary SQL JOINs. The models involved in the relation are inferred from the condition.
!!! example
yaml relations: - name: orders_to_users join_type: inner condition: "${ref(orders).user_id} = ${ref(users).id}" is_default: true
SQL condition for joining the models. Use ${ref(model).field} syntax to reference fields. Example: '${ref(orders).user_id} = ${ref(users).id}'. Cannot join on metrics (aggregated values).
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
Type of SQL join to use when connecting the models.
Whether this is the default relation to use when joining these two models. Useful when multiple relations exist between the same pair of models.
Rows are the horizontal component of the dashboard grid and house 1 to many Items.
!!! tip
You can set the height of a row using the height attribute on a row
??? information "Row Height Options in Pixels"
| Height | Pixels |
|------------|-------|
| compact | wrapped |
| xsmall | 128 |
| small | 256 |
| medium | 396 |
| large | 512 |
| xlarge | 768 |
| xxlarge | 1024 |
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
A list of items containing tables, charts or markdown. Items are placed in the row in the order that they are listed from left to right.
Selectors enable you to toggle between multiple different traces in your chart.
!!! tip Selectors can also be used to add interactivity between charts different tables. You can read more about using selectors to add interactivity here.
You can configure selectors to be single select or multi-select. Single select is great if you only want to show a single trace at a time on the chart while the multi-select can be really useful for providing filtering capabilities.
Example
Here's how you might use selectors to create interactivity between two different charts.
charts:
- name: Chart One
selector:
name: Common Selector
type: single
...
- name: Chart Two
selector: ref(Common Selector)
...
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
Optional set of traces, items, or rows to create the choices list
[]
Default value configuration for single-select inputs.
Default selected value. Can be static value or query.
Display configuration for single-select inputs.
UI component type for rendering the input.
Default value configuration. If not specified, first option is used.
Single-select input for choosing one value from a set of options.
Options can be defined as a static list or a query that returns values.
The selected value is accessed using the .value accessor in filters.
Example YAML: inputs: - name: region type: single-select options: ['East', 'West', 'North', 'South'] display: type: dropdown default: value: 'East'
insights:
- name: sales_by_region
interactions:
- filter: ?{ region = ${ref(region).value} }
Available options. Can be a static list or a query string. Query must reference exactly one SqlModel using ${ref(model_name)}.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
Input type identifier.
Label shown to the user
Display configuration including UI component type and default value. If not specified, defaults to dropdown with first option selected.
You can configure slack alerts by setting up an incoming message slack webhook. Once you do that, the set up in Visivo is super simple:
alerts:
- name: slack-destination #any name you choose
type: slack
webhook_url: {% raw %}{{ env_var("SLACK_WEBHOOK")}}{% endraw %}
The type of Destination Destination. Needs to be slack to configure a slack destination
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
An incoming message slack webhook url. You can set one of those up by following these instructions.
SnowflakeSources hold the connection information to Snowflake data sources.
!!! example
=== "Simple"
``` yaml
sources:
- name: snowflake_source
type: snowflake
database: DEV
warehouse: DEV
account: ab12345.us-west-1.aws
db_schema: DEFAULT
username: {% raw %}{{ env_var('SNOWFLAKE_USER') }}{% endraw %}
password: {% raw %}{{ env_var('SNOWFLAKE_PASSWORD') }}{% endraw %}
```
=== "Key Authentication"
``` yaml
sources:
- name: snowflake_source
type: snowflake
database: DEV
warehouse: DEV
account: ab12345.us-west-1.aws
db_schema: DEFAULT
username: {% raw %}"{{ env_var('SNOWFLAKE_USER') }}"{% endraw %}
private_key_path: /path/to/rsa_key.p8
private_key_passphrase: {% raw %}"{{ env_var('DB_PRIVATE_KEY_PASSPHRASE') }}"{% endraw %}
```
Note: Recommended environment variable use is covered in the sources overview.
The database that the Visivo project will use in queries.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The port of the database.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
The snowflake account url. Here's how you find this: snowflake docs.
The compute warehouse that you want queries from your Visivo project to leverage.
The access role that you want to use when running queries.
The timezone that you want to use by default when running queries.
Path to the private key file (.p8) for key pair authentication. If provided, password will be ignored.
Passphrase for the private key file if it is encrypted.
The pool size that is used for this connection.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The sql used to generate your base data
A source object defined inline or a ref() to a chart. Override the defaults.source_name
SqliteSources hold the connection information to SQLite data sources.
!!! example {% raw %}
=== "Simple"
``` yaml
sources:
- name: sqlite_source
database: local/file/local.db
type: sqlite
```
=== "Additional Attached"
Attaching other SQLite databases allows you to join models between databases.
``` yaml
sources:
- name: sqlite_source
database: local/file/local.db
type: sqlite
attach:
- schema_name: static
name: static_source
database: local/static/file/local.db
type: sqlite
```
The above source can be then used in a model and the sql for that model might look similar to: `SELECT * FROM local AS l JOIN static.data AS sd ON l.static_id=sd.id`
{% endraw %}
!!! note
Recommended environment variable use is covered in the [sources overview.](/topics/sources/)
The database that the Visivo project will use in queries.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The host url of the database.
The port of the database.
Username for the database.
Password corresponding to the username.
The schema that the Visivo project will use in queries.
List of other local SQLite database sources to attach in the connection that will be available in the base SQL query.
Tables enable you to quickly represent trace data in a tabular format.
Since tables sit on top of trace data, the steps to create a table from scratch are as follows:
- Create a model.
- Create a trace with columns or props that references your model.
- Create a table that references the trace. Within the table.columns block you will need to explicitly state the trace columns and header names that you want to include.
Example
models:
- name: table-model
sql: |
select
project_name,
project_created_at,
cli_version,
stage_name,
account_name,
stage_archived
FROM visivo_project
traces:
- name: pre-table-trace
model: ref(table-model)
columns:
project_name: project_name
project_created_at: project_created_at::varchar
cli_version: cli_version
stage_name: stage_name
account_name: account_name
stage_archived: stage_archived::varchar
props:
type: scatter
x: column(project_created_at)
y: column(project_name)
tables:
- name: latest-projects-table
traces:
- ref(pre-table-trace)
column_defs:
- trace_name: pre-table-trace
columns:
- header: "Project Name"
key: columns.project_name
- header: "Project Created At"
key: columns.project_created_at
- header: "Project Json"
key: columns.project_json
- header: "CLI Version"
key: columns.cli_version
- header: "Stage Name"
key: columns.stage_name
aggregation: uniqueCount
- header: "Account Name"
key: columns.account_name
- header: "Account Name"
key: columns.stage_archived
Tables are built on the material react table framework.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The selector for the choosing which trace data is shown.
A ref() to a trace or trace defined in line. Data for the table will come from the trace.
[]
A ref() to a insight or insight defined in line. Data for the table will come from the insight.
[]
A list of column definitions. These definitions define the columns for a given trace included in this table.
A unique path to this object
The display name of the column. Defaults to readable key name.
The key to the data that will pull back the value.
The aggregate function that will apply to the column when a user groups the table by a different column. Defaults to none.
If true, the column content will be rendered as markdown. Defaults to false.
Table columns allow you to display a subset of the available trace data.
A list of column definitions that contain header and key. header is the title of the column in the table. key is the path to the array property you want to include. For example 'props.x' or 'columns.x_data'.
A unique path to this object
The name of the trace that the column defs apply to.
The name of the insight that the column defs apply to.
A unique path to this object
The unique name of the object across the entire project.
The path to the file that contains the object definition.
The Trace is one of the most important objects within a Visivo Project. You can think of a trace as a single series on a chart (ie. one line, a sequence of bars, a big number ect.).
{% raw %}
!!! example
Total Revenue by Week would be a trace. Once you define this metric in a single trace in your project, you can add it to as many charts as you want. This is especially powerful since charts are able to join disparate axis automatically. Meaning you can define a trace for Revenue Per Week and then define another trace for Revenue per Day and include both of those traces on the same chart with no extra configuration needed.
This approach has a few key advantages:
- Modularity: Traces can appear on multiple charts & tables.
- Single Source of Truth: Traces are a single source of truth.
- Testable: You can write general & fast tests to ensure that trace data is correct.
Cohorts
To easily cut a trace into multiple cohorts you can use the cohort_on attribute.
!!! example
To represent Revenue Per Week by Account Executive. You can use the cohort_on attribute to split out data into different series within a single trace.
yaml traces: - name: rev-per-week-by-account-executive cohort_on: "account_executive_name" model: ref(orders) columns: week: date_trunc('week', "order_date") orders: count(*) props: type: bar x: column(week) y: column(orders)
Traces are also where you define how you want to represent your data visually. Since Visivo leverages plotly for charting, you can set up a number of unique and useful trace types that are also highly customizable. See types below.
Example
traces:
- name: crypto ohlc
model:
sql: 'SELECT * finance_data_atlas.FINANCE.CMCCD2019'
source_name: remote-snowflake
cohort_on: ?{ "Cryptocurrency Name" }
props:
type: ohlc
x: ?{ date_trunc('week', "Date")::date::varchar }
close: ?{ max_by("Value", "Date") }
high: ?{ max("Value") }
low: ?{ min("Value") }
open: ?{ min_by("Value", "Date") }
increasing:
line:
color: 'green'
decreasing:
line:
color: 'red'
xaxis: 'x'
yaxis: 'y'
filters:
- ?{"Date" >= '2015-01-01'}
- ?{ "Cryptocurrency Name" in ('Bitcoin (btc)', 'Ethereum (eth)', 'Dogecoin (doge)') }
- ?{ "Measure Name" = 'Price, USD' }
{% endraw %}
The unique name of the object across the entire project.
The model or model ref that Visivo should use to build the trace.
A unique path to this object
The path to the file that contains the object definition.
cohort_on enables splitting the trace out into different series or cohorts. The column or query referenced here will be used to cut the resulting trace.
Takes a column() or ?{} reference. Orders the dataset so that information is presented in the correct order when the trace is added to a chart. Order by query statements support using asc and desc.
A list of column() or ?{} functions that evaluate to true or false. Can include aggregations in the sql statement.
A list of tests to run against the trace data. Enables making assertions about the nullability of data and relationships between data.
Place where you can define named sql select statements. Once they are defined here they can be referenced in the trace props or in tables built on the trace.
List of relations to use when joining models for metrics. Can be relation names using ref() syntax (e.g., 'ref(orders_to_users)'), context references (e.g., '${orders_to_users}'), or inline Relation objects with 'left_model', 'right_model', 'condition', etc. These define the preferred join paths when metrics from different models are used together.
A schema to validate plotly layout
88 nested properties
2 nested properties
Sets the color filling the active selection' interior.
Sets the opacity of the active selection.
2 nested properties
Sets the color filling the active shape' interior.
Sets the opacity of the active shape.
Determines whether or not a layout width or height that has been left undefined by the user is initialized on each relayout. Note that, regardless of this attribute, an undefined layout width or height is always initialized on the first call to plot.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. This is the default value; however it could be overridden for individual axes.
Sets the default calendar system to use for interpreting and displaying dates throughout the plot.
Determines the mode of single click interactions. event is the default value and emits the plotly_click event. In addition this mode emits the plotly_selected event in drag modes lasso and select, but with no event data attached (kept for compatibility reasons). The select flag enables selecting single data points via click. This mode also supports persistent selections, meaning that pressing Shift while clicking, adds to / subtracts from an existing selection. select with hovermode: x can be confusing, consider explicitly setting hovermode: closest when using this feature. Selection events are sent accordingly as long as event flag is set as well. When the event flag is missing, plotly_click and plotly_selected events are not fired.
9 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here corresponding trace color array(s)) or the bounds set in cmin and cmax Defaults to false when cmin and cmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as corresponding trace color array(s) and if set, cmin must be set as well.
Sets the mid-point of the color domain by scaling cmin and/or cmax to be equidistant to this point. Value should have the same units as corresponding trace color array(s). Has no effect when cauto is false.
Sets the lower bound of the color domain. Value should have the same units as corresponding trace color array(s) and if set, cmax must be set as well.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use cmin and cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Reverses the color mapping if true. If true, cmin will correspond to the last color in the array and cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace.
3 nested properties
Sets the default diverging colorscale. Note that autocolorscale must be true for this attribute to work.
Sets the default sequential colorscale for positive values. Note that autocolorscale must be true for this attribute to work.
Sets the default sequential colorscale for negative values. Note that autocolorscale must be true for this attribute to work.
Sets the default trace colors.
Placeholder for exporting automargin-impacting values namely margin.t, margin.b, margin.l and margin.r in full-json mode.
If provided, a changed value tells Plotly.react that one or more data arrays has changed. This way you can modify arrays in-place rather than making a complete new copy for an incremental change. If NOT provided, Plotly.react assumes that data arrays are being treated as immutable, thus any data array with a different identity from its predecessor contains new data.
Determines the mode of drag interactions. select and lasso apply only to scatter traces with markers or text. orbit and turntable apply only to 3D scenes.
Controls persistence of user-driven changes in editable: true configuration, other than trace names and axis titles. Defaults to layout.uirevision.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
32 nested properties
Set the background color of the map
Sets the coastline color.
Sets the coastline stroke width (in px).
Sets line color of the country boundaries.
Sets line width (in px) of the country boundaries.
Determines if this subplot's view settings are auto-computed to fit trace data. On scoped maps, setting fitbounds leads to center.lon and center.lat getting auto-filled. On maps with a non-clipped projection, setting fitbounds leads to center.lon, center.lat, and projection.rotation.lon getting auto-filled. On maps with a clipped projection, setting fitbounds leads to center.lon, center.lat, projection.rotation.lon, projection.rotation.lat, lonaxis.range and lataxis.range getting auto-filled. If locations, only the trace's visible locations are considered in the fitbounds computations. If geojson, the entire trace input geojson (if provided) is considered in the fitbounds computations, Defaults to false.
Sets the color the frame.
Sets the stroke width (in px) of the frame.
Sets the color of the lakes.
Sets the land mass color.
Sets the ocean color
Sets the resolution of the base layers. The values have units of km/mm e.g. 110 corresponds to a scale ratio of 1:110,000,000.
Sets color of the rivers.
Sets the stroke width (in px) of the rivers.
Set the scope of the map.
Sets whether or not the coastlines are drawn.
Sets whether or not country boundaries are drawn.
Sets whether or not a frame is drawn around the map.
Sets whether or not lakes are drawn.
Sets whether or not land masses are filled in color.
Sets whether or not oceans are filled in color.
Sets whether or not rivers are drawn.
Sets whether or not boundaries of subunits within countries (e.g. states, provinces) are drawn.
Sets the color of the subunits boundaries.
Sets the stroke width (in px) of the subunits boundaries.
Controls persistence of user-driven changes in the view (projection and center). Defaults to layout.uirevision.
Sets the default visibility of the base layers.
12 nested properties
The number of columns in the grid. If you provide a 2D subplots array, the length of its longest row is used as the default. If you give an xaxes array, its length is used as the default. But it's also possible to have a different length, if you want to leave a row at the end for non-cartesian subplots.
If no subplots, xaxes, or yaxes are given but we do have rows and columns, we can generate defaults using consecutive axis IDs, in two ways: coupled gives one x axis per column and one y axis per row. independent uses a new xy pair for each cell, left-to-right across each row then iterating rows according to roworder.
Is the first row the top or the bottom? Note that columns are always enumerated from left to right.
The number of rows in the grid. If you provide a 2D subplots array or a yaxes array, its length is used as the default. But it's also possible to have a different length, if you want to leave a row at the end for non-cartesian subplots.
Used for freeform grids, where some axes may be shared across subplots but others are not. Each entry should be a cartesian subplot id, like xy or x3y2, or ** to leave that cell empty. You may reuse x axes within the same column, and y axes within the same row. Non-cartesian subplots and traces that support domain can place themselves in this grid separately using the gridcell attribute.
Used with yaxes when the x and y axes are shared across columns and rows. Each entry should be an x axis id like x, x2, etc., or ** to not put an x axis in that column. Entries other than ** must be unique. Ignored if subplots is present. If missing but yaxes is present, will generate consecutive IDs.
Horizontal space between grid cells, expressed as a fraction of the total width available to one cell. Defaults to 0.1 for coupled-axes grids and 0.2 for independent grids.
Sets where the x axis labels and titles go. bottom means the very bottom of the grid. bottom plot is the lowest plot that each x axis is used in. top and top plot are similar.
Used with yaxes when the x and y axes are shared across columns and rows. Each entry should be an y axis id like y, y2, etc., or ** to not put a y axis in that row. Entries other than ** must be unique. Ignored if subplots is present. If missing but xaxes is present, will generate consecutive IDs.
Vertical space between grid cells, expressed as a fraction of the total height available to one cell. Defaults to 0.1 for coupled-axes grids and 0.3 for independent grids.
Sets where the y axis labels and titles go. left means the very left edge of the grid. left plot is the leftmost plot that each y axis is used in. right and right plot are similar.
Sets the plot's height (in px).
Determines whether or not a text link citing the data source is placed at the bottom-right cored of the figure. Has only an effect only on graphs that have been generated via forked graphs from the Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise).
Sets the default distance (in pixels) to look for data to add hover labels (-1 means no cutoff, 0 means no looking for data). This is only a real distance for hovering on point-like objects, like scatter points. For area-like objects (bars, scatter fills, etc) hovering is on inside the area and off outside, but these objects will not supersede hover on point-like objects in case of conflict.
6 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the background color of all hover labels on graph
Sets the border color of all hover labels on graph.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Determines the mode of hover interactions. If closest, a single hoverlabel will appear for the closest point within the hoverdistance. If x (or y), multiple hoverlabels will appear for multiple points at the closest x- (or y-) coordinate within the hoverdistance, with the caveat that no more than one hoverlabel will appear per trace. If x unified (or y unified), a single hoverlabel will appear multiple points at the closest x- (or y-) coordinate within the hoverdistance with the caveat that no more than one hoverlabel will appear per trace. In this mode, spikelines are enabled by default perpendicular to the specified axis. If false, hover interactions are disabled.
Determines expansion of hover effects to other subplots If single just the axis pair of the primary point is included without overlaying subplots. If overlaying all subplots using the main axis and occupying the same space are included. If axis, also include stacked subplots using the same axis when hovermode is set to x, x unified, y or y unified.
27 nested properties
Sets the legend background color. Defaults to layout.paper_bgcolor.
Sets the color of the border enclosing the legend.
Sets the width (in px) of the border enclosing the legend.
Sets the width (in px or fraction) of the legend. Use 0 to size the entry based on the text width, when entrywidthmode is set to pixels.
Determines what entrywidth means.
Determines the behavior on legend group item click. toggleitem toggles the visibility of the individual item clicked on the graph. togglegroup toggles the visibility of all items in the same legendgroup as the item clicked on the graph.
Sets the indentation (in px) of the legend entries.
Determines the behavior on legend item click. toggle toggles the visibility of the item clicked on the graph. toggleothers makes the clicked item the sole visible item on the graph. false disables legend item click interactions.
Determines the behavior on legend item double-click. toggle toggles the visibility of the item clicked on the graph. toggleothers makes the clicked item the sole visible item on the graph. false disables legend item double-click interactions.
Determines if the legend items symbols scale with their corresponding trace attributes or remain constant independent of the symbol size on the graph.
Sets the width (in px) of the legend item symbols (the part other than the title.text).
Sets the max height (in px) of the legend, or max height ratio (reference height * ratio) if less than one. Default value is: 0.5 for horizontal legends; 1 for vertical legends. The minimum allowed height is 30px. For a ratio of 0.5, the legend will take up to 50% of the reference height before displaying a scrollbar. The reference height is the full layout height except for vertically oriented legends with a yref of "paper", where the reference height is the plot height.
Sets the orientation of the legend.
Sets the amount of vertical space (in px) between legend groups.
Determines the order at which the legend items are displayed. If normal, the items are displayed top-to-bottom in the same order as the input data. If reversed, the items are displayed in the opposite order as normal. If grouped, the items are displayed in groups (when a trace legendgroup is provided). if grouped+reversed, the items are displayed in the opposite order as grouped.
Controls persistence of legend-driven changes in trace and pie label visibility. Defaults to layout.uirevision.
Sets the vertical alignment of the symbols with respect to their associated text.
Determines whether or not this legend is visible.
Sets the x position with respect to xref (in normalized coordinates) of the legend. When xref is paper, defaults to 1.02 for vertical legends and defaults to 0 for horizontal legends. When xref is container, defaults to 1 for vertical legends and defaults to 0 for horizontal legends. Must be between 0 and 1 if xref is container. and between -2 and 3 if xref is paper.
Sets the legend's horizontal position anchor. This anchor binds the x position to the left, center or right of the legend. Value auto anchors legends to the right for x values greater than or equal to 2/3, anchors legends to the left for x values less than or equal to 1/3 and anchors legends with respect to their center otherwise.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref (in normalized coordinates) of the legend. When yref is paper, defaults to 1 for vertical legends, defaults to -0.1 for horizontal legends on graphs w/o range sliders and defaults to 1.1 for horizontal legends on graph with one or multiple range sliders. When yref is container, defaults to 1. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets the legend's vertical position anchor This anchor binds the y position to the top, middle or bottom of the legend. Value auto anchors legends at their bottom for y values less than or equal to 1/3, anchors legends to at their top for y values greater than or equal to 2/3 and anchors legends with respect to their middle otherwise.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
9 nested properties
Sets the bearing angle of the map in degrees counter-clockwise from North (map.bearing).
Sets the pitch angle of the map (in degrees, where 0 means perpendicular to the surface of the map) (map.pitch).
Defines the map layers that are rendered by default below the trace layers defined in data, which are themselves by default rendered below the layers defined in layout.map.layers. These layers can be defined either explicitly as a Map Style object which can contain multiple layer definitions that load data from any public or private Tile Map Service (TMS or XYZ) or Web Map Service (WMS) or implicitly by using one of the built-in style objects which use WMSes or by using a custom style URL Map Style objects are of the form described in the MapLibre GL JS documentation available at https://maplibre.org/maplibre-style-spec/ The built-in plotly.js styles objects are: basic, carto-darkmatter, carto-darkmatter-nolabels, carto-positron, carto-positron-nolabels, carto-voyager, carto-voyager-nolabels, dark, light, open-street-map, outdoors, satellite, satellite-streets, streets, white-bg.
Controls persistence of user-driven changes in the view: center, zoom, bearing, pitch. Defaults to layout.uirevision.
Sets the zoom level of the map (map.zoom).
10 nested properties
Sets the mapbox access token to be used for this mapbox map. Alternatively, the mapbox access token can be set in the configuration options under mapboxAccessToken. Note that accessToken are only required when style (e.g with values : basic, streets, outdoors, light, dark, satellite, satellite-streets ) and/or a layout layer references the Mapbox server.
Sets the bearing angle of the map in degrees counter-clockwise from North (mapbox.bearing).
Sets the pitch angle of the map (in degrees, where 0 means perpendicular to the surface of the map) (mapbox.pitch).
Defines the map layers that are rendered by default below the trace layers defined in data, which are themselves by default rendered below the layers defined in layout.mapbox.layers. These layers can be defined either explicitly as a Mapbox Style object which can contain multiple layer definitions that load data from any public or private Tile Map Service (TMS or XYZ) or Web Map Service (WMS) or implicitly by using one of the built-in style objects which use WMSes which do not require any access tokens, or by using a default Mapbox style or custom Mapbox style URL, both of which require a Mapbox access token Note that Mapbox access token can be set in the accesstoken attribute or in the mapboxAccessToken config option. Mapbox Style objects are of the form described in the Mapbox GL JS documentation available at https://docs.mapbox.com/mapbox-gl-js/style-spec The built-in plotly.js styles objects are: carto-darkmatter, carto-positron, open-street-map, stamen-terrain, stamen-toner, stamen-watercolor, white-bg The built-in Mapbox styles are: basic, streets, outdoors, light, dark, satellite, satellite-streets Mapbox style URLs are of the form: mapbox://mapbox.mapbox-
Controls persistence of user-driven changes in the view: center, zoom, bearing, pitch. Defaults to layout.uirevision.
Sets the zoom level of the map (mapbox.zoom).
6 nested properties
Turns on/off margin expansion computations. Legends, colorbars, updatemenus, sliders, axis rangeselector and rangeslider are allowed to push the margins by defaults.
Sets the bottom margin (in px).
Sets the left margin (in px).
Sets the amount of padding (in px) between the plotting area and the axis lines
Sets the right margin (in px).
Sets the top margin (in px).
Sets the source reference on Chart Studio Cloud for meta.
Minimum height of the plot with margin.automargin applied (in px)
Minimum width of the plot with margin.automargin applied (in px)
9 nested properties
Sets the color of the active or hovered on icons in the modebar.
Determines which predefined modebar buttons to add. Please note that these buttons will only be shown if they are compatible with all trace types used in a graph. Similar to config.modeBarButtonsToAdd option. This may include v1hovermode, hoverclosest, hovercompare, togglehover, togglespikelines, drawline, drawopenpath, drawclosedpath, drawcircle, drawrect, eraseshape.
Sets the source reference on Chart Studio Cloud for add.
Sets the background color of the modebar.
Sets the color of the icons in the modebar.
Sets the orientation of the modebar.
Determines which predefined modebar buttons to remove. Similar to config.modeBarButtonsToRemove option. This may include autoScale2d, autoscale, editInChartStudio, editinchartstudio, hoverCompareCartesian, hovercompare, lasso, lasso2d, orbitRotation, orbitrotation, pan, pan2d, pan3d, reset, resetCameraDefault3d, resetCameraLastSave3d, resetGeo, resetSankeyGroup, resetScale2d, resetViewMap, resetViewMapbox, resetViews, resetcameradefault, resetcameralastsave, resetsankeygroup, resetscale, resetview, resetviews, select, select2d, sendDataToCloud, senddatatocloud, tableRotation, tablerotation, toImage, toggleHover, toggleSpikelines, togglehover, togglespikelines, toimage, zoom, zoom2d, zoom3d, zoomIn2d, zoomInGeo, zoomInMap, zoomInMapbox, zoomOut2d, zoomOutGeo, zoomOutMap, zoomOutMapbox, zoomin, zoomout.
Sets the source reference on Chart Studio Cloud for remove.
Controls persistence of user-driven changes related to the modebar, including hovermode, dragmode, and showspikes at both the root level and inside subplots. Defaults to layout.uirevision.
2 nested properties
Describes how a new selection is created. If immediate, a new selection is created after first mouse up. If gradual, a new selection is not created after first mouse. By adding to and subtracting from the initial selection, this option allows declaring extra outlines of the selection.
15 nested properties
When dragmode is set to drawrect, drawline or drawcircle this limits the drag to be horizontal, vertical or diagonal. Using diagonal there is no limit e.g. in drawing lines in any direction. ortho limits the draw to be either horizontal or vertical. horizontal allows horizontal extend. vertical allows vertical extend.
Sets the color filling new shapes' interior. Please note that if using a fillcolor with alpha greater than half, drag inside the active shape starts moving the shape underneath, otherwise a new shape could be started over.
Determines the path's interior. For more info please visit https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/fill-rule
Specifies whether new shapes are drawn below gridlines (below), between gridlines and traces (between) or above traces (above).
Sets the reference to a legend to show new shape in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for new shape. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
Sets the legend rank for new shape. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items.
Sets the width (in px or fraction) of the legend for new shape.
Sets new shape name. The name appears as the legend item.
Sets the opacity of new shapes.
Determines whether or not new shape is shown in the legend.
Determines whether or not new shape is visible. If legendonly, the shape is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the background color of the paper where the graph is drawn.
Sets the background color of the plotting area in-between x and y axes.
8 nested properties
Set the background color of the subplot
Determines if the radial axis grid lines and angular axis line are drawn as circular sectors or as linear (polygon) sectors. Has an effect only when the angular axis has type category. Note that radialaxis.angle is snapped to the angle of the closest vertex when gridshape is circular (so that radial axis scale is the same as the data scale).
Sets the fraction of the radius to cut out of the polar subplot.
Sets angular span of this polar subplot with two angles (in degrees). Sector are assumed to be spanned in the counterclockwise direction with 0 corresponding to rightmost limit of the polar subplot.
Controls persistence of user-driven changes in axis attributes, if not overridden in the individual axes. Defaults to layout.uirevision.
12 nested properties
If cube, this scene's axes are drawn as a cube, regardless of the axes' ranges. If data, this scene's axes are drawn in proportion with the axes' ranges. If manual, this scene's axes are drawn in proportion with the input of aspectratio (the default behavior if aspectratio is provided). If auto, this scene's axes are drawn using the results of data except when one axis is more than four times the size of the two others, where in that case the results of cube are used.
Determines the mode of drag interactions for this scene.
Determines the mode of hover interactions for this scene.
Controls persistence of user-driven changes in camera attributes. Defaults to layout.uirevision.
When dragmode is set to select, this limits the selection of the drag to horizontal, vertical or diagonal. h only allows horizontal selection, v only vertical, d only diagonal and any sets no limit.
Controls persistence of user-driven changes in selected points from all traces.
Sets the decimal and thousand separators. For example, *. * puts a '.' before decimals and a space between thousands. In English locales, dflt is ., but other locales may alter this default.
Determines whether or not a legend is drawn. Default is true if there is a trace to show and any of these: a) Two or more traces would by default be shown in the legend. b) One pie trace is shown in the legend. c) One trace is explicitly given with showlegend: true.
4 nested properties
Set the background color of the subplot
Sets the default distance (in pixels) to look for data to draw spikelines to (-1 means no cutoff, 0 means no looking for data). As with hoverdistance, distance does not apply to area-like objects. In addition, some objects can be hovered on but will not generate spikelines, such as scatter fills.
Default attributes to be applied to the plot. Templates can be created from existing plots using Plotly.makeTemplate, or created manually. They should be objects with format: {layout: layoutTemplate, data: {[type]: [traceTemplate, ...]}, ...} layoutTemplate and traceTemplate are objects matching the attribute structure of layout and a data trace. Trace templates are applied cyclically to traces of each type. Container arrays (eg annotations) have special handling: An object ending in defaults (eg annotationdefaults) is applied to each array item. But if an item has a templateitemname key we look in the template array for an item with matching name and apply that instead. If no matching name is found we mark the item invisible. Any named template item not referenced is appended to the end of the array, so you can use this for a watermark annotation or a logo image, for example. To omit one of these items on the plot, make an item with matching templateitemname and visible: false.
7 nested properties
Set the background color of the subplot
The number each triplet should sum to, and the maximum range of each axis
Controls persistence of user-driven changes in axis min and title, if not overridden in the individual axes. Defaults to layout.uirevision.
11 nested properties
Determines whether the title can automatically push the figure margins. If yref='paper' then the margin will expand to ensure that the title doesn’t overlap with the edges of the container. If yref='container' then the margins will ensure that the title doesn’t overlap with the plot area, tick labels, and axis titles. If automargin=true and the margins need to be expanded, then y will be set to a default 1 and yanchor will be set to an appropriate default to ensure that minimal margin space is needed. Note that when yref='paper', only 1 or 0 are allowed y values. Invalid values will be reset to the default 1.
Sets the plot's title.
Sets the x position with respect to xref in normalized coordinates from 0 (left) to 1 (right).
Sets the title's horizontal alignment with respect to its x position. left means that the title starts at x, right means that the title ends at x and center means that the title's center is at x. auto divides xref by three and calculates the xanchor value automatically based on the value of x.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref in normalized coordinates from 0 (bottom) to 1 (top). auto places the baseline of the title onto the vertical center of the top margin.
Sets the title's vertical alignment with respect to its y position. top means that the title's cap line is at y, bottom means that the title's baseline is at y and middle means that the title's midline is at y. auto divides yref by three and calculates the yanchor value automatically based on the value of y.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
3 nested properties
The duration of the transition, in milliseconds. If equal to zero, updates are synchronous.
The easing function used for the transition
Determines whether the figure's layout or traces smoothly transitions during updates that make both traces and layout change.
Used to allow user interactions with the plot to persist after Plotly.react calls that are unaware of these interactions. If uirevision is omitted, or if it is given and it changed from the previous Plotly.react call, the exact new figure is used. If uirevision is truthy and did NOT change, any attribute that has been affected by user interactions and did not receive a different value in the new figure will keep the interaction value. layout.uirevision attribute serves as the default for uirevision attributes in various sub-containers. For finer control you can set these sub-attributes directly. For example, if your app separately controls the data on the x and y axes you might set xaxis.uirevision=*time* and yaxis.uirevision=*cost*. Then if only the y data is changed, you can update yaxis.uirevision=*quantity* and the y axis range will reset but the x axis range will retain any user-driven zoom.
2 nested properties
Sets the minimum text size between traces of the same type.
Determines how the font size for various text elements are uniformed between each trace type. If the computed text sizes were smaller than the minimum size defined by uniformtext.minsize using hide option hides the text; and using show option shows the text without further downscaling. Please note that if the size defined by minsize is greater than the font size defined by trace, then the minsize is used.
Sets the plot's width (in px).
91 nested properties
If set to an opposite-letter axis id (e.g. x2, y), this axis is bound to the corresponding opposite-letter axis. If set to free, this axis' position is determined by position.
Determines whether long tick labels automatically grow the figure margins.
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
When tickangle is set to auto, it will be set to the first angle in this array that is large enough to prevent label overlap.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines how that happens: by increasing the range, or by decreasing the domain. Default is domain for axes containing image traces, range otherwise.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines which direction we push the originally specified plot area. Options are left, center (default), and right for x axes, and top, middle (default), and bottom for y axes.
Sets the color of the dividers Only has an effect on multicategory axes.
Sets the width (in px) of the dividers Only has an effect on multicategory axes.
Sets the domain of this axis (in plot fraction).
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Could be used to set the desired inside range of this axis (excluding the labels) when ticklabelposition of the anchored axis has inside. Not implemented for axes with type log. This would be ignored when range is provided.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
If set to another axis id (e.g. x2, y), the range of this axis will match the range of the corresponding axis in data-coordinates space. Moreover, matching axes share auto-range values, category lists and histogram auto-bins. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Moreover, note that matching axes must have the same type.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis, with traces and axes visible for both axes. If false, this axis does not overlay any same-letter axes. In this case, for axes with overlapping domains only the highest-numbered axis will be visible.
Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if anchor is set to free.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
If set to another axis id (e.g. x2, y), the range of this axis changes together with the range of the corresponding axis such that the scale of pixels per unit is in a constant ratio. Both axes are still zoomable, but when you zoom one, the other will zoom the same amount, keeping a fixed midpoint. constrain and constraintoward determine how we enforce the constraint. You can chain these, ie yaxis: {scaleanchor: *x*}, xaxis2: {scaleanchor: *y*} but you can only link axes of the same type. The linked axis can have the opposite letter (to constrain the aspect ratio) or the same letter (to match scales across subplots). Loops (yaxis: {scaleanchor: *x*}, xaxis: {scaleanchor: *y*} or longer) are redundant and the last constraint encountered will be ignored to avoid possible inconsistent constraints via scaleratio. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Setting false allows to remove a default constraint (occasionally, you may need to prevent a default scaleanchor constraint from being applied, eg. when having an image trace yaxis: {scaleanchor: "x"} is set automatically in order for pixels to be rendered as squares, setting yaxis: {scaleanchor: false} allows to remove the constraint).
If this axis is linked to another by scaleanchor, this determines the pixel to unit scale ratio. For example, if this value is 10, then every unit on this axis spans 10 times the number of pixels as a unit on the linked axis. Use this for example to create an elevation profile where the vertical scale is exaggerated a fixed amount with respect to the horizontal.
If "true", even 4-digit integers are separated
Determines whether or not a dividers are drawn between the category levels of this axis. Only has an effect on multicategory axes.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not spikes (aka droplines) are drawn for this axis. Note: This only takes affect when hovermode = closest
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether a x (y) axis is positioned at the bottom (left) or top (right) of the plotting area.
Sets the spike color. If undefined, will use the series color
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the drawing mode for the spike line If toaxis, the line is drawn from the data point to the axis the series is plotted on. If across, the line is drawn across the entire plot area, and supercedes toaxis. If marker, then a marker dot is drawn on the axis the series is plotted on
Determines whether spikelines are stuck to the cursor or to the closest datapoints.
Sets the width (in px) of the zero line.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Only for axes with type date or linear. Instead of drawing the major tick label, draw the label for the minor tick that is n positions away from the major tick. E.g. to always draw the label for the minor tick before each major tick, choose ticklabelindex -1. This is useful for date axes with ticklabelmode period if you want to label the period that ends with each major tick instead of the period that begins there.
Sets the source reference on Chart Studio Cloud for ticklabelindex.
Determines where tick labels are drawn with respect to their corresponding ticks and grid lines. Only has an effect for axes of type date When set to period, tick labels are drawn in the middle of the period between ticks.
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. Otherwise on category and multicategory axes the default is allow. In other cases the default is hide past div.
Determines where tick labels are drawn with respect to the axis Please note that top or bottom has no effect on x axes or when ticklabelmode is set to period. Similarly left or right has no effect on y axes or when ticklabelmode is set to period. Has no effect on multicategory axes or when tickson is set to boundaries. When used on axes linked by matches or scaleanchor, no extra padding for inside labels would be added by autorange, so that the scales could match.
Shifts the tick labels by the specified number of pixels in parallel to the axis. Positive values move the labels in the positive direction of the axis.
Sets the standoff distance (in px) between the axis tick labels and their default position. A positive ticklabelstandoff moves the labels farther away from the plot area if ticklabelposition is outside, and deeper into the plot area if ticklabelposition is inside. A negative ticklabelstandoff works in the opposite direction, moving outside ticks towards the plot area and inside ticks towards the outside. If the negative value is large enough, inside ticks can even end up outside and vice versa.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided). If sync, the number of ticks will sync with the overlayed axis set by overlaying property.
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Determines where ticks and grid lines are drawn with respect to their corresponding tick labels. Only has an effect for axes of type category or multicategory. When set to boundaries, ticks and grid lines are drawn half a category to the left/bottom of labels.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Controls persistence of user-driven changes in axis range, autorange, and title if in editable: true configuration. Defaults to layout.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
91 nested properties
If set to an opposite-letter axis id (e.g. x2, y), this axis is bound to the corresponding opposite-letter axis. If set to free, this axis' position is determined by position.
Determines whether long tick labels automatically grow the figure margins.
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
Automatically reposition the axis to avoid overlap with other axes with the same overlaying value. This repositioning will account for any shift amount applied to other axes on the same side with autoshift is set to true. Only has an effect if anchor is set to free.
When tickangle is set to auto, it will be set to the first angle in this array that is large enough to prevent label overlap.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines how that happens: by increasing the range, or by decreasing the domain. Default is domain for axes containing image traces, range otherwise.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines which direction we push the originally specified plot area. Options are left, center (default), and right for x axes, and top, middle (default), and bottom for y axes.
Sets the color of the dividers Only has an effect on multicategory axes.
Sets the width (in px) of the dividers Only has an effect on multicategory axes.
Sets the domain of this axis (in plot fraction).
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Could be used to set the desired inside range of this axis (excluding the labels) when ticklabelposition of the anchored axis has inside. Not implemented for axes with type log. This would be ignored when range is provided.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
If set to another axis id (e.g. x2, y), the range of this axis will match the range of the corresponding axis in data-coordinates space. Moreover, matching axes share auto-range values, category lists and histogram auto-bins. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Moreover, note that matching axes must have the same type.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis, with traces and axes visible for both axes. If false, this axis does not overlay any same-letter axes. In this case, for axes with overlapping domains only the highest-numbered axis will be visible.
Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if anchor is set to free.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
If set to another axis id (e.g. x2, y), the range of this axis changes together with the range of the corresponding axis such that the scale of pixels per unit is in a constant ratio. Both axes are still zoomable, but when you zoom one, the other will zoom the same amount, keeping a fixed midpoint. constrain and constraintoward determine how we enforce the constraint. You can chain these, ie yaxis: {scaleanchor: *x*}, xaxis2: {scaleanchor: *y*} but you can only link axes of the same type. The linked axis can have the opposite letter (to constrain the aspect ratio) or the same letter (to match scales across subplots). Loops (yaxis: {scaleanchor: *x*}, xaxis: {scaleanchor: *y*} or longer) are redundant and the last constraint encountered will be ignored to avoid possible inconsistent constraints via scaleratio. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Setting false allows to remove a default constraint (occasionally, you may need to prevent a default scaleanchor constraint from being applied, eg. when having an image trace yaxis: {scaleanchor: "x"} is set automatically in order for pixels to be rendered as squares, setting yaxis: {scaleanchor: false} allows to remove the constraint).
If this axis is linked to another by scaleanchor, this determines the pixel to unit scale ratio. For example, if this value is 10, then every unit on this axis spans 10 times the number of pixels as a unit on the linked axis. Use this for example to create an elevation profile where the vertical scale is exaggerated a fixed amount with respect to the horizontal.
If "true", even 4-digit integers are separated
Moves the axis a given number of pixels from where it would have been otherwise. Accepts both positive and negative values, which will shift the axis either right or left, respectively. If autoshift is set to true, then this defaults to a padding of -3 if side is set to left. and defaults to +3 if side is set to right. Defaults to 0 if autoshift is set to false. Only has an effect if anchor is set to free.
Determines whether or not a dividers are drawn between the category levels of this axis. Only has an effect on multicategory axes.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not spikes (aka droplines) are drawn for this axis. Note: This only takes affect when hovermode = closest
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether a x (y) axis is positioned at the bottom (left) or top (right) of the plotting area.
Sets the spike color. If undefined, will use the series color
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the drawing mode for the spike line If toaxis, the line is drawn from the data point to the axis the series is plotted on. If across, the line is drawn across the entire plot area, and supercedes toaxis. If marker, then a marker dot is drawn on the axis the series is plotted on
Determines whether spikelines are stuck to the cursor or to the closest datapoints.
Sets the width (in px) of the zero line.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Only for axes with type date or linear. Instead of drawing the major tick label, draw the label for the minor tick that is n positions away from the major tick. E.g. to always draw the label for the minor tick before each major tick, choose ticklabelindex -1. This is useful for date axes with ticklabelmode period if you want to label the period that ends with each major tick instead of the period that begins there.
Sets the source reference on Chart Studio Cloud for ticklabelindex.
Determines where tick labels are drawn with respect to their corresponding ticks and grid lines. Only has an effect for axes of type date When set to period, tick labels are drawn in the middle of the period between ticks.
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. Otherwise on category and multicategory axes the default is allow. In other cases the default is hide past div.
Determines where tick labels are drawn with respect to the axis Please note that top or bottom has no effect on x axes or when ticklabelmode is set to period. Similarly left or right has no effect on y axes or when ticklabelmode is set to period. Has no effect on multicategory axes or when tickson is set to boundaries. When used on axes linked by matches or scaleanchor, no extra padding for inside labels would be added by autorange, so that the scales could match.
Shifts the tick labels by the specified number of pixels in parallel to the axis. Positive values move the labels in the positive direction of the axis.
Sets the standoff distance (in px) between the axis tick labels and their default position. A positive ticklabelstandoff moves the labels farther away from the plot area if ticklabelposition is outside, and deeper into the plot area if ticklabelposition is inside. A negative ticklabelstandoff works in the opposite direction, moving outside ticks towards the plot area and inside ticks towards the outside. If the negative value is large enough, inside ticks can even end up outside and vice versa.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided). If sync, the number of ticks will sync with the overlayed axis set by overlaying property.
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Determines where ticks and grid lines are drawn with respect to their corresponding tick labels. Only has an effect for axes of type category or multicategory. When set to boundaries, ticks and grid lines are drawn half a category to the left/bottom of labels.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Controls persistence of user-driven changes in axis range, autorange, and title if in editable: true configuration. Defaults to layout.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
Sets the rounding of bar corners. May be an integer number of pixels, or a percentage of bar width (as a string ending in %).
Sets the gap (in plot fraction) between bars of adjacent location coordinates.
Sets the gap (in plot fraction) between bars of the same location coordinate.
Determines how bars at the same location coordinate are displayed on the graph. With stack, the bars are stacked on top of one another With relative, the bars are stacked on top of one another, with negative values below the axis, positive values above With group, the bars are plotted next to one another centered around the shared location. With overlay, the bars are plotted over one another, you might need to reduce opacity to see multiple bars.
Sets the normalization for bar traces on the graph. With fraction, the value of each bar is divided by the sum of all values at that location coordinate. percent is the same but multiplied by 100 to show percentages.
Sets the gap (in plot fraction) between boxes of adjacent location coordinates. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between boxes of the same location coordinate. Has no effect on traces that have width set.
Determines how boxes at the same location coordinate are displayed on the graph. If group, the boxes are plotted next to one another centered around the shared location. If overlay, the boxes are plotted over one another, you might need to set opacity to see them multiple boxes. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between bars of adjacent location coordinates.
Sets the gap (in plot fraction) between bars of the same location coordinate.
Determines how bars at the same location coordinate are displayed on the graph. With stack, the bars are stacked on top of one another With group, the bars are plotted next to one another centered around the shared location. With overlay, the bars are plotted over one another, you might need to reduce opacity to see multiple bars.
If true, the funnelarea slice colors (whether given by funnelareacolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default funnelarea slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendfunnelareacolors.
hiddenlabels is the funnelarea & pie chart analog of visible:'legendonly' but it can contain many labels, and can simultaneously hide slices from several pies/funnelarea charts
Sets the source reference on Chart Studio Cloud for hiddenlabels.
If true, the icicle slice colors (whether given by iciclecolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default icicle slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendiciclecolors.
If true, the pie slice colors (whether given by piecolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default pie slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendpiecolors.
Sets the gap (in plot fraction) between scatter points of adjacent location coordinates. Defaults to bargap.
Determines how scatter points at the same location coordinate are displayed on the graph. With group, the scatter points are plotted next to one another centered around the shared location. With overlay, the scatter points are plotted over one another, you might need to reduce opacity to see multiple scatter points.
If true, the sunburst slice colors (whether given by sunburstcolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default sunburst slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendsunburstcolors.
If true, the treemap slice colors (whether given by treemapcolorway or inherited from colorway) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can set false to disable. Colors provided in the trace, using marker.colors, are never extended.
Sets the default treemap slice colors. Defaults to the main colorway used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, see extendtreemapcolors.
Sets the gap (in plot fraction) between violins of adjacent location coordinates. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between violins of the same location coordinate. Has no effect on traces that have width set.
Determines how violins at the same location coordinate are displayed on the graph. If group, the violins are plotted next to one another centered around the shared location. If overlay, the violins are plotted over one another, you might need to set opacity to see them multiple violins. Has no effect on traces that have width set.
Sets the gap (in plot fraction) between bars of adjacent location coordinates.
Sets the gap (in plot fraction) between bars of the same location coordinate.
Determines how bars at the same location coordinate are displayed on the graph. With group, the bars are plotted next to one another centered around the shared location. With overlay, the bars are plotted over one another, you might need to reduce opacity to see multiple bars.
Trace Columns enable you to reuse query elements as columns throughout multiple different areas within the trace. !!! tip
Using Trace Columns can help reduce copy and paste code!
Trace Columns perform the same basic service that the ?{} function does- allowing you to define sql select statements.
!!! example {% raw %}
=== "With Inline `?{}` Function"
``` yaml
- name: Simple Line
model: ref(test-table)
props:
type: bar
x: ?{ x }
y: ?{ y }
marker:
color: ?{ case when x >= 5 then '#713B57' else 'grey' end }
line:
color: ?{ case when x >= 5 then '#713B57' else 'grey' end }
pattern:
shape: ?{ case when x = 5 then '/' when x = 6 THEN 'x' else '' end }
line:
width: ?{ case when x in (5,6) then 2.5 else null end }
```
=== "With Trace Columns"
``` yaml
- name: Simple Line
model: ref(test-table)
columns:
x_data: ?{ x }
y_data: ?{ y }
color: ?{ case when x >= 5 then '#713B57' else 'grey' end }
shape: ?{ case when x = 5 then '/' when x = 6 THEN 'x' else '' end }
width: ?{ case when x in (5,6) then 2.5 else null end }
props:
type: bar
x: ${ columns.x_data }
y: ${ columns.y_data }
marker:
color: ${ columns.color }
line:
color: ${ columns.color }
pattern:
shape: ${ columns.shape }
line:
width: ${ columns.width }
```
{% endraw %}
Slicing & Indexing Column Arrays
Trace Columns support slicing and indexing, enabling you to pull out sub-arrays or specific values from a given column array.
Indexing
Some trace configurations require numbers or strings as inputs. For example indicator traces require a single number to represent as the
big value in the card. Since the ?{} and column() functions always return arrays, indexing allows you to grab a single value
from the array to use in configurations that require a single value.
You can index columns by using the following syntax:
column(column_name)[index]
The index is a zero-based index that represents the position in the array you want to pull out. Negative indexes are also supported,
allowing you to count from the end of the array. The last value in the array is represented by -1, the second to last by -2, and so on.
!!! example
A great example of a situation where you would want to use Column indexing are indicator traces.
``` yaml
- name: Indicator Trace
model: ref(csv)
columns:
x_data: ?{ x }
y_data: ?{ y }
props:
type: "indicator"
mode: "number+delta"
value: ?{ columns.y_data[0] }
number:
prefix: "$"
delta:
position: "top"
reference: ?{ columns.y_data[1] }
```
In the trace above `column(y_data)[0]` is pulling the first item in the array as the value and comparing its delta to the second item in the column y_data array.
Slicing
Slicing allows you to pull out a sub-array from a given column array. This is useful when you only want to use a portion of the array in a given configuration, but don't want to filter the whole trace.
You can slice columns by using the following syntax:
column(column_name)[start:stop]
The start and stop values are zero-based indexes that represent the start and end of the slice you want to pull out.
Negative indexes are also supported, allowing you to count from the end of the array. The last value in the array is represented
by -1, the second to last by -2, and so on.
If you omit the stop value, the slice will continue to the end of the array. If you omit the start value, the slice will start at the beginning of the array.
!!! example
Surface plots can be a really useful place to utilize slicing.
``` yaml
- name: Surface Trace
model: ${ ref(csv) }
columns:
x_data: ?{ x }
y_data: ?{ y }
props:
type: surface
z:
- ${ columns.x_data }
- ${ columns.x_data[0:5] }
- ${ columns.x_data[5:10] }
- ${ columns.y_data }
- ${ columns.y_data[0:5] }
- ${ columns.y_data[5:10] }
```
The trace above is creating a surface plot with lines on the plane of different lengths that represent different portions
of the x_data and y_data arrays.
A schema to validate plotly trace properties
Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently.
Sets where the bar base is drawn (in position axis units). In stack or relative barmode, traces that set base will be excluded and drawn in overlay mode instead.
Sets the source reference on Chart Studio Cloud for base.
Determines whether the text nodes are clipped about the subplot axes. To show the text nodes above axis lines and tick labels, make sure to set xaxis.layer and yaxis.layer to below traces.
Constrain the size of text inside or outside a bar to be no larger than the bar itself.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the x coordinate step. See x0 for more info.
Sets the y coordinate step. See y0 for more info.
15 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
14 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables value and label. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Determines if texts are kept at center or start/end points in textposition inside mode.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
17 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Sets the rounding of corners. May be an integer number of pixels, or a percentage of bar width (as a string ending in %). Defaults to layout.barcornerradius. In stack or relative barmode, the first trace to set cornerradius is used for the whole stack.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the opacity of the bars.
Sets the source reference on Chart Studio Cloud for opacity.
12 nested properties
When there is no colorscale sets the color of background pattern fill. Defaults to a marker.color background when fillmode is overlay. Otherwise, defaults to a transparent background.
Sets the source reference on Chart Studio Cloud for bgcolor.
When there is no colorscale sets the color of foreground pattern fill. Defaults to a marker.color background when fillmode is replace. Otherwise, defaults to dark grey or white to increase contrast with the bgcolor.
Sets the source reference on Chart Studio Cloud for fgcolor.
Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when fillmode is overlay. Otherwise, defaults to 1.
Determines whether marker.color should be used as a default to bgcolor or a fgcolor.
Sets the shape of the pattern fill. By default, no pattern is used for filling the area.
Sets the source reference on Chart Studio Cloud for shape.
Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.
Sets the source reference on Chart Studio Cloud for size.
Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.
Sets the source reference on Chart Studio Cloud for solidity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Shifts the position where the bar is drawn (in position axis units). In group barmode, traces that set offset will be excluded and drawn in overlay mode instead.
Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up.
Sets the source reference on Chart Studio Cloud for offset.
Sets the opacity of the trace.
Sets the orientation of the bars. With v (h), the value of the each bar spans along the vertical (horizontal).
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
2 nested properties
2 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the angle of the tick labels with respect to the bar. For example, a tickangle of -90 draws the tick labels vertically. With auto the texts may automatically be rotated to fit with the maximum size in bars.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Specifies the location of the text. inside positions text inside, next to the bar end (rotated and scaled if needed). outside positions text outside, next to the bar end (scaled if needed), unless there is another bar stacked on this one, then the text gets pushed inside. auto tries to position text inside the bar, but if the bar is too small and no bar is stacked on this one the text is moved outside. If none, no text appears.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables value and label.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
2 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the bar width (in position axis units).
Sets the source reference on Chart Studio Cloud for width.
Sets the x coordinates.
Alternate to x. Builds a linear space of x coordinates. Use with dx where x0 is the starting coordinate and dx the step.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
Sets the y coordinates.
Alternate to y. Builds a linear space of y coordinates. Use with dy where y0 is the starting coordinate and dy the step.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the y0 axis. When y0period is round number of weeks, the y0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the y axis.
Sets the source reference on Chart Studio Cloud for y.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
Sets where the bar base is drawn (in radial axis units). In stack barmode, traces that set base will be excluded and drawn in overlay mode instead.
Sets the source reference on Chart Studio Cloud for base.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the r coordinate step.
Sets the theta coordinate step. By default, the dtheta step equals the subplot's period divided by the length of the r coordinates.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
16 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the opacity of the bars.
Sets the source reference on Chart Studio Cloud for opacity.
12 nested properties
When there is no colorscale sets the color of background pattern fill. Defaults to a marker.color background when fillmode is overlay. Otherwise, defaults to a transparent background.
Sets the source reference on Chart Studio Cloud for bgcolor.
When there is no colorscale sets the color of foreground pattern fill. Defaults to a marker.color background when fillmode is replace. Otherwise, defaults to dark grey or white to increase contrast with the bgcolor.
Sets the source reference on Chart Studio Cloud for fgcolor.
Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when fillmode is overlay. Otherwise, defaults to 1.
Determines whether marker.color should be used as a default to bgcolor or a fgcolor.
Sets the shape of the pattern fill. By default, no pattern is used for filling the area.
Sets the source reference on Chart Studio Cloud for shape.
Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.
Sets the source reference on Chart Studio Cloud for size.
Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.
Sets the source reference on Chart Studio Cloud for solidity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Shifts the angular position where the bar is drawn (in thetatunit units).
Sets the source reference on Chart Studio Cloud for offset.
Sets the opacity of the trace.
Sets the radial coordinates
Alternate to r. Builds a linear space of r coordinates. Use with dr where r0 is the starting coordinate and dr the step.
Sets the source reference on Chart Studio Cloud for r.
2 nested properties
2 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets a reference between this trace's data coordinates and a polar subplot. If polar (the default value), the data refer to layout.polar. If polar2, the data refer to layout.polar2, and so on.
Sets hover text elements associated with each bar. If a single string, the same string appears over all bars. If an array of string, the items are mapped in order to the this trace's coordinates.
Sets the source reference on Chart Studio Cloud for text.
Sets the angular coordinates
Alternate to theta. Builds a linear space of theta coordinates. Use with dtheta where theta0 is the starting coordinate and dtheta the step.
Sets the source reference on Chart Studio Cloud for theta.
Sets the unit of input theta values. Has an effect only when on linear angular axes.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
2 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the bar angular width (in thetaunit units).
Sets the source reference on Chart Studio Cloud for width.
A schema to validate plotly trace properties
Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently.
If true, the mean of the box(es)' underlying distribution is drawn as a dashed line inside the box(es). If sd the standard deviation is also drawn. Defaults to true when mean is set. Defaults to sd when sd is set Otherwise defaults to false.
If outliers, only the sample points lying outside the whiskers are shown If suspectedoutliers, the outlier points are shown and points either less than 4Q1-3Q3 or greater than 4Q3-3Q1 are highlighted (see outliercolor) If all, all sample points are shown If false, only the box(es) are shown with no sample points Defaults to suspectedoutliers when marker.outliercolor or marker.line.outliercolor is set. Defaults to all under the q1/median/q3 signature. Otherwise defaults to outliers.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the x coordinate step for multi-box traces set using q1/median/q3.
Sets the y coordinate step for multi-box traces set using q1/median/q3.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Do the hover effects highlight individual boxes or sample points or both?
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the amount of jitter in the sample points drawn. If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the box(es).
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
2 nested properties
Sets the color of line bounding the box(es).
Sets the width (in px) of line bounding the box(es).
Sets the lower fence values. There should be as many items as the number of boxes desired. This attribute has effect only under the q1/median/q3 signature. If lowerfence is not provided but a sample (in y or x) is set, we compute the lower as the last sample point below 1.5 times the IQR.
Sets the source reference on Chart Studio Cloud for lowerfence.
7 nested properties
Sets the marker angle in respect to angleref.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
4 nested properties
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets the border line color of the outlier sample points. Defaults to marker.color
Sets the border line width (in px) of the outlier sample points.
Sets the width (in px) of the lines bounding the marker points.
Sets the marker opacity.
Sets the color of the outlier sample points.
Sets the marker size (in px).
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the mean values. There should be as many items as the number of boxes desired. This attribute has effect only under the q1/median/q3 signature. If mean is not provided but a sample (in y or x) is set, we compute the mean for each box using the sample values.
Sets the source reference on Chart Studio Cloud for mean.
Sets the median values. There should be as many items as the number of boxes desired.
Sets the source reference on Chart Studio Cloud for median.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover. For box traces, the name will also be used for the position coordinate, if x and x0 (y and y0 if horizontal) are missing and the position axis is categorical
Determines whether or not notches are drawn. Notches displays a confidence interval around the median. We compute the confidence interval as median +/- 1.57 * IQR / sqrt(N), where IQR is the interquartile range and N is the sample size. If two boxes' notches do not overlap there is 95% confidence their medians differ. See https://sites.google.com/site/davidsstatistics/home/notched-box-plots for more info. Defaults to false unless notchwidth or notchspan is set.
Sets the notch span from the boxes' median values. There should be as many items as the number of boxes desired. This attribute has effect only under the q1/median/q3 signature. If notchspan is not provided but a sample (in y or x) is set, we compute it as 1.57 * IQR / sqrt(N), where N is the sample size.
Sets the source reference on Chart Studio Cloud for notchspan.
Sets the width of the notches relative to the box' width. For example, with 0, the notches are as wide as the box(es).
Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up.
Sets the opacity of the trace.
Sets the orientation of the box(es). If v (h), the distribution is visualized along the vertical (horizontal).
Sets the position of the sample points in relation to the box(es). If 0, the sample points are places over the center of the box(es). Positive (negative) values correspond to positions to the right (left) for vertical boxes and above (below) for horizontal boxes
Sets the Quartile 1 values. There should be as many items as the number of boxes desired.
Sets the source reference on Chart Studio Cloud for q1.
Sets the Quartile 3 values. There should be as many items as the number of boxes desired.
Sets the source reference on Chart Studio Cloud for q3.
Sets the method used to compute the sample's Q1 and Q3 quartiles. The linear method uses the 25th percentile for Q1 and 75th percentile for Q3 as computed using method #10 (listed on http://jse.amstat.org/v14n3/langford.html). The exclusive method uses the median to divide the ordered dataset into two halves if the sample is odd, it does not include the median in either half - Q1 is then the median of the lower half and Q3 the median of the upper half. The inclusive method also uses the median to divide the ordered dataset into two halves but if the sample is odd, it includes the median in both halves - Q1 is then the median of the lower half and Q3 the median of the upper half.
Sets the standard deviation values. There should be as many items as the number of boxes desired. This attribute has effect only under the q1/median/q3 signature. If sd is not provided but a sample (in y or x) is set, we compute the standard deviation for each box using the sample values.
Scales the box size when sizemode=sd Allowing boxes to be drawn across any stddev range For example 1-stddev, 3-stddev, 5-stddev
Sets the source reference on Chart Studio Cloud for sd.
1 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not whiskers are visible. Defaults to true for sizemode quartiles, false for sd.
Sets the upper and lower bound for the boxes quartiles means box is drawn between Q1 and Q3 SD means the box is drawn between Mean +- Standard Deviation Argument sdmultiple (default 1) to scale the box size So it could be drawn 1-stddev, 3-stddev etc
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the text elements associated with each sample value. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
1 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
Sets the upper fence values. There should be as many items as the number of boxes desired. This attribute has effect only under the q1/median/q3 signature. If upperfence is not provided but a sample (in y or x) is set, we compute the upper as the last sample point above 1.5 times the IQR.
Sets the source reference on Chart Studio Cloud for upperfence.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the width of the whiskers relative to the box' width. For example, with 1, the whiskers are as wide as the box(es).
Sets the width of the box in data coordinate If 0 (default value) the width is automatically selected based on the positions of other box traces in the same subplot.
Sets the x sample data or coordinates. See overview for more info.
Sets the x coordinate for single-box traces or the starting coordinate for multi-box traces set using q1/median/q3. See overview for more info.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
Sets the y sample data or coordinates. See overview for more info.
Sets the y coordinate for single-box traces or the starting coordinate for multi-box traces set using q1/median/q3. See overview for more info.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the y0 axis. When y0period is round number of weeks, the y0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the y axis.
Sets the source reference on Chart Studio Cloud for y.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
Sets the close values.
Sets the source reference on Chart Studio Cloud for close.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
2 nested properties
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
2 nested properties
Sets the color of line bounding the box(es).
Sets the width (in px) of line bounding the box(es).
Sets the high values.
Sets the source reference on Chart Studio Cloud for high.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
10 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Show hover information (open, close, high, low) in separate labels.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
2 nested properties
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
2 nested properties
Sets the color of line bounding the box(es).
Sets the width (in px) of line bounding the box(es).
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
1 nested properties
Sets the width (in px) of line bounding the box(es). Note that this style setting can also be set per direction via increasing.line.width and decreasing.line.width.
Sets the low values.
Sets the source reference on Chart Studio Cloud for low.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
Sets the open values.
Sets the source reference on Chart Studio Cloud for open.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets hover text elements associated with each sample point. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to this trace's sample points.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the width of the whiskers relative to the box' width. For example, with 1, the whiskers are as wide as the box(es).
Sets the x coordinates. If absent, linear coordinate will be generated.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
An array containing values of the first parameter value
Alternate to a. Builds a linear space of a coordinates. Use with da where a0 is the starting coordinate and da the step.
57 nested properties
The stride between grid lines along the axis
The starting index of grid lines along the axis
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided, then autorange is set to false.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
The stride between grid lines along the axis
Determines whether or not a line is drawn at along the final value of this axis. If true, the end line is drawn on top of the grid lines.
Sets the line color of the end line.
Sets the width (in px) of the end line.
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the axis line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the axis line.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Extra padding between label and the axis
Sets a axis label prefix.
Sets a axis label suffix.
Sets the axis line color.
Sets the width (in px) of the axis line.
Hide SI prefix for 10^n if |n| is below this number
Sets the color of the grid lines.
Sets the number of minor grid ticks per major grid tick
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether axis labels are drawn on the low side, the high side, both, or neither side of the axis.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether or not a line is drawn at along the starting value of this axis. If true, the start line is drawn on top of the grid lines.
Sets the line color of the start line.
Sets the width (in px) of the start line.
The starting index of grid lines along the axis
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets a tick label prefix.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
3 nested properties
An additional amount by which to offset the title from the tick labels, given in pixels.
Sets the title of this axis.
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Sets the source reference on Chart Studio Cloud for a.
A two dimensional array of y coordinates at each carpet point.
Alternate to b. Builds a linear space of a coordinates. Use with db where b0 is the starting coordinate and db the step.
57 nested properties
The stride between grid lines along the axis
The starting index of grid lines along the axis
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided, then autorange is set to false.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
The stride between grid lines along the axis
Determines whether or not a line is drawn at along the final value of this axis. If true, the end line is drawn on top of the grid lines.
Sets the line color of the end line.
Sets the width (in px) of the end line.
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the axis line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the axis line.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Extra padding between label and the axis
Sets a axis label prefix.
Sets a axis label suffix.
Sets the axis line color.
Sets the width (in px) of the axis line.
Hide SI prefix for 10^n if |n| is below this number
Sets the color of the grid lines.
Sets the number of minor grid ticks per major grid tick
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether axis labels are drawn on the low side, the high side, both, or neither side of the axis.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether or not a line is drawn at along the starting value of this axis. If true, the start line is drawn on top of the grid lines.
Sets the line color of the start line.
Sets the width (in px) of the start line.
The starting index of grid lines along the axis
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets a tick label prefix.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
3 nested properties
An additional amount by which to offset the title from the tick labels, given in pixels.
Sets the title of this axis.
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Sets the source reference on Chart Studio Cloud for b.
An identifier for this carpet, so that scattercarpet and contourcarpet traces can specify a carpet plot on which they lie
The shift applied to each successive row of data in creating a cheater plot. Only used if x is been omitted.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the a coordinate step. See a0 for more info.
Sets the b coordinate step. See b0 for more info.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A two dimensional array of x coordinates at each carpet point. If omitted, the plot is a cheater plot and the xaxis is hidden by default.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the source reference on Chart Studio Cloud for x.
A two dimensional array of y coordinates at each carpet point.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the source reference on Chart Studio Cloud for y.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the key in GeoJSON features which is used as id to match the items included in the locations array. Only has an effect when geojson is set. Support nested property, for example properties.name.
Sets a reference between this trace's geospatial coordinates and a geographic map. If geo (the default value), the geospatial coordinates refer to layout.geo. If geo2, the geospatial coordinates refer to layout.geo2, and so on.
Sets optional GeoJSON data associated with this trace. If not given, the features on the base map are used. It can be set as a valid GeoJSON object or as a URL string. Note that we only accept GeoJSONs of type FeatureCollection or Feature with geometries of type Polygon or MultiPolygon.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Determines the set of locations used to match entries in locations to regions on the map. Values ISO-3, USA-states, country names correspond to features on the base map and value geojson-id corresponds to features from a custom GeoJSON linked to the geojson attribute.
Sets the coordinates via location IDs or names. See locationmode for more info.
Sets the source reference on Chart Studio Cloud for locations.
3 nested properties
4 nested properties
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the opacity of the locations.
Sets the source reference on Chart Studio Cloud for opacity.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
1 nested properties
1 nested properties
Sets the marker opacity of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the text elements associated with each location.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
1 nested properties
1 nested properties
Sets the marker opacity of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the color values.
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines if the choropleth polygons will be inserted before the layer with the specified ID. By default, choroplethmap traces are placed above the water layers. If set to '', the layer will be inserted above every existing layer.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the key in GeoJSON features which is used as id to match the items included in the locations array. Support nested property, for example properties.name.
Sets the GeoJSON data associated with this trace. It can be set as a valid GeoJSON object or as a URL string. Note that we only accept GeoJSONs of type FeatureCollection or Feature with geometries of type Polygon or MultiPolygon.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variable properties Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets which features found in geojson to plot using their feature id field.
Sets the source reference on Chart Studio Cloud for locations.
3 nested properties
4 nested properties
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the opacity of the locations.
Sets the source reference on Chart Studio Cloud for opacity.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
1 nested properties
1 nested properties
Sets the marker opacity of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets a reference between this trace's data coordinates and a map subplot. If map (the default value), the data refer to layout.map. If map2, the data refer to layout.map2, and so on.
Sets the text elements associated with each location.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
1 nested properties
1 nested properties
Sets the marker opacity of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the color values.
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines if the choropleth polygons will be inserted before the layer with the specified ID. By default, choroplethmapbox traces are placed above the water layers. If set to '', the layer will be inserted above every existing layer.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the key in GeoJSON features which is used as id to match the items included in the locations array. Support nested property, for example properties.name.
Sets the GeoJSON data associated with this trace. It can be set as a valid GeoJSON object or as a URL string. Note that we only accept GeoJSONs of type FeatureCollection or Feature with geometries of type Polygon or MultiPolygon.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variable properties Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets which features found in geojson to plot using their feature id field.
Sets the source reference on Chart Studio Cloud for locations.
3 nested properties
4 nested properties
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the opacity of the locations.
Sets the source reference on Chart Studio Cloud for opacity.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
1 nested properties
1 nested properties
Sets the marker opacity of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
mapbox subplots and traces are deprecated! Please consider switching to map subplots and traces. Learn more at: https://plotly.com/python/maplibre-migration/ as well as https://plotly.com/javascript/maplibre-migration/ Sets a reference between this trace's data coordinates and a mapbox subplot. If mapbox (the default value), the data refer to layout.mapbox. If mapbox2, the data refer to layout.mapbox2, and so on.
Sets the text elements associated with each location.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
1 nested properties
1 nested properties
Sets the marker opacity of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the color values.
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Sets the cones' anchor with respect to their x/y/z positions. Note that cm denote the cone's center of mass which corresponds to 1/4 from the tail to tip.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here u/v/w norm) or the bounds set in cmin and cmax Defaults to false when cmin and cmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as u/v/w norm and if set, cmin must be set as well.
Sets the mid-point of the color domain by scaling cmin and/or cmax to be equidistant to this point. Value should have the same units as u/v/w norm. Has no effect when cauto is false.
Sets the lower bound of the color domain. Value should have the same units as u/v/w norm and if set, cmax must be set as well.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use cmin and cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variable norm Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
7 nested properties
Ambient light increases overall color visibility but can wash out the image.
Represents the extent that incident rays are reflected in a range of angles.
Epsilon for face normals calculation avoids math issues arising from degenerate geometry.
Represents the reflectance as a dependency of the viewing angle; e.g. paper is reflective when viewing it from the edge of the paper (almost 90 degrees), causing shine.
Alters specular reflection; the rougher the surface, the wider and less contrasty the shine.
Represents the level that incident rays are reflected in a single direction, causing shine.
Epsilon for vertex normals calculation avoids math issues arising from degenerate geometry.
3 nested properties
Numeric vector, representing the X coordinate for each vertex.
Numeric vector, representing the Y coordinate for each vertex.
Numeric vector, representing the Z coordinate for each vertex.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the surface. Please note that in the case of using high opacity values for example a value greater than or equal to 0.5 on two surfaces (and 0.25 with four surfaces), an overlay of multiple transparent surfaces may not perfectly be sorted in depth by the webgl API. This behavior may be improved in the near future and is subject to change.
Reverses the color mapping if true. If true, cmin will correspond to the last color in the array and cmax will correspond to the first color.
Sets a reference between this trace's 3D coordinate system and a 3D scene. If scene (the default value), the (x,y,z) coordinates refer to layout.scene. If scene2, the (x,y,z) coordinates refer to layout.scene2, and so on.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
Determines whether sizeref is set as a scaled (i.e unitless) scalar (normalized by the max u/v/w norm in the vector field) or as absolute value (in the same units as the vector field). To display sizes in actual vector length use raw.
Adjusts the cone size scaling. The size of the cones is determined by their u/v/w norm multiplied a factor and sizeref. This factor (computed internally) corresponds to the minimum "time" to travel across two successive x/y/z positions at the average velocity of those two successive positions. All cones in a given trace use the same factor. With sizemode set to raw, its default value is 1. With sizemode set to scaled, sizeref is unitless, its default value is 0.5. With sizemode set to absolute, sizeref has the same units as the u/v/w vector field, its the default value is half the sample's maximum vector norm.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the text elements associated with the cones. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the source reference on Chart Studio Cloud for text.
Sets the x components of the vector field.
Sets the hover text formatting rulefor u using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the source reference on Chart Studio Cloud for u.
Sets the y components of the vector field.
Sets the hover text formatting rulefor v using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the source reference on Chart Studio Cloud for v.
Sets the z components of the vector field.
Sets the hover text formatting rulefor w using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Sets the source reference on Chart Studio Cloud for w.
Sets the x coordinates of the vector field and of the displayed cones.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the y coordinates of the vector field and of the displayed cones.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the z coordinates of the vector field and of the displayed cones.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using zaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the contour level attributes are picked by an algorithm. If true, the number of contour levels can be set in ncontours. If false, set the contour level attributes in contours.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Determines whether or not gaps (i.e. {nan} or missing values) in the z data are filled in. It is defaulted to true if z is a one dimensional array otherwise it is defaulted to false.
12 nested properties
Determines the coloring method showing the contour values. If fill, coloring is done evenly between each contour level If heatmap, a heatmap gradient coloring is applied between each contour level. If lines, coloring is done on the contour lines. If none, no coloring is applied on this trace.
Sets the end contour level value. Must be more than contours.start
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the contour label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.
Sets the constraint operation. = keeps regions equal to value < and <= keep regions less than value > and >= keep regions greater than value [], (), [), and (] keep regions inside value[0] to value[1] ][, )(, ](, )[ keep regions outside value[0] to value[1]` Open vs. closed intervals make no difference to constraint display, but all versions are allowed for consistency with filter transforms.
Determines whether to label the contour lines with their values.
Determines whether or not the contour lines are drawn. Has an effect only if contours.coloring is set to fill.
Sets the step between each contour level. Must be positive.
Sets the starting contour level value. Must be less than contours.end
If levels, the data is represented as a contour plot with multiple levels displayed. If constraint, the data is represented as constraints with the invalid region shaded as specified by the operation and value parameters.
Sets the value or values of the constraint boundary. When operation is set to one of the comparison values (=,<,>=,>,<=) value is expected to be a number. When operation is set to one of the interval values ([],(),[),(],],)(,[) value is expected to be an array of two numbers where the first is the lower bound and the second is the upper bound.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the x coordinate step. See x0 for more info.
Sets the y coordinate step. See y0 for more info.
Sets the fill color if contours.type is constraint. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Determines whether or not gaps (i.e. {nan} or missing values) in the z data have hover labels associated with them.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
4 nested properties
Sets the color of the contour level. Has no effect if contours.coloring is set to lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the amount of smoothing for the contour lines, where 0 corresponds to no smoothing.
Sets the contour line width in (in px) Defaults to 0.5 when contours.type is levels. Defaults to 2 when contour.type is constraint.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the maximum number of contour levels. The actual number of contours will be chosen automatically to be less than or equal to the value of ncontours. Has an effect only if autocontour is true or if contours.size is missing.
Sets the opacity of the trace.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the text elements associated with each z value.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for text.
For this trace it only has an effect if coloring is set to heatmap. Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables x, y, z and text.
Transposes the z data.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the x coordinates.
Alternate to x. Builds a linear space of x coordinates. Use with dx where x0 is the starting coordinate and dx the step.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
If array, the heatmap's x coordinates are given by x (the default behavior when x is provided). If scaled, the heatmap's x coordinates are given by x0 and dx (the default behavior when x is not provided).
Sets the y coordinates.
Alternate to y. Builds a linear space of y coordinates. Use with dy where y0 is the starting coordinate and dy the step.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the y0 axis. When y0period is round number of weeks, the y0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the y axis.
Sets the source reference on Chart Studio Cloud for y.
If array, the heatmap's y coordinates are given by y (the default behavior when y is provided) If scaled, the heatmap's y coordinates are given by y0 and dy (the default behavior when y is not provided)
Sets the z data.
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Sets the x coordinates.
Alternate to x. Builds a linear space of x coordinates. Use with dx where x0 is the starting coordinate and dx the step.
Sets the source reference on Chart Studio Cloud for a.
If array, the heatmap's x coordinates are given by x (the default behavior when x is provided). If scaled, the heatmap's x coordinates are given by x0 and dx (the default behavior when x is not provided).
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the contour level attributes are picked by an algorithm. If true, the number of contour levels can be set in ncontours. If false, set the contour level attributes in contours.
Sets the y coordinates.
Alternate to y. Builds a linear space of y coordinates. Use with dy where y0 is the starting coordinate and dy the step.
Sets the source reference on Chart Studio Cloud for b.
If array, the heatmap's y coordinates are given by y (the default behavior when y is provided) If scaled, the heatmap's y coordinates are given by y0 and dy (the default behavior when y is not provided)
The carpet of the carpet axes on which this contour trace lies
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
12 nested properties
Determines the coloring method showing the contour values. If fill, coloring is done evenly between each contour level If lines, coloring is done on the contour lines. If none, no coloring is applied on this trace.
Sets the end contour level value. Must be more than contours.start
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the contour label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.
Sets the constraint operation. = keeps regions equal to value < and <= keep regions less than value > and >= keep regions greater than value [], (), [), and (] keep regions inside value[0] to value[1] ][, )(, ](, )[ keep regions outside value[0] to value[1]` Open vs. closed intervals make no difference to constraint display, but all versions are allowed for consistency with filter transforms.
Determines whether to label the contour lines with their values.
Determines whether or not the contour lines are drawn. Has an effect only if contours.coloring is set to fill.
Sets the step between each contour level. Must be positive.
Sets the starting contour level value. Must be less than contours.end
If levels, the data is represented as a contour plot with multiple levels displayed. If constraint, the data is represented as constraints with the invalid region shaded as specified by the operation and value parameters.
Sets the value or values of the constraint boundary. When operation is set to one of the comparison values (=,<,>=,>,<=) value is expected to be a number. When operation is set to one of the interval values ([],(),[),(],],)(,[) value is expected to be an array of two numbers where the first is the lower bound and the second is the upper bound.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the x coordinate step. See x0 for more info.
Sets the y coordinate step. See y0 for more info.
Sets the fill color if contours.type is constraint. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
4 nested properties
Sets the color of the contour level. Has no effect if contours.coloring is set to lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the amount of smoothing for the contour lines, where 0 corresponds to no smoothing.
Sets the contour line width in (in px) Defaults to 0.5 when contours.type is levels. Defaults to 2 when contour.type is constraint.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the maximum number of contour levels. The actual number of contours will be chosen automatically to be less than or equal to the value of ncontours. Has an effect only if autocontour is true or if contours.size is missing.
Sets the opacity of the trace.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the text elements associated with each z value.
Sets the source reference on Chart Studio Cloud for text.
Transposes the z data.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the z data.
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines if the densitymap trace will be inserted before the layer with the specified ID. By default, densitymap traces are placed below the first layer of type symbol If set to '', the layer will be inserted above every existing layer.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (lon,lat) pair If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the latitude coordinates (in degrees North).
Sets the source reference on Chart Studio Cloud for lat.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets the longitude coordinates (in degrees East).
Sets the source reference on Chart Studio Cloud for lon.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
Sets the radius of influence of one lon / lat point in pixels. Increasing the value makes the densitymap trace smoother, but less detailed.
Sets the source reference on Chart Studio Cloud for radius.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets a reference between this trace's data coordinates and a map subplot. If map (the default value), the data refer to layout.map. If map2, the data refer to layout.map2, and so on.
Sets text elements associated with each (lon,lat) pair If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the points' weight. For example, a value of 10 would be equivalent to having 10 points of weight 1 in the same spot
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines if the densitymapbox trace will be inserted before the layer with the specified ID. By default, densitymapbox traces are placed below the first layer of type symbol If set to '', the layer will be inserted above every existing layer.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (lon,lat) pair If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the latitude coordinates (in degrees North).
Sets the source reference on Chart Studio Cloud for lat.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets the longitude coordinates (in degrees East).
Sets the source reference on Chart Studio Cloud for lon.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
Sets the radius of influence of one lon / lat point in pixels. Increasing the value makes the densitymapbox trace smoother, but less detailed.
Sets the source reference on Chart Studio Cloud for radius.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
mapbox subplots and traces are deprecated! Please consider switching to map subplots and traces. Learn more at: https://plotly.com/python/maplibre-migration/ as well as https://plotly.com/javascript/maplibre-migration/ Sets a reference between this trace's data coordinates and a mapbox subplot. If mapbox (the default value), the data refer to layout.mapbox. If mapbox2, the data refer to layout.mapbox2, and so on.
Sets text elements associated with each (lon,lat) pair If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the points' weight. For example, a value of 10 would be equivalent to having 10 points of weight 1 in the same spot
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently.
Determines whether the text nodes are clipped about the subplot axes. To show the text nodes above axis lines and tick labels, make sure to set xaxis.layer and yaxis.layer to below traces.
3 nested properties
Sets the fill color.
3 nested properties
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the line width (in px).
Determines if connector regions and lines are drawn.
Constrain the size of text inside or outside a bar to be no larger than the bar itself.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the x coordinate step. See x0 for more info.
Sets the y coordinate step. See y0 for more info.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables percentInitial, percentPrevious and percentTotal. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Determines if texts are kept at center or start/end points in textposition inside mode.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
15 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the opacity of the bars.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Shifts the position where the bar is drawn (in position axis units). In group barmode, traces that set offset will be excluded and drawn in overlay mode instead.
Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up.
Sets the opacity of the trace.
Sets the orientation of the funnels. With v (h), the value of the each bar spans along the vertical (horizontal). By default funnels are tend to be oriented horizontally; unless only y array is presented or orientation is set to v. Also regarding graphs including only 'horizontal' funnels, autorange on the y-axis are set to reversed.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the angle of the tick labels with respect to the bar. For example, a tickangle of -90 draws the tick labels vertically. With auto the texts may automatically be rotated to fit with the maximum size in bars.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Determines which trace information appear on the graph. In the case of having multiple funnels, percentages & totals are computed separately (per trace).
Specifies the location of the text. inside positions text inside, next to the bar end (rotated and scaled if needed). outside positions text outside, next to the bar end (scaled if needed), unless there is another bar stacked on this one, then the text gets pushed inside. auto tries to position text inside the bar, but if the bar is too small and no bar is stacked on this one the text is moved outside. If none, no text appears.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables percentInitial, percentPrevious, percentTotal, label and value.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the bar width (in position axis units).
Sets the x coordinates.
Alternate to x. Builds a linear space of x coordinates. Use with dx where x0 is the starting coordinate and dx the step.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
Sets the y coordinates.
Alternate to y. Builds a linear space of y coordinates. Use with dy where y0 is the starting coordinate and dy the step.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the y0 axis. When y0period is round number of weeks, the y0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the y axis.
Sets the source reference on Chart Studio Cloud for y.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
Sets the ratio between height and width
Sets the ratio between bottom length and maximum top length.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the label step. See label0 for more info.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this funnelarea trace .
If there is a layout grid, use the domain for this row in the grid for this funnelarea trace .
Sets the horizontal domain of this funnelarea trace (in plot fraction).
Sets the vertical domain of this funnelarea trace (in plot fraction).
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables label, color, value, text and percent. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each sector. If a single string, the same string appears for all data points. If an array of string, the items are mapped in order of this trace's sectors. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Alternate to labels. Builds a numeric set of labels. Use with dlabel where label0 is the starting label and dlabel the step.
Sets the sector labels. If labels entries are duplicated, we sum associated values or simply count occurrences if values is not provided. For other array attributes (including color) we use the first non-empty entry among all occurrences of the label.
Sets the source reference on Chart Studio Cloud for labels.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
4 nested properties
Sets the color of each sector. If not specified, the default trace color set is used to pick the sector colors.
Sets the source reference on Chart Studio Cloud for colors.
4 nested properties
Sets the color of the line enclosing each sector. Defaults to the paper_bgcolor value.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the line enclosing each sector.
Sets the source reference on Chart Studio Cloud for width.
12 nested properties
When there is no colorscale sets the color of background pattern fill. Defaults to a marker.color background when fillmode is overlay. Otherwise, defaults to a transparent background.
Sets the source reference on Chart Studio Cloud for bgcolor.
When there is no colorscale sets the color of foreground pattern fill. Defaults to a marker.color background when fillmode is replace. Otherwise, defaults to dark grey or white to increase contrast with the bgcolor.
Sets the source reference on Chart Studio Cloud for fgcolor.
Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when fillmode is overlay. Otherwise, defaults to 1.
Determines whether marker.color should be used as a default to bgcolor or a fgcolor.
Sets the shape of the pattern fill. By default, no pattern is used for filling the area.
Sets the source reference on Chart Studio Cloud for shape.
Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.
Sets the source reference on Chart Studio Cloud for size.
Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.
Sets the source reference on Chart Studio Cloud for solidity.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
If there are multiple funnelareas that should be sized according to their totals, link them by providing a non-empty group id here shared by every trace in the same group.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each sector. If trace textinfo contains a text flag, these elements will be seen on the chart. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Determines which trace information appear on the graph.
Specifies the location of the textinfo.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables label, color, value, text and percent.
Sets the source reference on Chart Studio Cloud for texttemplate.
3 nested properties
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Specifies the location of the title.
Sets the title of the chart. If it is empty, no title is displayed.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the values of the sectors. If omitted, we count occurrences of each label.
Sets the source reference on Chart Studio Cloud for values.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Determines whether or not gaps (i.e. {nan} or missing values) in the z data are filled in. It is defaulted to true if z is a one dimensional array and zsmooth is not false; otherwise it is defaulted to false.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the x coordinate step. See x0 for more info.
Sets the y coordinate step. See y0 for more info.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Determines whether or not gaps (i.e. {nan} or missing values) in the z data have hover labels associated with them.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the text elements associated with each z value.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables x, y, z and text.
Transposes the z data.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the x coordinates.
Alternate to x. Builds a linear space of x coordinates. Use with dx where x0 is the starting coordinate and dx the step.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the calendar system to use with x date data.
Sets the horizontal gap (in pixels) between bricks.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
If array, the heatmap's x coordinates are given by x (the default behavior when x is provided). If scaled, the heatmap's x coordinates are given by x0 and dx (the default behavior when x is not provided).
Sets the y coordinates.
Alternate to y. Builds a linear space of y coordinates. Use with dy where y0 is the starting coordinate and dy the step.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the calendar system to use with y date data.
Sets the vertical gap (in pixels) between bricks.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the y0 axis. When y0period is round number of weeks, the y0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the y axis.
Sets the source reference on Chart Studio Cloud for y.
If array, the heatmap's y coordinates are given by y (the default behavior when y is provided) If scaled, the heatmap's y coordinates are given by y0 and dy (the default behavior when y is not provided)
Sets the z data.
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
Picks a smoothing algorithm use to smooth z data.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently.
Obsolete: since v1.42 each bin attribute is auto-determined separately and autobinx is not needed. However, we accept autobinx: true or false and will update xbins accordingly before deleting autobinx from the trace.
Obsolete: since v1.42 each bin attribute is auto-determined separately and autobiny is not needed. However, we accept autobiny: true or false and will update ybins accordingly before deleting autobiny from the trace.
Set a group of histogram traces which will have compatible bin settings. Note that traces on the same subplot and with the same orientation under barmode stack, relative and group are forced into the same bingroup, Using bingroup, traces under barmode overlay and on different axes (of the same axis type) can have compatible bin settings. Note that histogram and histogram2d* trace can share the same bingroup
Determines whether the text nodes are clipped about the subplot axes. To show the text nodes above axis lines and tick labels, make sure to set xaxis.layer and yaxis.layer to below traces.
Constrain the size of text inside or outside a bar to be no larger than the bar itself.
3 nested properties
Only applies if cumulative is enabled. Sets whether the current bin is included, excluded, or has half of its value included in the current cumulative value. include is the default for compatibility with various other tools, however it introduces a half-bin bias to the results. exclude makes the opposite half-bin bias, and half removes it.
Only applies if cumulative is enabled. If increasing (default) we sum all prior bins, so the result increases from left to right. If decreasing we sum later bins so the result decreases from left to right.
If true, display the cumulative distribution by summing the binned values. Use the direction and centralbin attributes to tune the accumulation method. Note: in this mode, the density histnorm settings behave the same as their equivalents without density: ** and density both rise to the number of data points, and probability and probability density both rise to the number of sample points.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
15 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
14 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
Specifies the binning function used for this histogram trace. If count, the histogram values are computed by counting the number of values lying inside each bin. If sum, avg, min, max, the histogram values are computed using the sum, the average, the minimum or the maximum of the values lying inside each bin respectively.
Specifies the type of normalization used for this histogram trace. If **, the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If percent / probability, the span of each bar corresponds to the percentage / fraction of occurrences with respect to the total number of sample points (here, the sum of all bin HEIGHTS equals 100% / 1). If density, the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin AREAS equals the total number of sample points). If probability density, the area of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin AREAS equals 1).
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variable binNumber Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Determines if texts are kept at center or start/end points in textposition inside mode.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
17 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Sets the rounding of corners. May be an integer number of pixels, or a percentage of bar width (as a string ending in %). Defaults to layout.barcornerradius. In stack or relative barmode, the first trace to set cornerradius is used for the whole stack.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the opacity of the bars.
Sets the source reference on Chart Studio Cloud for opacity.
12 nested properties
When there is no colorscale sets the color of background pattern fill. Defaults to a marker.color background when fillmode is overlay. Otherwise, defaults to a transparent background.
Sets the source reference on Chart Studio Cloud for bgcolor.
When there is no colorscale sets the color of foreground pattern fill. Defaults to a marker.color background when fillmode is replace. Otherwise, defaults to dark grey or white to increase contrast with the bgcolor.
Sets the source reference on Chart Studio Cloud for fgcolor.
Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when fillmode is overlay. Otherwise, defaults to 1.
Determines whether marker.color should be used as a default to bgcolor or a fgcolor.
Sets the shape of the pattern fill. By default, no pattern is used for filling the area.
Sets the source reference on Chart Studio Cloud for shape.
Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.
Sets the source reference on Chart Studio Cloud for size.
Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.
Sets the source reference on Chart Studio Cloud for solidity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Specifies the maximum number of desired bins. This value will be used in an algorithm that will decide the optimal bin size such that the histogram best visualizes the distribution of the data. Ignored if xbins.size is provided.
Specifies the maximum number of desired bins. This value will be used in an algorithm that will decide the optimal bin size such that the histogram best visualizes the distribution of the data. Ignored if ybins.size is provided.
Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up.
Sets the opacity of the trace.
Sets the orientation of the bars. With v (h), the value of the each bar spans along the vertical (horizontal).
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
2 nested properties
2 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets hover text elements associated with each bar. If a single string, the same string appears over all bars. If an array of string, the items are mapped in order to the this trace's coordinates.
Sets the angle of the tick labels with respect to the bar. For example, a tickangle of -90 draws the tick labels vertically. With auto the texts may automatically be rotated to fit with the maximum size in bars.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Specifies the location of the text. inside positions text inside, next to the bar end (rotated and scaled if needed). outside positions text outside, next to the bar end (scaled if needed), unless there is another bar stacked on this one, then the text gets pushed inside. auto tries to position text inside the bar, but if the bar is too small and no bar is stacked on this one the text is moved outside. If none, no text appears.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables label and value.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
2 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the sample data to be binned on the x axis.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
3 nested properties
Sets the end value for the x axis bins. The last bin may not end exactly at this value, we increment the bin edge by size from start until we reach or exceed end. Defaults to the maximum data value. Like start, for dates use a date string, and for category data end is based on the category serial numbers.
Sets the size of each x axis bin. Default behavior: If nbinsx is 0 or omitted, we choose a nice round bin size such that the number of bins is about the same as the typical number of samples in each bin. If nbinsx is provided, we choose a nice round bin size giving no more than that many bins. For date data, use milliseconds or Maxis.dtick. For category data, the number of categories to bin together (always defaults to 1). If multiple non-overlaying histograms share a subplot, the first explicit size is used and all others discarded. If no size is provided,the sample data from all traces is combined to determine size as described above.
Sets the starting value for the x axis bins. Defaults to the minimum data value, shifted down if necessary to make nice round values and to remove ambiguous bin edges. For example, if most of the data is integers we shift the bin edges 0.5 down, so a size of 5 would have a default start of -0.5, so it is clear that 0-4 are in the first bin, 5-9 in the second, but continuous data gets a start of 0 and bins [0,5), [5,10) etc. Dates behave similarly, and start should be a date string. For category data, start is based on the category serial numbers, and defaults to -0.5. If multiple non-overlaying histograms share a subplot, the first explicit start is used exactly and all others are shifted down (if necessary) to differ from that one by an integer number of bins.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the sample data to be binned on the y axis.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
3 nested properties
Sets the end value for the y axis bins. The last bin may not end exactly at this value, we increment the bin edge by size from start until we reach or exceed end. Defaults to the maximum data value. Like start, for dates use a date string, and for category data end is based on the category serial numbers.
Sets the size of each y axis bin. Default behavior: If nbinsy is 0 or omitted, we choose a nice round bin size such that the number of bins is about the same as the typical number of samples in each bin. If nbinsy is provided, we choose a nice round bin size giving no more than that many bins. For date data, use milliseconds or Maxis.dtick. For category data, the number of categories to bin together (always defaults to 1). If multiple non-overlaying histograms share a subplot, the first explicit size is used and all others discarded. If no size is provided,the sample data from all traces is combined to determine size as described above.
Sets the starting value for the y axis bins. Defaults to the minimum data value, shifted down if necessary to make nice round values and to remove ambiguous bin edges. For example, if most of the data is integers we shift the bin edges 0.5 down, so a size of 5 would have a default start of -0.5, so it is clear that 0-4 are in the first bin, 5-9 in the second, but continuous data gets a start of 0 and bins [0,5), [5,10) etc. Dates behave similarly, and start should be a date string. For category data, start is based on the category serial numbers, and defaults to -0.5. If multiple non-overlaying histograms share a subplot, the first explicit start is used exactly and all others are shifted down (if necessary) to differ from that one by an integer number of bins.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
Obsolete: since v1.42 each bin attribute is auto-determined separately and autobinx is not needed. However, we accept autobinx: true or false and will update xbins accordingly before deleting autobinx from the trace.
Obsolete: since v1.42 each bin attribute is auto-determined separately and autobiny is not needed. However, we accept autobiny: true or false and will update ybins accordingly before deleting autobiny from the trace.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Set the xbingroup and ybingroup default prefix For example, setting a bingroup of 1 on two histogram2d traces will make them their x-bins and y-bins match separately.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Specifies the binning function used for this histogram trace. If count, the histogram values are computed by counting the number of values lying inside each bin. If sum, avg, min, max, the histogram values are computed using the sum, the average, the minimum or the maximum of the values lying inside each bin respectively.
Specifies the type of normalization used for this histogram trace. If **, the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If percent / probability, the span of each bar corresponds to the percentage / fraction of occurrences with respect to the total number of sample points (here, the sum of all bin HEIGHTS equals 100% / 1). If density, the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin AREAS equals the total number of sample points). If probability density, the area of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin AREAS equals 1).
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variable z Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
2 nested properties
Sets the aggregation data.
Sets the source reference on Chart Studio Cloud for color.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Specifies the maximum number of desired bins. This value will be used in an algorithm that will decide the optimal bin size such that the histogram best visualizes the distribution of the data. Ignored if xbins.size is provided.
Specifies the maximum number of desired bins. This value will be used in an algorithm that will decide the optimal bin size such that the histogram best visualizes the distribution of the data. Ignored if ybins.size is provided.
Sets the opacity of the trace.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variable z
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the sample data to be binned on the x axis.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Set a group of histogram traces which will have compatible x-bin settings. Using xbingroup, histogram2d and histogram2dcontour traces (on axes of the same axis type) can have compatible x-bin settings. Note that the same xbingroup value can be used to set (1D) histogram bingroup
3 nested properties
Sets the end value for the x axis bins. The last bin may not end exactly at this value, we increment the bin edge by size from start until we reach or exceed end. Defaults to the maximum data value. Like start, for dates use a date string, and for category data end is based on the category serial numbers.
Sets the size of each x axis bin. Default behavior: If nbinsx is 0 or omitted, we choose a nice round bin size such that the number of bins is about the same as the typical number of samples in each bin. If nbinsx is provided, we choose a nice round bin size giving no more than that many bins. For date data, use milliseconds or Maxis.dtick. For category data, the number of categories to bin together (always defaults to 1).
Sets the starting value for the x axis bins. Defaults to the minimum data value, shifted down if necessary to make nice round values and to remove ambiguous bin edges. For example, if most of the data is integers we shift the bin edges 0.5 down, so a size of 5 would have a default start of -0.5, so it is clear that 0-4 are in the first bin, 5-9 in the second, but continuous data gets a start of 0 and bins [0,5), [5,10) etc. Dates behave similarly, and start should be a date string. For category data, start is based on the category serial numbers, and defaults to -0.5.
Sets the calendar system to use with x date data.
Sets the horizontal gap (in pixels) between bricks.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the sample data to be binned on the y axis.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Set a group of histogram traces which will have compatible y-bin settings. Using ybingroup, histogram2d and histogram2dcontour traces (on axes of the same axis type) can have compatible y-bin settings. Note that the same ybingroup value can be used to set (1D) histogram bingroup
3 nested properties
Sets the end value for the y axis bins. The last bin may not end exactly at this value, we increment the bin edge by size from start until we reach or exceed end. Defaults to the maximum data value. Like start, for dates use a date string, and for category data end is based on the category serial numbers.
Sets the size of each y axis bin. Default behavior: If nbinsy is 0 or omitted, we choose a nice round bin size such that the number of bins is about the same as the typical number of samples in each bin. If nbinsy is provided, we choose a nice round bin size giving no more than that many bins. For date data, use milliseconds or Maxis.dtick. For category data, the number of categories to bin together (always defaults to 1).
Sets the starting value for the y axis bins. Defaults to the minimum data value, shifted down if necessary to make nice round values and to remove ambiguous bin edges. For example, if most of the data is integers we shift the bin edges 0.5 down, so a size of 5 would have a default start of -0.5, so it is clear that 0-4 are in the first bin, 5-9 in the second, but continuous data gets a start of 0 and bins [0,5), [5,10) etc. Dates behave similarly, and start should be a date string. For category data, start is based on the category serial numbers, and defaults to -0.5.
Sets the calendar system to use with y date data.
Sets the vertical gap (in pixels) between bricks.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the aggregation data.
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Picks a smoothing algorithm use to smooth z data.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Obsolete: since v1.42 each bin attribute is auto-determined separately and autobinx is not needed. However, we accept autobinx: true or false and will update xbins accordingly before deleting autobinx from the trace.
Obsolete: since v1.42 each bin attribute is auto-determined separately and autobiny is not needed. However, we accept autobiny: true or false and will update ybins accordingly before deleting autobiny from the trace.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the contour level attributes are picked by an algorithm. If true, the number of contour levels can be set in ncontours. If false, set the contour level attributes in contours.
Set the xbingroup and ybingroup default prefix For example, setting a bingroup of 1 on two histogram2d traces will make them their x-bins and y-bins match separately.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use zmin and zmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
12 nested properties
Determines the coloring method showing the contour values. If fill, coloring is done evenly between each contour level If heatmap, a heatmap gradient coloring is applied between each contour level. If lines, coloring is done on the contour lines. If none, no coloring is applied on this trace.
Sets the end contour level value. Must be more than contours.start
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the contour label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.
Sets the constraint operation. = keeps regions equal to value < and <= keep regions less than value > and >= keep regions greater than value [], (), [), and (] keep regions inside value[0] to value[1] ][, )(, ](, )[ keep regions outside value[0] to value[1]` Open vs. closed intervals make no difference to constraint display, but all versions are allowed for consistency with filter transforms.
Determines whether to label the contour lines with their values.
Determines whether or not the contour lines are drawn. Has an effect only if contours.coloring is set to fill.
Sets the step between each contour level. Must be positive.
Sets the starting contour level value. Must be less than contours.end
If levels, the data is represented as a contour plot with multiple levels displayed. If constraint, the data is represented as constraints with the invalid region shaded as specified by the operation and value parameters.
Sets the value or values of the constraint boundary. When operation is set to one of the comparison values (=,<,>=,>,<=) value is expected to be a number. When operation is set to one of the interval values ([],(),[),(],],)(,[) value is expected to be an array of two numbers where the first is the lower bound and the second is the upper bound.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Specifies the binning function used for this histogram trace. If count, the histogram values are computed by counting the number of values lying inside each bin. If sum, avg, min, max, the histogram values are computed using the sum, the average, the minimum or the maximum of the values lying inside each bin respectively.
Specifies the type of normalization used for this histogram trace. If **, the span of each bar corresponds to the number of occurrences (i.e. the number of data points lying inside the bins). If percent / probability, the span of each bar corresponds to the percentage / fraction of occurrences with respect to the total number of sample points (here, the sum of all bin HEIGHTS equals 100% / 1). If density, the span of each bar corresponds to the number of occurrences in a bin divided by the size of the bin interval (here, the sum of all bin AREAS equals the total number of sample points). If probability density, the area of each bar corresponds to the probability that an event will fall into the corresponding bin (here, the sum of all bin AREAS equals 1).
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variable z Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
4 nested properties
Sets the color of the contour level. Has no effect if contours.coloring is set to lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the amount of smoothing for the contour lines, where 0 corresponds to no smoothing.
Sets the contour line width in (in px)
2 nested properties
Sets the aggregation data.
Sets the source reference on Chart Studio Cloud for color.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Specifies the maximum number of desired bins. This value will be used in an algorithm that will decide the optimal bin size such that the histogram best visualizes the distribution of the data. Ignored if xbins.size is provided.
Specifies the maximum number of desired bins. This value will be used in an algorithm that will decide the optimal bin size such that the histogram best visualizes the distribution of the data. Ignored if ybins.size is provided.
Sets the maximum number of contour levels. The actual number of contours will be chosen automatically to be less than or equal to the value of ncontours. Has an effect only if autocontour is true or if contours.size is missing.
Sets the opacity of the trace.
Reverses the color mapping if true. If true, zmin will correspond to the last color in the array and zmax will correspond to the first color.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
For this trace it only has an effect if coloring is set to heatmap. Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables x, y, z and text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the sample data to be binned on the x axis.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Set a group of histogram traces which will have compatible x-bin settings. Using xbingroup, histogram2d and histogram2dcontour traces (on axes of the same axis type) can have compatible x-bin settings. Note that the same xbingroup value can be used to set (1D) histogram bingroup
3 nested properties
Sets the end value for the x axis bins. The last bin may not end exactly at this value, we increment the bin edge by size from start until we reach or exceed end. Defaults to the maximum data value. Like start, for dates use a date string, and for category data end is based on the category serial numbers.
Sets the size of each x axis bin. Default behavior: If nbinsx is 0 or omitted, we choose a nice round bin size such that the number of bins is about the same as the typical number of samples in each bin. If nbinsx is provided, we choose a nice round bin size giving no more than that many bins. For date data, use milliseconds or Maxis.dtick. For category data, the number of categories to bin together (always defaults to 1).
Sets the starting value for the x axis bins. Defaults to the minimum data value, shifted down if necessary to make nice round values and to remove ambiguous bin edges. For example, if most of the data is integers we shift the bin edges 0.5 down, so a size of 5 would have a default start of -0.5, so it is clear that 0-4 are in the first bin, 5-9 in the second, but continuous data gets a start of 0 and bins [0,5), [5,10) etc. Dates behave similarly, and start should be a date string. For category data, start is based on the category serial numbers, and defaults to -0.5.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the sample data to be binned on the y axis.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Set a group of histogram traces which will have compatible y-bin settings. Using ybingroup, histogram2d and histogram2dcontour traces (on axes of the same axis type) can have compatible y-bin settings. Note that the same ybingroup value can be used to set (1D) histogram bingroup
3 nested properties
Sets the end value for the y axis bins. The last bin may not end exactly at this value, we increment the bin edge by size from start until we reach or exceed end. Defaults to the maximum data value. Like start, for dates use a date string, and for category data end is based on the category serial numbers.
Sets the size of each y axis bin. Default behavior: If nbinsy is 0 or omitted, we choose a nice round bin size such that the number of bins is about the same as the typical number of samples in each bin. If nbinsy is provided, we choose a nice round bin size giving no more than that many bins. For date data, use milliseconds or Maxis.dtick. For category data, the number of categories to bin together (always defaults to 1).
Sets the starting value for the y axis bins. Defaults to the minimum data value, shifted down if necessary to make nice round values and to remove ambiguous bin edges. For example, if most of the data is integers we shift the bin edges 0.5 down, so a size of 5 would have a default start of -0.5, so it is clear that 0-4 are in the first bin, 5-9 in the second, but continuous data gets a start of 0 and bins [0,5), [5,10) etc. Dates behave similarly, and start should be a date string. For category data, start is based on the category serial numbers, and defaults to -0.5.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the aggregation data.
Determines whether or not the color domain is computed with respect to the input data (here in z) or the bounds set in zmin and zmax Defaults to false when zmin and zmax are set by the user.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Sets the upper bound of the color domain. Value should have the same units as in z and if set, zmin must be set as well.
Sets the mid-point of the color domain by scaling zmin and/or zmax to be equidistant to this point. Value should have the same units as in z. Has no effect when zauto is false.
Sets the lower bound of the color domain. Value should have the same units as in z and if set, zmax must be set as well.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Determines how the items in values are summed. When set to total, items in values are taken to be value of all its descendants. When set to remainder, items in values corresponding to the root and the branches sectors are taken to be the extra part not part of the sum of the values at their leaves.
Determines default for values when it is not provided, by inferring a 1 for each of the leaves and/or branches, otherwise 0.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this icicle trace .
If there is a layout grid, use the domain for this row in the grid for this icicle trace .
Sets the horizontal domain of this icicle trace (in plot fraction).
Sets the vertical domain of this icicle trace (in plot fraction).
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables currentPath, root, entry, percentRoot, percentEntry and percentParent. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each sector. If a single string, the same string appears for all data points. If an array of string, the items are mapped in order of this trace's sectors. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the labels of each of the sectors.
Sets the source reference on Chart Studio Cloud for labels.
1 nested properties
Sets the opacity of the leaves. With colorscale it is defaulted to 1; otherwise it is defaulted to 0.7
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets the level from which this trace hierarchy is rendered. Set level to '' to start from the root node in the hierarchy. Must be an "id" if ids is filled in, otherwise plotly attempts to find a matching item in labels.
14 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if colors is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here colors) or the bounds set in marker.cmin and marker.cmax Has an effect only if colors is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if colors is set to a numerical array. Value should have the same units as colors and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if colors is set to a numerical array. Value should have the same units as colors. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if colors is set to a numerical array. Value should have the same units as colors and if set, marker.cmax must be set as well.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the color of each sector of this trace. If not specified, the default trace color set is used to pick the sector colors.
Sets the colorscale. Has an effect only if colors is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for colors.
4 nested properties
Sets the color of the line enclosing each sector. Defaults to the paper_bgcolor value.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the line enclosing each sector.
Sets the source reference on Chart Studio Cloud for width.
12 nested properties
When there is no colorscale sets the color of background pattern fill. Defaults to a marker.color background when fillmode is overlay. Otherwise, defaults to a transparent background.
Sets the source reference on Chart Studio Cloud for bgcolor.
When there is no colorscale sets the color of foreground pattern fill. Defaults to a marker.color background when fillmode is replace. Otherwise, defaults to dark grey or white to increase contrast with the bgcolor.
Sets the source reference on Chart Studio Cloud for fgcolor.
Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when fillmode is overlay. Otherwise, defaults to 1.
Determines whether marker.color should be used as a default to bgcolor or a fgcolor.
Sets the shape of the pattern fill. By default, no pattern is used for filling the area.
Sets the source reference on Chart Studio Cloud for shape.
Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.
Sets the source reference on Chart Studio Cloud for size.
Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.
Sets the source reference on Chart Studio Cloud for solidity.
Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if colors is set to a numerical array.
Sets the number of rendered sectors from any given level. Set maxdepth to -1 to render all the levels in the hierarchy.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the parent sectors for each of the sectors. Empty string items '' are understood to reference the root node in the hierarchy. If ids is filled, parents items are understood to be "ids" themselves. When ids is not set, plotly attempts to find matching items in labels, but beware they must be unique.
Sets the source reference on Chart Studio Cloud for parents.
5 nested properties
Determines which shape is used for edges between barpath labels.
Determines on which side of the the treemap the pathbar should be presented.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the thickness of pathbar (in px). If not specified the pathbar.textfont.size is used with 3 pixles extra padding on each side.
Determines if the path bar is drawn i.e. outside the trace domain and with one pixel gap.
1 nested properties
sets the color of the root node for a sunburst/treemap/icicle trace. this has no effect when a colorscale is used to set the markers.
Determines whether or not the sectors are reordered from largest to smallest.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each sector. If trace textinfo contains a text flag, these elements will be seen on the chart. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Determines which trace information appear on the graph.
Sets the positions of the text elements.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables currentPath, root, entry, percentRoot, percentEntry, percentParent, label and value.
Sets the source reference on Chart Studio Cloud for texttemplate.
3 nested properties
Determines if the positions obtained from solver are flipped on each axis.
When set in conjunction with tiling.flip, determines on which side the root nodes are drawn in the chart. If tiling.orientation is v and tiling.flip is **, the root nodes appear at the top. If tiling.orientation is v and tiling.flip is y, the root nodes appear at the bottom. If tiling.orientation is h and tiling.flip is **, the root nodes appear at the left. If tiling.orientation is h and tiling.flip is x, the root nodes appear at the right.
Sets the inner padding (in px).
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the values associated with each of the sectors. Use with branchvalues to determine how the values are summed.
Sets the source reference on Chart Studio Cloud for values.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Color model used to map the numerical color components described in z into colors. If source is specified, this attribute will be set to rgba256 otherwise it defaults to rgb.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Set the pixel's horizontal size.
Set the pixel's vertical size
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables z, color and colormodel. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
Specifies the data URI of the image to be visualized. The URI consists of "data:image/[
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the text elements associated with each z value.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Set the image's x position. The left edge of the image (or the right edge if the x axis is reversed or dx is negative) will be found at xmin=x0-dx/2
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Set the image's y position. The top edge of the image (or the bottom edge if the y axis is NOT reversed or if dy is negative) will be found at ymin=y0-dy/2. By default when an image trace is included, the y axis will be reversed so that the image is right-side-up, but you can disable this by setting yaxis.autorange=true or by providing an explicit y axis range.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
A 2-dimensional array in which each element is an array of 3 or 4 numbers representing a color.
Array defining the higher bound for each color component. Note that the default value will depend on the colormodel. For the rgb colormodel, it is [255, 255, 255]. For the rgba colormodel, it is [255, 255, 255, 1]. For the rgba256 colormodel, it is [255, 255, 255, 255]. For the hsl colormodel, it is [360, 100, 100]. For the hsla colormodel, it is [360, 100, 100, 1].
Array defining the lower bound for each color component. Note that the default value will depend on the colormodel. For the rgb colormodel, it is [0, 0, 0]. For the rgba colormodel, it is [0, 0, 0, 0]. For the rgba256 colormodel, it is [0, 0, 0, 0]. For the hsl colormodel, it is [0, 0, 0]. For the hsla colormodel, it is [0, 0, 0, 0].
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
Picks a smoothing algorithm used to smooth z data. This only applies for image traces that use the source attribute.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Sets the horizontal alignment of the text within the box. Note that this attribute has no effect if an angular gauge is displayed: in this case, it is always centered
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
9 nested properties
2 nested properties
Sets the color for increasing value.
Sets the symbol to display for increasing value
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
2 nested properties
Sets the color for increasing value.
Sets the symbol to display for increasing value
Sets the position of delta with respect to the number.
Sets a prefix appearing before the delta.
Sets the reference value to compute the delta. By default, it is set to the current value.
Show relative change
Sets a suffix appearing next to the delta.
Sets the value formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this indicator trace .
If there is a layout grid, use the domain for this row in the grid for this indicator trace .
Sets the horizontal domain of this indicator trace (in plot fraction).
Sets the vertical domain of this indicator trace (in plot fraction).
8 nested properties
29 nested properties
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the range of this axis.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
3 nested properties
Sets the background color of the arc.
Sets the thickness of the bar as a fraction of the total thickness of the gauge.
Sets the gauge background color.
Sets the color of the border enclosing the gauge.
Sets the width (in px) of the border enclosing the gauge.
Set the shape of the gauge
3 nested properties
Sets the thickness of the threshold line as a fraction of the thickness of the gauge.
Sets a threshold value drawn as a line.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets the source reference on Chart Studio Cloud for meta.
Determines how the value is displayed on the graph. number displays the value numerically in text. delta displays the difference to a reference value in text. Finally, gauge displays the value graphically on an axis.
Sets the trace name. The trace name appears as the legend item and on hover.
4 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets a prefix appearing before the number.
Sets a suffix appearing next to the number.
Sets the value formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
3 nested properties
Sets the horizontal alignment of the title. It defaults to center except for bullet charts for which it defaults to right.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of this indicator.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the number to be displayed.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
3 nested properties
2 nested properties
Sets the fill ratio of the caps. The default fill value of the caps is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Sets the fill ratio of the slices. The default fill value of the x slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
2 nested properties
Sets the fill ratio of the caps. The default fill value of the caps is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Sets the fill ratio of the slices. The default fill value of the y slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
2 nested properties
Sets the fill ratio of the caps. The default fill value of the caps is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Sets the fill ratio of the slices. The default fill value of the z slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Determines whether or not the color domain is computed with respect to the input data (here value) or the bounds set in cmin and cmax Defaults to false when cmin and cmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as value and if set, cmin must be set as well.
Sets the mid-point of the color domain by scaling cmin and/or cmax to be equidistant to this point. Value should have the same units as value. Has no effect when cauto is false.
Sets the lower bound of the color domain. Value should have the same units as value and if set, cmax must be set as well.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use cmin and cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
3 nested properties
Sets the color of the contour lines.
Sets whether or not dynamic contours are shown on hover
Sets the width of the contour lines.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Determines whether or not normal smoothing is applied to the meshes, creating meshes with an angular, low-poly look via flat reflections.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the maximum boundary for iso-surface plot.
Sets the minimum boundary for iso-surface plot.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
7 nested properties
Ambient light increases overall color visibility but can wash out the image.
Represents the extent that incident rays are reflected in a range of angles.
Epsilon for face normals calculation avoids math issues arising from degenerate geometry.
Represents the reflectance as a dependency of the viewing angle; e.g. paper is reflective when viewing it from the edge of the paper (almost 90 degrees), causing shine.
Alters specular reflection; the rougher the surface, the wider and less contrasty the shine.
Represents the level that incident rays are reflected in a single direction, causing shine.
Epsilon for vertex normals calculation avoids math issues arising from degenerate geometry.
3 nested properties
Numeric vector, representing the X coordinate for each vertex.
Numeric vector, representing the Y coordinate for each vertex.
Numeric vector, representing the Z coordinate for each vertex.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the surface. Please note that in the case of using high opacity values for example a value greater than or equal to 0.5 on two surfaces (and 0.25 with four surfaces), an overlay of multiple transparent surfaces may not perfectly be sorted in depth by the webgl API. This behavior may be improved in the near future and is subject to change.
Reverses the color mapping if true. If true, cmin will correspond to the last color in the array and cmax will correspond to the first color.
Sets a reference between this trace's 3D coordinate system and a 3D scene. If scene (the default value), the (x,y,z) coordinates refer to layout.scene. If scene2, the (x,y,z) coordinates refer to layout.scene2, and so on.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
3 nested properties
4 nested properties
Sets the fill ratio of the slices. The default fill value of the slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Specifies the location(s) of slices on the axis. When not specified slices would be created for all points of the axis x except start and end.
Sets the source reference on Chart Studio Cloud for locations.
Determines whether or not slice planes about the x dimension are drawn.
4 nested properties
Sets the fill ratio of the slices. The default fill value of the slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Specifies the location(s) of slices on the axis. When not specified slices would be created for all points of the axis y except start and end.
Sets the source reference on Chart Studio Cloud for locations.
Determines whether or not slice planes about the y dimension are drawn.
4 nested properties
Sets the fill ratio of the slices. The default fill value of the slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Specifies the location(s) of slices on the axis. When not specified slices would be created for all points of the axis z except start and end.
Sets the source reference on Chart Studio Cloud for locations.
Determines whether or not slice planes about the z dimension are drawn.
2 nested properties
Sets the fill ratio of the spaceframe elements. The default fill value is 0.15 meaning that only 15% of the area of every faces of tetras would be shaded. Applying a greater fill ratio would allow the creation of stronger elements or could be sued to have entirely closed areas (in case of using 1).
Displays/hides tetrahedron shapes between minimum and maximum iso-values. Often useful when either caps or surfaces are disabled or filled with values less than 1.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
4 nested properties
Sets the number of iso-surfaces between minimum and maximum iso-values. By default this value is 2 meaning that only minimum and maximum surfaces would be drawn.
Sets the fill ratio of the iso-surface. The default fill value of the surface is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Sets the surface pattern of the iso-surface 3-D sections. The default pattern of the surface is all meaning that the rest of surface elements would be shaded. The check options (either 1 or 2) could be used to draw half of the squares on the surface. Using various combinations of capital A, B, C, D and E may also be used to reduce the number of triangles on the iso-surfaces and creating other patterns of interest.
Hides/displays surfaces between minimum and maximum iso-values.
Sets the text elements associated with the vertices. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the 4th dimension (value) of the vertices.
Sets the hover text formatting rulefor value using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Sets the source reference on Chart Studio Cloud for value.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the X coordinates of the vertices on X axis.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the Y coordinates of the vertices on Y axis.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the Z coordinates of the vertices on Z axis.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using zaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Determines how the mesh surface triangles are derived from the set of vertices (points) represented by the x, y and z arrays, if the i, j, k arrays are not supplied. For general use of mesh3d it is preferred that i, j, k are supplied. If -1, Delaunay triangulation is used, which is mainly suitable if the mesh is a single, more or less layer surface that is perpendicular to delaunayaxis. In case the delaunayaxis intersects the mesh surface at more than one point it will result triangles that are very long in the dimension of delaunayaxis. If >0, the alpha-shape algorithm is used. In this case, the positive alphahull value signals the use of the alpha-shape algorithm, and its value acts as the parameter for the mesh fitting. If 0, the convex-hull algorithm is used. It is suitable for convex bodies or if the intention is to enclose the x, y and z point set into a convex hull.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here intensity) or the bounds set in cmin and cmax Defaults to false when cmin and cmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as intensity and if set, cmin must be set as well.
Sets the mid-point of the color domain by scaling cmin and/or cmax to be equidistant to this point. Value should have the same units as intensity. Has no effect when cauto is false.
Sets the lower bound of the color domain. Value should have the same units as intensity and if set, cmax must be set as well.
Sets the color of the whole mesh
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use cmin and cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
3 nested properties
Sets the color of the contour lines.
Sets whether or not dynamic contours are shown on hover
Sets the width of the contour lines.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the Delaunay axis, which is the axis that is perpendicular to the surface of the Delaunay triangulation. It has an effect if i, j, k are not provided and alphahull is set to indicate Delaunay triangulation.
Sets the color of each face Overrides color and vertexcolor.
Sets the source reference on Chart Studio Cloud for facecolor.
Determines whether or not normal smoothing is applied to the meshes, creating meshes with an angular, low-poly look via flat reflections.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
A vector of vertex indices, i.e. integer values between 0 and the length of the vertex vectors, representing the first vertex of a triangle. For example, {i[m], j[m], k[m]} together represent face m (triangle m) in the mesh, where i[m] = n points to the triplet {x[n], y[n], z[n]} in the vertex arrays. Therefore, each element in i represents a point in space, which is the first vertex of a triangle.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the intensity values for vertices or cells as defined by intensitymode. It can be used for plotting fields on meshes.
Determines the source of intensity values.
Sets the source reference on Chart Studio Cloud for intensity.
Sets the source reference on Chart Studio Cloud for i.
A vector of vertex indices, i.e. integer values between 0 and the length of the vertex vectors, representing the second vertex of a triangle. For example, {i[m], j[m], k[m]} together represent face m (triangle m) in the mesh, where j[m] = n points to the triplet {x[n], y[n], z[n]} in the vertex arrays. Therefore, each element in j represents a point in space, which is the second vertex of a triangle.
Sets the source reference on Chart Studio Cloud for j.
A vector of vertex indices, i.e. integer values between 0 and the length of the vertex vectors, representing the third vertex of a triangle. For example, {i[m], j[m], k[m]} together represent face m (triangle m) in the mesh, where k[m] = n points to the triplet {x[n], y[n], z[n]} in the vertex arrays. Therefore, each element in k represents a point in space, which is the third vertex of a triangle.
Sets the source reference on Chart Studio Cloud for k.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
7 nested properties
Ambient light increases overall color visibility but can wash out the image.
Represents the extent that incident rays are reflected in a range of angles.
Epsilon for face normals calculation avoids math issues arising from degenerate geometry.
Represents the reflectance as a dependency of the viewing angle; e.g. paper is reflective when viewing it from the edge of the paper (almost 90 degrees), causing shine.
Alters specular reflection; the rougher the surface, the wider and less contrasty the shine.
Represents the level that incident rays are reflected in a single direction, causing shine.
Epsilon for vertex normals calculation avoids math issues arising from degenerate geometry.
3 nested properties
Numeric vector, representing the X coordinate for each vertex.
Numeric vector, representing the Y coordinate for each vertex.
Numeric vector, representing the Z coordinate for each vertex.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the surface. Please note that in the case of using high opacity values for example a value greater than or equal to 0.5 on two surfaces (and 0.25 with four surfaces), an overlay of multiple transparent surfaces may not perfectly be sorted in depth by the webgl API. This behavior may be improved in the near future and is subject to change.
Reverses the color mapping if true. If true, cmin will correspond to the last color in the array and cmax will correspond to the first color.
Sets a reference between this trace's 3D coordinate system and a 3D scene. If scene (the default value), the (x,y,z) coordinates refer to layout.scene. If scene2, the (x,y,z) coordinates refer to layout.scene2, and so on.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the text elements associated with the vertices. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the color of each vertex Overrides color. While Red, green and blue colors are in the range of 0 and 255; in the case of having vertex color data in RGBA format, the alpha color should be normalized to be between 0 and 1.
Sets the source reference on Chart Studio Cloud for vertexcolor.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the X coordinates of the vertices. The nth element of vectors x, y and z jointly represent the X, Y and Z coordinates of the nth vertex.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the Y coordinates of the vertices. The nth element of vectors x, y and z jointly represent the X, Y and Z coordinates of the nth vertex.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the Z coordinates of the vertices. The nth element of vectors x, y and z jointly represent the X, Y and Z coordinates of the nth vertex.
Sets the calendar system to use with z date data.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using zaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Sets the close values.
Sets the source reference on Chart Studio Cloud for close.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
1 nested properties
3 nested properties
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the line width (in px).
Sets the high values.
Sets the source reference on Chart Studio Cloud for high.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
10 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Show hover information (open, close, high, low) in separate labels.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
1 nested properties
3 nested properties
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the line width (in px).
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
2 nested properties
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px). Note that this style setting can also be set per direction via increasing.line.dash and decreasing.line.dash.
[object Object] Note that this style setting can also be set per direction via increasing.line.width and decreasing.line.width.
Sets the low values.
Sets the source reference on Chart Studio Cloud for low.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
Sets the open values.
Sets the source reference on Chart Studio Cloud for open.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets hover text elements associated with each sample point. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to this trace's sample points.
Sets the source reference on Chart Studio Cloud for text.
Sets the width of the open/close tick marks relative to the x minimal interval.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the x coordinates. If absent, linear coordinate will be generated.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
Sets the drag interaction mode for categories and dimensions. If perpendicular, the categories can only move along a line perpendicular to the paths. If freeform, the categories can freely move on the plane. If fixed, the categories and dimensions are stationary.
Sort paths so that like colors are bundled together within each category.
The number of observations represented by each state. Defaults to 1 so that each state represents one observation
Sets the source reference on Chart Studio Cloud for counts.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this parcats trace .
If there is a layout grid, use the domain for this row in the grid for this parcats trace .
Sets the horizontal domain of this parcats trace (in plot fraction).
Sets the vertical domain of this parcats trace (in plot fraction).
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the hover interaction mode for the parcats diagram. If category, hover interaction take place per category. If color, hover interactions take place per color per category. If dimension, hover interactions take place across all categories per dimension.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. This value here applies when hovering over dimensions. Note that *categorycount, colorcount and bandcolorcount are only available when hoveron contains the color flagFinally, the template string has access to variables count, probability, category, categorycount, colorcount and bandcolorcount. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the width (in px or fraction) of the legend for this trace.
14 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by line.colorscale. Has an effect only if in line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in line.color) or the bounds set in line.cmin and line.cmax Has an effect only if in line.color is set to a numerical array. Defaults to false when line.cmin and line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in line.color is set to a numerical array. Value should have the same units as in line.color and if set, line.cmin must be set as well.
Sets the mid-point of the color domain by scaling line.cmin and/or line.cmax to be equidistant to this point. Has an effect only if in line.color is set to a numerical array. Value should have the same units as in line.color. Has no effect when line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in line.color is set to a numerical array. Value should have the same units as in line.color and if set, line.cmax must be set as well.
Sets the line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to line.cmin and line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use line.cmin and line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. This value here applies when hovering over lines.Finally, the template string has access to variables count and probability. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Reverses the color mapping if true. Has an effect only if in line.color is set to a numerical array. If true, line.cmin will correspond to the last color in the array and line.cmax will correspond to the first color.
Sets the shape of the paths. If linear, paths are composed of straight lines. If hspline, paths are composed of horizontal curved splines
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in line.color is set to a numerical array.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the path sorting algorithm. If forward, sort paths based on dimension categories from left to right. If backward, sort paths based on dimensions categories from right to left.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this parcoords trace .
If there is a layout grid, use the domain for this row in the grid for this parcoords trace .
Sets the horizontal domain of this parcoords trace (in plot fraction).
Sets the vertical domain of this parcoords trace (in plot fraction).
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the angle of the labels with respect to the horizontal. For example, a tickangle of -90 draws the labels vertically. Tilted labels with labelangle may be positioned better inside margins when labelposition is set to bottom.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Specifies the location of the label. top positions labels above, next to the title bottom positions labels below the graph Tilted labels with labelangle may be positioned better inside margins when labelposition is set to bottom.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by line.colorscale. Has an effect only if in line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in line.color) or the bounds set in line.cmin and line.cmax Has an effect only if in line.color is set to a numerical array. Defaults to false when line.cmin and line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in line.color is set to a numerical array. Value should have the same units as in line.color and if set, line.cmin must be set as well.
Sets the mid-point of the color domain by scaling line.cmin and/or line.cmax to be equidistant to this point. Has an effect only if in line.color is set to a numerical array. Value should have the same units as in line.color. Has no effect when line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in line.color is set to a numerical array. Value should have the same units as in line.color and if set, line.cmax must be set as well.
Sets the line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to line.cmin and line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use line.cmin and line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in line.color is set to a numerical array. If true, line.cmin will correspond to the last color in the array and line.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in line.color is set to a numerical array.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
1 nested properties
2 nested properties
Sets the base color of unselected lines. in connection with unselected.line.opacity.
Sets the opacity of unselected lines. The default auto decreases the opacity smoothly as the number of lines increases. Use 1 to achieve exact unselected.line.color.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Determines whether outside text labels can push the margins.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Specifies the direction at which succeeding sectors follow one another.
Sets the label step. See label0 for more info.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this pie trace .
If there is a layout grid, use the domain for this row in the grid for this pie trace .
Sets the horizontal domain of this pie trace (in plot fraction).
Sets the vertical domain of this pie trace (in plot fraction).
Sets the fraction of the radius to cut out of the pie. Use this to make a donut chart.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables label, color, value, percent and text. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each sector. If a single string, the same string appears for all data points. If an array of string, the items are mapped in order of this trace's sectors. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Controls the orientation of the text inside chart sectors. When set to auto, text may be oriented in any direction in order to be as big as possible in the middle of a sector. The horizontal option orients text to be parallel with the bottom of the chart, and may make text smaller in order to achieve that goal. The radial option orients text along the radius of the sector. The tangential option orients text perpendicular to the radius of the sector.
Alternate to labels. Builds a numeric set of labels. Use with dlabel where label0 is the starting label and dlabel the step.
Sets the sector labels. If labels entries are duplicated, we sum associated values or simply count occurrences if values is not provided. For other array attributes (including color) we use the first non-empty entry among all occurrences of the label.
Sets the source reference on Chart Studio Cloud for labels.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
4 nested properties
Sets the color of each sector. If not specified, the default trace color set is used to pick the sector colors.
Sets the source reference on Chart Studio Cloud for colors.
4 nested properties
Sets the color of the line enclosing each sector.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the line enclosing each sector.
Sets the source reference on Chart Studio Cloud for width.
12 nested properties
When there is no colorscale sets the color of background pattern fill. Defaults to a marker.color background when fillmode is overlay. Otherwise, defaults to a transparent background.
Sets the source reference on Chart Studio Cloud for bgcolor.
When there is no colorscale sets the color of foreground pattern fill. Defaults to a marker.color background when fillmode is replace. Otherwise, defaults to dark grey or white to increase contrast with the bgcolor.
Sets the source reference on Chart Studio Cloud for fgcolor.
Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when fillmode is overlay. Otherwise, defaults to 1.
Determines whether marker.color should be used as a default to bgcolor or a fgcolor.
Sets the shape of the pattern fill. By default, no pattern is used for filling the area.
Sets the source reference on Chart Studio Cloud for shape.
Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.
Sets the source reference on Chart Studio Cloud for size.
Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.
Sets the source reference on Chart Studio Cloud for solidity.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the fraction of larger radius to pull the sectors out from the center. This can be a constant to pull all slices apart from each other equally or an array to highlight one or more slices.
Sets the source reference on Chart Studio Cloud for pull.
Instead of the first slice starting at 12 o'clock, rotate to some other angle.
If there are multiple pie charts that should be sized according to their totals, link them by providing a non-empty group id here shared by every trace in the same group.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not the sectors are reordered from largest to smallest.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each sector. If trace textinfo contains a text flag, these elements will be seen on the chart. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Determines which trace information appear on the graph.
Specifies the location of the textinfo.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables label, color, value, percent and text.
Sets the source reference on Chart Studio Cloud for texttemplate.
3 nested properties
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Specifies the location of the title.
Sets the title of the chart. If it is empty, no title is displayed.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the values of the sectors. If omitted, we count occurrences of each label.
Sets the source reference on Chart Studio Cloud for values.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
If value is snap (the default), the node arrangement is assisted by automatic snapping of elements to preserve space between nodes specified via nodepad. If value is perpendicular, the nodes can only move along a line perpendicular to the flow. If value is freeform, the nodes can freely move on the plane. If value is fixed, the nodes are stationary.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this sankey trace .
If there is a layout grid, use the domain for this row in the grid for this sankey trace .
Sets the horizontal domain of this sankey trace (in plot fraction).
Sets the vertical domain of this sankey trace (in plot fraction).
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired. Note that this attribute is superseded by node.hoverinfo and node.hoverinfo for nodes and links respectively.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
21 nested properties
Sets the length (in px) of the links arrow, if 0 no arrow will be drawn.
Sets the link color. It can be a single value, or an array for specifying color for each link. If link.color is omitted, then by default, a translucent grey link will be used.
Sets the source reference on Chart Studio Cloud for color.
Assigns extra data to each link.
Sets the source reference on Chart Studio Cloud for customdata.
Sets the link hover color. It can be a single value, or an array for specifying hover colors for each link. If link.hovercolor is omitted, then by default, links will become slightly more opaque when hovered over.
Sets the source reference on Chart Studio Cloud for hovercolor.
Determines which trace information appear when hovering links. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Variables source and target are node objects.Finally, the template string has access to variables value and label. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
The shown name of the link.
Sets the source reference on Chart Studio Cloud for label.
4 nested properties
Sets the color of the line around each link.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the line around each link.
Sets the source reference on Chart Studio Cloud for width.
An integer number [0..nodes.length - 1] that represents the source node.
Sets the source reference on Chart Studio Cloud for source.
An integer number [0..nodes.length - 1] that represents the target node.
Sets the source reference on Chart Studio Cloud for target.
A numeric value representing the flow volume value.
Sets the source reference on Chart Studio Cloud for value.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
19 nested properties
Sets the alignment method used to position the nodes along the horizontal axis.
Sets the node color. It can be a single value, or an array for specifying color for each node. If node.color is omitted, then the default Plotly color palette will be cycled through to have a variety of colors. These defaults are not fully opaque, to allow some visibility of what is beneath the node.
Sets the source reference on Chart Studio Cloud for color.
Assigns extra data to each node.
Sets the source reference on Chart Studio Cloud for customdata.
Groups of nodes. Each group is defined by an array with the indices of the nodes it contains. Multiple groups can be specified.
Determines which trace information appear when hovering nodes. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Variables sourceLinks and targetLinks are arrays of link objects.Finally, the template string has access to variables value and label. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
The shown name of the node.
Sets the source reference on Chart Studio Cloud for label.
4 nested properties
Sets the color of the line around each node.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the line around each node.
Sets the source reference on Chart Studio Cloud for width.
Sets the padding (in px) between the nodes.
Sets the thickness (in px) of the nodes.
The normalized horizontal position of the node.
Sets the source reference on Chart Studio Cloud for x.
The normalized vertical position of the node.
Sets the source reference on Chart Studio Cloud for y.
Sets the orientation of the Sankey diagram.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the value formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.
Adds a unit to follow the value in the hover tooltip. Add a space if a separation is necessary from the value.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently.
Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set xaxis.layer and yaxis.layer to below traces.
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the x coordinate step. See x0 for more info.
Sets the y coordinate step. See y0 for more info.
15 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
14 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
Sets the area to fill with a solid color. Defaults to none unless this trace is stacked, then it gets tonexty (tonextx) if orientation is v (h) Use with fillcolor if not none. tozerox and tozeroy fill to x=0 and y=0 respectively. tonextx and tonexty fill between the endpoints of this trace and the endpoints of the trace before it, connecting those endpoints with straight lines (to make a stacked area graph); if there is no trace before it, they behave like tozerox and tozeroy. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape. tonext fills the space between two traces if one completely encloses the other (eg consecutive contour lines), and behaves like toself if there is no trace before it. tonext should not be used if one trace does not enclose the other. Traces in a stackgroup will only fill to (or be filled to) other traces in the same group. With multiple stackgroups or some traces stacked and some not, if fill-linked traces are not already consecutive, the later ones will be pushed down in the drawing order.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available. If fillgradient is specified, fillcolor is ignored except for setting the background color of the hover label, if any.
4 nested properties
Sets the fill gradient colors as a color scale. The color scale is interpreted as a gradient applied in the direction specified by orientation, from the lowest to the highest value of the scatter plot along that axis, or from the center to the most distant point from it, if orientation is radial.
Sets the gradient start value. It is given as the absolute position on the axis determined by the orientation. E.g., if orientation is horizontal, the gradient will be horizontal and start from the x-position given by start. If omitted, the gradient starts at the lowest value of the trace along the respective axis. Ignored if orientation is radial.
Sets the gradient end value. It is given as the absolute position on the axis determined by the orientation. E.g., if orientation is horizontal, the gradient will be horizontal and end at the x-position given by end. If omitted, the gradient ends at the highest value of the trace along the respective axis. Ignored if orientation is radial.
Sets the type/orientation of the color gradient for the fill. Defaults to none.
12 nested properties
When there is no colorscale sets the color of background pattern fill. Defaults to a marker.color background when fillmode is overlay. Otherwise, defaults to a transparent background.
Sets the source reference on Chart Studio Cloud for bgcolor.
When there is no colorscale sets the color of foreground pattern fill. Defaults to a marker.color background when fillmode is replace. Otherwise, defaults to dark grey or white to increase contrast with the bgcolor.
Sets the source reference on Chart Studio Cloud for fgcolor.
Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when fillmode is overlay. Otherwise, defaults to 1.
Determines whether marker.color should be used as a default to bgcolor or a fgcolor.
Sets the shape of the pattern fill. By default, no pattern is used for filling the area.
Sets the source reference on Chart Studio Cloud for shape.
Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.
Sets the source reference on Chart Studio Cloud for size.
Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.
Sets the source reference on Chart Studio Cloud for solidity.
Only relevant when stackgroup is used, and only the first groupnorm found in the stackgroup will be used - including if visible is legendonly but not if it is false. Sets the normalization for the sum of this stackgroup. With fraction, the value of each trace at each location is divided by the sum of all trace values at that location. percent is the same but multiplied by 100 to show percentages. If there are multiple subplots, or multiple stackgroups on one subplot, each will be normalized within its own set.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Do the hover effects highlight individual points (markers or line points) or do they highlight filled regions? If the fill is toself or tonext and there are no markers or text, then the default is fills, otherwise it is points.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
8 nested properties
Sets the line back off from the end point of the nth line segment (in px). This option is useful e.g. to avoid overlap with arrowhead markers. With auto the lines would trim before markers if marker.angleref is set to previous.
Sets the source reference on Chart Studio Cloud for backoff.
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the line shape. With spline the lines are drawn using spline interpolation. The other available values correspond to step-wise line shapes.
Simplifies lines by removing nearly-collinear points. When transitioning lines, it may be desirable to disable this so that the number of points along the resulting SVG path is unaffected.
Has an effect only if shape is set to spline Sets the amount of smoothing. 0 corresponds to no smoothing (equivalent to a linear shape).
Sets the line width (in px).
29 nested properties
Sets the marker angle in respect to angleref.
Sets the reference for marker angle. With previous, angle 0 points along the line from the previous point to this one. With up, angle 0 points toward the top of the screen.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
4 nested properties
Sets the final color of the gradient fill: the center color for radial, the right for horizontal, or the bottom for vertical.
Sets the source reference on Chart Studio Cloud for color.
Sets the type of gradient used to fill the markers
Sets the source reference on Chart Studio Cloud for type.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets a maximum number of points to be drawn on the graph. 0 corresponds to no limit.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Moves the marker away from the data point in the direction of angle (in px). This can be useful for example if you have another marker at this location and you want to point an arrowhead marker at it.
Sets the source reference on Chart Studio Cloud for standoff.
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover. If there are less than 20 points and the trace is not stacked then the default is lines+markers. Otherwise, lines.
Sets the trace name. The trace name appears as the legend item and on hover.
Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up.
Sets the opacity of the trace.
Only relevant in the following cases: 1. when scattermode is set to group. 2. when stackgroup is used, and only the first orientation found in the stackgroup will be used - including if visible is legendonly but not if it is false. Sets the stacking direction. With v (h), the y (x) values of subsequent traces are added. Also affects the default value of fill.
2 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
Only relevant when stackgroup is used, and only the first stackgaps found in the stackgroup will be used - including if visible is legendonly but not if it is false. Determines how we handle locations at which other traces in this group have data but this one does not. With infer zero we insert a zero at these locations. With interpolate we linearly interpolate between existing values, and extrapolate a constant beyond the existing values.
Set several scatter traces (on the same subplot) to the same stackgroup in order to add their y values (or their x values if orientation is h). If blank or omitted this trace will not be stacked. Stacking also turns fill on by default, using tonexty (tonextx) if orientation is h (v) and sets the default mode to lines irrespective of point count. You can only stack on a numeric (linear or log) axis. Traces in a stackgroup will only fill to (or be filled to) other traces in the same group. With multiple stackgroups or some traces stacked and some not, if fill-linked traces are not already consecutive, the later ones will be pushed down in the drawing order.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the x coordinates.
Alternate to x. Builds a linear space of x coordinates. Use with dx where x0 is the starting coordinate and dx the step.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
Sets the y coordinates.
Alternate to y. Builds a linear space of y coordinates. Use with dy where y0 is the starting coordinate and dy the step.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the y0 axis. When y0period is round number of weeks, the y0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the y axis.
Sets the source reference on Chart Studio Cloud for y.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
15 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
15 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
14 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets text elements associated with each (x,y,z) triplet. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y,z) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
14 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by line.colorscale. Has an effect only if in line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in line.color) or the bounds set in line.cmin and line.cmax Has an effect only if in line.color is set to a numerical array. Defaults to false when line.cmin and line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in line.color is set to a numerical array. Value should have the same units as in line.color and if set, line.cmin must be set as well.
Sets the mid-point of the color domain by scaling line.cmin and/or line.cmax to be equidistant to this point. Has an effect only if in line.color is set to a numerical array. Value should have the same units as in line.color. Has no effect when line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in line.color is set to a numerical array. Value should have the same units as in line.color and if set, line.cmax must be set as well.
Sets the line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to line.cmin and line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use line.cmin and line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Sets the dash style of the lines.
Reverses the color mapping if true. Has an effect only if in line.color is set to a numerical array. If true, line.cmin will correspond to the last color in the array and line.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in line.color is set to a numerical array.
Sets the line width (in px).
21 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
11 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the marker opacity. Note that the marker opacity for scatter3d traces must be a scalar value for performance reasons. To set a blending opacity value (i.e. which is not transparent), set marker.color to an rgba color and use its alpha channel.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Sets the marker symbol type.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover. If there are less than 20 points and the trace is not stacked then the default is lines+markers. Otherwise, lines.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
3 nested properties
3 nested properties
Sets the projection color.
Sets the scale factor determining the size of the projection marker points.
Sets whether or not projections are shown along the x axis.
3 nested properties
Sets the projection color.
Sets the scale factor determining the size of the projection marker points.
Sets whether or not projections are shown along the y axis.
3 nested properties
Sets the projection color.
Sets the scale factor determining the size of the projection marker points.
Sets whether or not projections are shown along the z axis.
Sets a reference between this trace's 3D coordinate system and a 3D scene. If scene (the default value), the (x,y,z) coordinates refer to layout.scene. If scene2, the (x,y,z) coordinates refer to layout.scene2, and so on.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
If -1, the scatter points are not fill with a surface If 0, 1, 2, the scatter points are filled with a Delaunay surface about the x, y, z respectively.
Sets the surface fill color.
Sets text elements associated with each (x,y,z) triplet. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y,z) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
12 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the x coordinates.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the y coordinates.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the z coordinates.
Sets the calendar system to use with z date data.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using zaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Sets the a-axis coordinates.
Sets the source reference on Chart Studio Cloud for a.
Sets the b-axis coordinates.
Sets the source reference on Chart Studio Cloud for b.
An identifier for this carpet, so that scattercarpet and contourcarpet traces can specify a carpet plot on which they lie
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the area to fill with a solid color. Use with fillcolor if not none. scatterternary has a subset of the options available to scatter. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape. tonext fills the space between two traces if one completely encloses the other (eg consecutive contour lines), and behaves like toself if there is no trace before it. tonext should not be used if one trace does not enclose the other.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Do the hover effects highlight individual points (markers or line points) or do they highlight filled regions? If the fill is toself or tonext and there are no markers or text, then the default is fills, otherwise it is points.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (a,b) point. If a single string, the same string appears over all the data points. If an array of strings, the items are mapped in order to the the data points in (a,b). To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
7 nested properties
Sets the line back off from the end point of the nth line segment (in px). This option is useful e.g. to avoid overlap with arrowhead markers. With auto the lines would trim before markers if marker.angleref is set to previous.
Sets the source reference on Chart Studio Cloud for backoff.
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the line shape. With spline the lines are drawn using spline interpolation. The other available values correspond to step-wise line shapes.
Has an effect only if shape is set to spline Sets the amount of smoothing. 0 corresponds to no smoothing (equivalent to a linear shape).
Sets the line width (in px).
29 nested properties
Sets the marker angle in respect to angleref.
Sets the reference for marker angle. With previous, angle 0 points along the line from the previous point to this one. With up, angle 0 points toward the top of the screen.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
4 nested properties
Sets the final color of the gradient fill: the center color for radial, the right for horizontal, or the bottom for vertical.
Sets the source reference on Chart Studio Cloud for color.
Sets the type of gradient used to fill the markers
Sets the source reference on Chart Studio Cloud for type.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets a maximum number of points to be drawn on the graph. 0 corresponds to no limit.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Moves the marker away from the data point in the direction of angle (in px). This can be useful for example if you have another marker at this location and you want to point an arrowhead marker at it.
Sets the source reference on Chart Studio Cloud for standoff.
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover. If there are less than 20 points and the trace is not stacked then the default is lines+markers. Otherwise, lines.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
2 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each (a,b) point. If a single string, the same string appears over all the data points. If an array of strings, the items are mapped in order to the the data points in (a,b). If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables a, b and text.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the key in GeoJSON features which is used as id to match the items included in the locations array. Only has an effect when geojson is set. Support nested property, for example properties.name.
Sets the area to fill with a solid color. Use with fillcolor if not none. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Sets a reference between this trace's geospatial coordinates and a geographic map. If geo (the default value), the geospatial coordinates refer to layout.geo. If geo2, the geospatial coordinates refer to layout.geo2, and so on.
Sets optional GeoJSON data associated with this trace. If not given, the features on the base map are used when locations is set. It can be set as a valid GeoJSON object or as a URL string. Note that we only accept GeoJSONs of type FeatureCollection or Feature with geometries of type Polygon or MultiPolygon.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (lon,lat) pair or item in locations. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) or locations coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the latitude coordinates (in degrees North).
Sets the source reference on Chart Studio Cloud for lat.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
3 nested properties
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the line width (in px).
Determines the set of locations used to match entries in locations to regions on the map. Values ISO-3, USA-states, country names correspond to features on the base map and value geojson-id corresponds to features from a custom GeoJSON linked to the geojson attribute.
Sets the coordinates via location IDs or names. Coordinates correspond to the centroid of each location given. See locationmode for more info.
Sets the source reference on Chart Studio Cloud for locations.
Sets the longitude coordinates (in degrees East).
Sets the source reference on Chart Studio Cloud for lon.
28 nested properties
Sets the marker angle in respect to angleref.
Sets the reference for marker angle. With previous, angle 0 points along the line from the previous point to this one. With up, angle 0 points toward the top of the screen. With north, angle 0 points north based on the current map projection.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
4 nested properties
Sets the final color of the gradient fill: the center color for radial, the right for horizontal, or the bottom for vertical.
Sets the source reference on Chart Studio Cloud for color.
Sets the type of gradient used to fill the markers
Sets the source reference on Chart Studio Cloud for type.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Moves the marker away from the data point in the direction of angle (in px). This can be useful for example if you have another marker at this location and you want to point an arrowhead marker at it.
Sets the source reference on Chart Studio Cloud for standoff.
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover. If there are less than 20 points and the trace is not stacked then the default is lines+markers. Otherwise, lines.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
2 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each (lon,lat) pair or item in locations. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) or locations coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables lat, lon, location and text.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the x coordinate step. See x0 for more info.
Sets the y coordinate step. See y0 for more info.
15 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
14 nested properties
Sets the data corresponding the length of each error bar. Values are plotted relative to the underlying data.
Sets the data corresponding the length of each error bar in the bottom (left) direction for vertical (horizontal) bars Values are plotted relative to the underlying data.
Sets the source reference on Chart Studio Cloud for arrayminus.
Sets the source reference on Chart Studio Cloud for array.
Sets the stroke color of the error bars.
Determines whether or not the error bars have the same length in both direction (top/bottom for vertical bars, left/right for horizontal bars.
Sets the thickness (in px) of the error bars.
Determines the rule used to generate the error bars. If *constant, the bar lengths are of a constant value. Set this constant in value. If *percent*, the bar lengths correspond to a percentage of underlying data. Set this percentage in value. If *sqrt*, the bar lengths correspond to the square of the underlying data. If *data*, the bar lengths are set with data set array`.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars.
Sets the value of either the percentage (if type is set to percent) or the constant (if type is set to constant) corresponding to the lengths of the error bars in the bottom (left) direction for vertical (horizontal) bars
Determines whether or not this set of error bars is visible.
Sets the width (in px) of the cross-bar at both ends of the error bars.
Sets the area to fill with a solid color. Defaults to none unless this trace is stacked, then it gets tonexty (tonextx) if orientation is v (h) Use with fillcolor if not none. tozerox and tozeroy fill to x=0 and y=0 respectively. tonextx and tonexty fill between the endpoints of this trace and the endpoints of the trace before it, connecting those endpoints with straight lines (to make a stacked area graph); if there is no trace before it, they behave like tozerox and tozeroy. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape. tonext fills the space between two traces if one completely encloses the other (eg consecutive contour lines), and behaves like toself if there is no trace before it. tonext should not be used if one trace does not enclose the other. Traces in a stackgroup will only fill to (or be filled to) other traces in the same group. With multiple stackgroups or some traces stacked and some not, if fill-linked traces are not already consecutive, the later ones will be pushed down in the drawing order.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
4 nested properties
Sets the line color.
Sets the style of the lines.
Determines the line shape. The values correspond to step-wise line shapes.
Sets the line width (in px).
24 nested properties
Sets the marker angle in respect to angleref.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
2 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
12 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the x coordinates.
Alternate to x. Builds a linear space of x coordinates. Use with dx where x0 is the starting coordinate and dx the step.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
Sets the y coordinates.
Alternate to y. Builds a linear space of y coordinates. Use with dy where y0 is the starting coordinate and dy the step.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the y0 axis. When y0period is round number of weeks, the y0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the y axis.
Sets the source reference on Chart Studio Cloud for y.
A schema to validate plotly trace properties
Determines if this scattermap trace's layers are to be inserted before the layer with the specified ID. By default, scattermap layers are inserted above all the base layers. To place the scattermap layers above every other layer, set below to ''.
10 nested properties
Sets the color for each cluster step.
Sets the source reference on Chart Studio Cloud for color.
Determines whether clustering is enabled or disabled.
Sets the maximum zoom level. At zoom levels equal to or greater than this, points will never be clustered.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Sets the size for each cluster step.
Sets the source reference on Chart Studio Cloud for size.
Sets how many points it takes to create a cluster or advance to the next cluster step. Use this in conjunction with arrays for size and / or color. If an integer, steps start at multiples of this number. If an array, each step extends from the given value until one less than the next value.
Sets the source reference on Chart Studio Cloud for step.
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the area to fill with a solid color. Use with fillcolor if not none. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (lon,lat) pair If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the latitude coordinates (in degrees North).
Sets the source reference on Chart Studio Cloud for lat.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
2 nested properties
Sets the line color.
Sets the line width (in px).
Sets the longitude coordinates (in degrees East).
Sets the source reference on Chart Studio Cloud for lon.
24 nested properties
Flag to draw all symbols, even if they overlap.
Sets the marker orientation from true North, in degrees clockwise. When using the auto default, no rotation would be applied in perspective views which is different from using a zero angle.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Sets the marker symbol. Full list: https://www.map.com/maki-icons/ Note that the array marker.color and marker.size are only available for circle symbols.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
1 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets a reference between this trace's data coordinates and a map subplot. If map (the default value), the data refer to layout.map. If map2, the data refer to layout.map2, and so on.
Sets text elements associated with each (lon,lat) pair If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
5 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the weight (or boldness) of the font.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables lat, lon and text.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
1 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Determines if this scattermapbox trace's layers are to be inserted before the layer with the specified ID. By default, scattermapbox layers are inserted above all the base layers. To place the scattermapbox layers above every other layer, set below to ''.
10 nested properties
Sets the color for each cluster step.
Sets the source reference on Chart Studio Cloud for color.
Determines whether clustering is enabled or disabled.
Sets the maximum zoom level. At zoom levels equal to or greater than this, points will never be clustered.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Sets the size for each cluster step.
Sets the source reference on Chart Studio Cloud for size.
Sets how many points it takes to create a cluster or advance to the next cluster step. Use this in conjunction with arrays for size and / or color. If an integer, steps start at multiples of this number. If an array, each step extends from the given value until one less than the next value.
Sets the source reference on Chart Studio Cloud for step.
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the area to fill with a solid color. Use with fillcolor if not none. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (lon,lat) pair If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the latitude coordinates (in degrees North).
Sets the source reference on Chart Studio Cloud for lat.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
2 nested properties
Sets the line color.
Sets the line width (in px).
Sets the longitude coordinates (in degrees East).
Sets the source reference on Chart Studio Cloud for lon.
24 nested properties
Flag to draw all symbols, even if they overlap.
Sets the marker orientation from true North, in degrees clockwise. When using the auto default, no rotation would be applied in perspective views which is different from using a zero angle.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Sets the marker symbol. Full list: https://www.mapbox.com/maki-icons/ Note that the array marker.color and marker.size are only available for circle symbols.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
1 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
mapbox subplots and traces are deprecated! Please consider switching to map subplots and traces. Learn more at: https://plotly.com/python/maplibre-migration/ as well as https://plotly.com/javascript/maplibre-migration/ Sets a reference between this trace's data coordinates and a mapbox subplot. If mapbox (the default value), the data refer to layout.mapbox. If mapbox2, the data refer to layout.mapbox2, and so on.
Sets text elements associated with each (lon,lat) pair If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (lon,lat) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
5 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the weight (or boldness) of the font.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables lat, lon and text.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
1 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set xaxis.layer and yaxis.layer to below traces.
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the r coordinate step.
Sets the theta coordinate step. By default, the dtheta step equals the subplot's period divided by the length of the r coordinates.
Sets the area to fill with a solid color. Use with fillcolor if not none. scatterpolar has a subset of the options available to scatter. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape. tonext fills the space between two traces if one completely encloses the other (eg consecutive contour lines), and behaves like toself if there is no trace before it. tonext should not be used if one trace does not enclose the other.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Do the hover effects highlight individual points (markers or line points) or do they highlight filled regions? If the fill is toself or tonext and there are no markers or text, then the default is fills, otherwise it is points.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
7 nested properties
Sets the line back off from the end point of the nth line segment (in px). This option is useful e.g. to avoid overlap with arrowhead markers. With auto the lines would trim before markers if marker.angleref is set to previous.
Sets the source reference on Chart Studio Cloud for backoff.
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the line shape. With spline the lines are drawn using spline interpolation. The other available values correspond to step-wise line shapes.
Has an effect only if shape is set to spline Sets the amount of smoothing. 0 corresponds to no smoothing (equivalent to a linear shape).
Sets the line width (in px).
29 nested properties
Sets the marker angle in respect to angleref.
Sets the reference for marker angle. With previous, angle 0 points along the line from the previous point to this one. With up, angle 0 points toward the top of the screen.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
4 nested properties
Sets the final color of the gradient fill: the center color for radial, the right for horizontal, or the bottom for vertical.
Sets the source reference on Chart Studio Cloud for color.
Sets the type of gradient used to fill the markers
Sets the source reference on Chart Studio Cloud for type.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets a maximum number of points to be drawn on the graph. 0 corresponds to no limit.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Moves the marker away from the data point in the direction of angle (in px). This can be useful for example if you have another marker at this location and you want to point an arrowhead marker at it.
Sets the source reference on Chart Studio Cloud for standoff.
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover. If there are less than 20 points and the trace is not stacked then the default is lines+markers. Otherwise, lines.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
Sets the radial coordinates
Alternate to r. Builds a linear space of r coordinates. Use with dr where r0 is the starting coordinate and dr the step.
Sets the source reference on Chart Studio Cloud for r.
2 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets a reference between this trace's data coordinates and a polar subplot. If polar (the default value), the data refer to layout.polar. If polar2, the data refer to layout.polar2, and so on.
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables r, theta and text.
Sets the source reference on Chart Studio Cloud for texttemplate.
Sets the angular coordinates
Alternate to theta. Builds a linear space of theta coordinates. Use with dtheta where theta0 is the starting coordinate and dtheta the step.
Sets the source reference on Chart Studio Cloud for theta.
Sets the unit of input theta values. Has an effect only when on linear angular axes.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the r coordinate step.
Sets the theta coordinate step. By default, the dtheta step equals the subplot's period divided by the length of the r coordinates.
Sets the area to fill with a solid color. Defaults to none unless this trace is stacked, then it gets tonexty (tonextx) if orientation is v (h) Use with fillcolor if not none. tozerox and tozeroy fill to x=0 and y=0 respectively. tonextx and tonexty fill between the endpoints of this trace and the endpoints of the trace before it, connecting those endpoints with straight lines (to make a stacked area graph); if there is no trace before it, they behave like tozerox and tozeroy. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape. tonext fills the space between two traces if one completely encloses the other (eg consecutive contour lines), and behaves like toself if there is no trace before it. tonext should not be used if one trace does not enclose the other. Traces in a stackgroup will only fill to (or be filled to) other traces in the same group. With multiple stackgroups or some traces stacked and some not, if fill-linked traces are not already consecutive, the later ones will be pushed down in the drawing order.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
3 nested properties
Sets the line color.
Sets the style of the lines.
Sets the line width (in px).
24 nested properties
Sets the marker angle in respect to angleref.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover. If there are less than 20 points and the trace is not stacked then the default is lines+markers. Otherwise, lines.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
Sets the radial coordinates
Alternate to r. Builds a linear space of r coordinates. Use with dr where r0 is the starting coordinate and dr the step.
Sets the source reference on Chart Studio Cloud for r.
2 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets a reference between this trace's data coordinates and a polar subplot. If polar (the default value), the data refer to layout.polar. If polar2, the data refer to layout.polar2, and so on.
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
12 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables r, theta and text.
Sets the source reference on Chart Studio Cloud for texttemplate.
Sets the angular coordinates
Alternate to theta. Builds a linear space of theta coordinates. Use with dtheta where theta0 is the starting coordinate and dtheta the step.
Sets the source reference on Chart Studio Cloud for theta.
Sets the unit of input theta values. Has an effect only when on linear angular axes.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set xaxis.layer and yaxis.layer to below traces.
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the area to fill with a solid color. Use with fillcolor if not none. scattersmith has a subset of the options available to scatter. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape. tonext fills the space between two traces if one completely encloses the other (eg consecutive contour lines), and behaves like toself if there is no trace before it. tonext should not be used if one trace does not enclose the other.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Do the hover effects highlight individual points (markers or line points) or do they highlight filled regions? If the fill is toself or tonext and there are no markers or text, then the default is fills, otherwise it is points.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the imaginary component of the data, in units of normalized impedance such that real=1, imag=0 is the center of the chart.
Sets the source reference on Chart Studio Cloud for imag.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
7 nested properties
Sets the line back off from the end point of the nth line segment (in px). This option is useful e.g. to avoid overlap with arrowhead markers. With auto the lines would trim before markers if marker.angleref is set to previous.
Sets the source reference on Chart Studio Cloud for backoff.
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the line shape. With spline the lines are drawn using spline interpolation. The other available values correspond to step-wise line shapes.
Has an effect only if shape is set to spline Sets the amount of smoothing. 0 corresponds to no smoothing (equivalent to a linear shape).
Sets the line width (in px).
29 nested properties
Sets the marker angle in respect to angleref.
Sets the reference for marker angle. With previous, angle 0 points along the line from the previous point to this one. With up, angle 0 points toward the top of the screen.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
4 nested properties
Sets the final color of the gradient fill: the center color for radial, the right for horizontal, or the bottom for vertical.
Sets the source reference on Chart Studio Cloud for color.
Sets the type of gradient used to fill the markers
Sets the source reference on Chart Studio Cloud for type.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets a maximum number of points to be drawn on the graph. 0 corresponds to no limit.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Moves the marker away from the data point in the direction of angle (in px). This can be useful for example if you have another marker at this location and you want to point an arrowhead marker at it.
Sets the source reference on Chart Studio Cloud for standoff.
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover. If there are less than 20 points and the trace is not stacked then the default is lines+markers. Otherwise, lines.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
Sets the real component of the data, in units of normalized impedance such that real=1, imag=0 is the center of the chart.
Sets the source reference on Chart Studio Cloud for real.
2 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets a reference between this trace's data coordinates and a smith subplot. If smith (the default value), the data refer to layout.smith. If smith2, the data refer to layout.smith2, and so on.
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables real, imag and text.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Sets the quantity of component a in each data point. If a, b, and c are all provided, they need not be normalized, only the relative values matter. If only two arrays are provided they must be normalized to match ternary<i>.sum.
Sets the source reference on Chart Studio Cloud for a.
Sets the quantity of component a in each data point. If a, b, and c are all provided, they need not be normalized, only the relative values matter. If only two arrays are provided they must be normalized to match ternary<i>.sum.
Sets the source reference on Chart Studio Cloud for b.
Sets the quantity of component a in each data point. If a, b, and c are all provided, they need not be normalized, only the relative values matter. If only two arrays are provided they must be normalized to match ternary<i>.sum.
Determines whether or not markers and text nodes are clipped about the subplot axes. To show markers and text nodes above axis lines and tick labels, make sure to set xaxis.layer and yaxis.layer to below traces.
Determines whether or not gaps (i.e. {nan} or missing values) in the provided data arrays are connected.
Sets the source reference on Chart Studio Cloud for c.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the area to fill with a solid color. Use with fillcolor if not none. scatterternary has a subset of the options available to scatter. toself connects the endpoints of the trace (or each segment of the trace if it has gaps) into a closed shape. tonext fills the space between two traces if one completely encloses the other (eg consecutive contour lines), and behaves like toself if there is no trace before it. tonext should not be used if one trace does not enclose the other.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Do the hover effects highlight individual points (markers or line points) or do they highlight filled regions? If the fill is toself or tonext and there are no markers or text, then the default is fills, otherwise it is points.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (a,b,c) point. If a single string, the same string appears over all the data points. If an array of strings, the items are mapped in order to the the data points in (a,b,c). To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
7 nested properties
Sets the line back off from the end point of the nth line segment (in px). This option is useful e.g. to avoid overlap with arrowhead markers. With auto the lines would trim before markers if marker.angleref is set to previous.
Sets the source reference on Chart Studio Cloud for backoff.
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the line shape. With spline the lines are drawn using spline interpolation. The other available values correspond to step-wise line shapes.
Has an effect only if shape is set to spline Sets the amount of smoothing. 0 corresponds to no smoothing (equivalent to a linear shape).
Sets the line width (in px).
29 nested properties
Sets the marker angle in respect to angleref.
Sets the reference for marker angle. With previous, angle 0 points along the line from the previous point to this one. With up, angle 0 points toward the top of the screen.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
4 nested properties
Sets the final color of the gradient fill: the center color for radial, the right for horizontal, or the bottom for vertical.
Sets the source reference on Chart Studio Cloud for color.
Sets the type of gradient used to fill the markers
Sets the source reference on Chart Studio Cloud for type.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets a maximum number of points to be drawn on the graph. 0 corresponds to no limit.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Moves the marker away from the data point in the direction of angle (in px). This can be useful for example if you have another marker at this location and you want to point an arrowhead marker at it.
Sets the source reference on Chart Studio Cloud for standoff.
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Determines the drawing mode for this scatter trace. If the provided mode includes text then the text elements appear at the coordinates. Otherwise, the text elements appear on hover. If there are less than 20 points and the trace is not stacked then the default is lines+markers. Otherwise, lines.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
2 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
1 nested properties
Sets the text font color of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets a reference between this trace's data coordinates and a ternary subplot. If ternary (the default value), the data refer to layout.ternary. If ternary2, the data refer to layout.ternary2, and so on.
The number each triplet should sum to, if only two of a, b, and c are provided. This overrides ternary<i>.sum to normalize this specific trace, but does not affect the values displayed on the axes. 0 (or missing) means to use ternary.sum
Sets text elements associated with each (a,b,c) point. If a single string, the same string appears over all the data points. If an array of strings, the items are mapped in order to the the data points in (a,b,c). If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the positions of the text elements with respects to the (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables a, b, c and text.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
2 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
1 nested properties
Sets the text font color of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
1 nested properties
Determines whether or not subplots on the diagonal are displayed.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
24 nested properties
Sets the marker angle in respect to angleref.
Sets the source reference on Chart Studio Cloud for angle.
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if in marker.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.color) or the bounds set in marker.cmin and marker.cmax Has an effect only if in marker.color is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.color is set to a numerical array. Value should have the same units as in marker.color and if set, marker.cmax must be set as well.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. Has an effect only if in marker.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
12 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.line.colorscale. Has an effect only if in marker.line.color is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here in marker.line.color) or the bounds set in marker.line.cmin and marker.line.cmax Has an effect only if in marker.line.color is set to a numerical array. Defaults to false when marker.line.cmin and marker.line.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.line.cmin and/or marker.line.cmax to be equidistant to this point. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color. Has no effect when marker.line.cauto is false.
Sets the lower bound of the color domain. Has an effect only if in marker.line.color is set to a numerical array. Value should have the same units as in marker.line.color and if set, marker.line.cmax must be set as well.
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
Sets the colorscale. Has an effect only if in marker.line.color is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.line.cmin and marker.line.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for color.
Reverses the color mapping if true. Has an effect only if in marker.line.color is set to a numerical array. If true, marker.line.cmin will correspond to the last color in the array and marker.line.cmax will correspond to the first color.
Sets the width (in px) of the lines bounding the marker points.
Sets the source reference on Chart Studio Cloud for width.
Sets the marker opacity.
Sets the source reference on Chart Studio Cloud for opacity.
Reverses the color mapping if true. Has an effect only if in marker.color is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if in marker.color is set to a numerical array.
Sets the marker size (in px).
Has an effect only if marker.size is set to a numerical array. Sets the minimum size (in px) of the rendered marker points.
Has an effect only if marker.size is set to a numerical array. Sets the rule for which the data in size is converted to pixels.
Has an effect only if marker.size is set to a numerical array. Sets the scale factor used to determine the rendered size of marker points. Use with sizemin and sizemode.
Sets the source reference on Chart Studio Cloud for size.
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
Sets the source reference on Chart Studio Cloud for symbol.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
1 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not subplots on the lower half from the diagonal are displayed.
Determines whether or not subplots on the upper half from the diagonal are displayed.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each (x,y) pair to appear on hover. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
1 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the list of x axes corresponding to dimensions of this splom trace. By default, a splom will match the first N xaxes where N is the number of input dimensions. Note that, in case where diagonal.visible is false and showupperhalf or showlowerhalf is false, this splom trace will generate one less x-axis and one less y-axis.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the list of y axes corresponding to dimensions of this splom trace. By default, a splom will match the first N yaxes where N is the number of input dimensions. Note that, in case where diagonal.visible is false and showupperhalf or showlowerhalf is false, this splom trace will generate one less x-axis and one less y-axis.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here u/v/w norm) or the bounds set in cmin and cmax Defaults to false when cmin and cmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as u/v/w norm and if set, cmin must be set as well.
Sets the mid-point of the color domain by scaling cmin and/or cmax to be equidistant to this point. Value should have the same units as u/v/w norm. Has no effect when cauto is false.
Sets the lower bound of the color domain. Value should have the same units as u/v/w norm and if set, cmax must be set as well.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use cmin and cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables tubex, tubey, tubez, tubeu, tubev, tubew, norm and divergence. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
7 nested properties
Ambient light increases overall color visibility but can wash out the image.
Represents the extent that incident rays are reflected in a range of angles.
Epsilon for face normals calculation avoids math issues arising from degenerate geometry.
Represents the reflectance as a dependency of the viewing angle; e.g. paper is reflective when viewing it from the edge of the paper (almost 90 degrees), causing shine.
Alters specular reflection; the rougher the surface, the wider and less contrasty the shine.
Represents the level that incident rays are reflected in a single direction, causing shine.
Epsilon for vertex normals calculation avoids math issues arising from degenerate geometry.
3 nested properties
Numeric vector, representing the X coordinate for each vertex.
Numeric vector, representing the Y coordinate for each vertex.
Numeric vector, representing the Z coordinate for each vertex.
The maximum number of displayed segments in a streamtube.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the surface. Please note that in the case of using high opacity values for example a value greater than or equal to 0.5 on two surfaces (and 0.25 with four surfaces), an overlay of multiple transparent surfaces may not perfectly be sorted in depth by the webgl API. This behavior may be improved in the near future and is subject to change.
Reverses the color mapping if true. If true, cmin will correspond to the last color in the array and cmax will correspond to the first color.
Sets a reference between this trace's 3D coordinate system and a 3D scene. If scene (the default value), the (x,y,z) coordinates refer to layout.scene. If scene2, the (x,y,z) coordinates refer to layout.scene2, and so on.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
The scaling factor for the streamtubes. The default is 1, which avoids two max divergence tubes from touching at adjacent starting positions.
6 nested properties
Sets the x components of the starting position of the streamtubes
Sets the source reference on Chart Studio Cloud for x.
Sets the y components of the starting position of the streamtubes
Sets the source reference on Chart Studio Cloud for y.
Sets the z components of the starting position of the streamtubes
Sets the source reference on Chart Studio Cloud for z.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets a text element associated with this trace. If trace hoverinfo contains a text flag, this text element will be seen in all hover labels. Note that streamtube traces do not support array text values.
Sets the x components of the vector field.
Sets the hover text formatting rulefor u using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the source reference on Chart Studio Cloud for u.
Sets the y components of the vector field.
Sets the hover text formatting rulefor v using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the source reference on Chart Studio Cloud for v.
Sets the z components of the vector field.
Sets the hover text formatting rulefor w using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Sets the source reference on Chart Studio Cloud for w.
Sets the x coordinates of the vector field.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the y coordinates of the vector field.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the z coordinates of the vector field.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using zaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Determines how the items in values are summed. When set to total, items in values are taken to be value of all its descendants. When set to remainder, items in values corresponding to the root and the branches sectors are taken to be the extra part not part of the sum of the values at their leaves.
Determines default for values when it is not provided, by inferring a 1 for each of the leaves and/or branches, otherwise 0.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this sunburst trace .
If there is a layout grid, use the domain for this row in the grid for this sunburst trace .
Sets the horizontal domain of this sunburst trace (in plot fraction).
Sets the vertical domain of this sunburst trace (in plot fraction).
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables currentPath, root, entry, percentRoot, percentEntry and percentParent. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each sector. If a single string, the same string appears for all data points. If an array of string, the items are mapped in order of this trace's sectors. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Controls the orientation of the text inside chart sectors. When set to auto, text may be oriented in any direction in order to be as big as possible in the middle of a sector. The horizontal option orients text to be parallel with the bottom of the chart, and may make text smaller in order to achieve that goal. The radial option orients text along the radius of the sector. The tangential option orients text perpendicular to the radius of the sector.
Sets the labels of each of the sectors.
Sets the source reference on Chart Studio Cloud for labels.
1 nested properties
Sets the opacity of the leaves. With colorscale it is defaulted to 1; otherwise it is defaulted to 0.7
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets the level from which this trace hierarchy is rendered. Set level to '' to start from the root node in the hierarchy. Must be an "id" if ids is filled in, otherwise plotly attempts to find a matching item in labels.
14 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if colors is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here colors) or the bounds set in marker.cmin and marker.cmax Has an effect only if colors is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if colors is set to a numerical array. Value should have the same units as colors and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if colors is set to a numerical array. Value should have the same units as colors. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if colors is set to a numerical array. Value should have the same units as colors and if set, marker.cmax must be set as well.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the color of each sector of this trace. If not specified, the default trace color set is used to pick the sector colors.
Sets the colorscale. Has an effect only if colors is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for colors.
4 nested properties
Sets the color of the line enclosing each sector. Defaults to the paper_bgcolor value.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the line enclosing each sector.
Sets the source reference on Chart Studio Cloud for width.
12 nested properties
When there is no colorscale sets the color of background pattern fill. Defaults to a marker.color background when fillmode is overlay. Otherwise, defaults to a transparent background.
Sets the source reference on Chart Studio Cloud for bgcolor.
When there is no colorscale sets the color of foreground pattern fill. Defaults to a marker.color background when fillmode is replace. Otherwise, defaults to dark grey or white to increase contrast with the bgcolor.
Sets the source reference on Chart Studio Cloud for fgcolor.
Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when fillmode is overlay. Otherwise, defaults to 1.
Determines whether marker.color should be used as a default to bgcolor or a fgcolor.
Sets the shape of the pattern fill. By default, no pattern is used for filling the area.
Sets the source reference on Chart Studio Cloud for shape.
Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.
Sets the source reference on Chart Studio Cloud for size.
Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.
Sets the source reference on Chart Studio Cloud for solidity.
Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if colors is set to a numerical array.
Sets the number of rendered sectors from any given level. Set maxdepth to -1 to render all the levels in the hierarchy.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the parent sectors for each of the sectors. Empty string items '' are understood to reference the root node in the hierarchy. If ids is filled, parents items are understood to be "ids" themselves. When ids is not set, plotly attempts to find matching items in labels, but beware they must be unique.
Sets the source reference on Chart Studio Cloud for parents.
1 nested properties
sets the color of the root node for a sunburst/treemap/icicle trace. this has no effect when a colorscale is used to set the markers.
Rotates the whole diagram counterclockwise by some angle. By default the first slice starts at 3 o'clock.
Determines whether or not the sectors are reordered from largest to smallest.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each sector. If trace textinfo contains a text flag, these elements will be seen on the chart. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Determines which trace information appear on the graph.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables currentPath, root, entry, percentRoot, percentEntry, percentParent, label and value.
Sets the source reference on Chart Studio Cloud for texttemplate.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the values associated with each of the sectors. Use with branchvalues to determine how the values are summed.
Sets the source reference on Chart Studio Cloud for values.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here z or surfacecolor) or the bounds set in cmin and cmax Defaults to false when cmin and cmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as z or surfacecolor and if set, cmin must be set as well.
Sets the mid-point of the color domain by scaling cmin and/or cmax to be equidistant to this point. Value should have the same units as z or surfacecolor. Has no effect when cauto is false.
Sets the lower bound of the color domain. Value should have the same units as z or surfacecolor and if set, cmax must be set as well.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use cmin and cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Determines whether or not gaps (i.e. {nan} or missing values) in the z data are filled in.
3 nested properties
11 nested properties
Sets the color of the contour lines.
Sets the end contour level value. Must be more than contours.start
Determines whether or not contour lines about the x dimension are highlighted on hover.
Sets the color of the highlighted contour lines.
Sets the width of the highlighted contour lines.
Determines whether or not contour lines about the x dimension are drawn.
Sets the step between each contour level. Must be positive.
Sets the starting contour level value. Must be less than contours.end
An alternate to color. Determines whether or not the contour lines are colored using the trace colorscale.
Sets the width of the contour lines.
11 nested properties
Sets the color of the contour lines.
Sets the end contour level value. Must be more than contours.start
Determines whether or not contour lines about the y dimension are highlighted on hover.
Sets the color of the highlighted contour lines.
Sets the width of the highlighted contour lines.
Determines whether or not contour lines about the y dimension are drawn.
Sets the step between each contour level. Must be positive.
Sets the starting contour level value. Must be less than contours.end
An alternate to color. Determines whether or not the contour lines are colored using the trace colorscale.
Sets the width of the contour lines.
11 nested properties
Sets the color of the contour lines.
Sets the end contour level value. Must be more than contours.start
Determines whether or not contour lines about the z dimension are highlighted on hover.
Sets the color of the highlighted contour lines.
Sets the width of the highlighted contour lines.
Determines whether or not contour lines about the z dimension are drawn.
Sets the step between each contour level. Must be positive.
Sets the starting contour level value. Must be less than contours.end
An alternate to color. Determines whether or not the contour lines are colored using the trace colorscale.
Sets the width of the contour lines.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Determines whether or not a surface is drawn. For example, set hidesurface to false contours.x.show to true and contours.y.show to true to draw a wire frame plot.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
5 nested properties
Ambient light increases overall color visibility but can wash out the image.
Represents the extent that incident rays are reflected in a range of angles.
Represents the reflectance as a dependency of the viewing angle; e.g. paper is reflective when viewing it from the edge of the paper (almost 90 degrees), causing shine.
Alters specular reflection; the rougher the surface, the wider and less contrasty the shine.
Represents the level that incident rays are reflected in a single direction, causing shine.
3 nested properties
Numeric vector, representing the X coordinate for each vertex.
Numeric vector, representing the Y coordinate for each vertex.
Numeric vector, representing the Z coordinate for each vertex.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the surface. Please note that in the case of using high opacity values for example a value greater than or equal to 0.5 on two surfaces (and 0.25 with four surfaces), an overlay of multiple transparent surfaces may not perfectly be sorted in depth by the webgl API. This behavior may be improved in the near future and is subject to change.
Sets the opacityscale. The opacityscale must be an array containing arrays mapping a normalized value to an opacity value. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 1], [0.5, 0.2], [1, 1]] means that higher/lower values would have higher opacity values and those in the middle would be more transparent Alternatively, opacityscale may be a palette name string of the following list: 'min', 'max', 'extremes' and 'uniform'. The default is 'uniform'.
Reverses the color mapping if true. If true, cmin will correspond to the last color in the array and cmax will correspond to the first color.
Sets a reference between this trace's 3D coordinate system and a 3D scene. If scene (the default value), the (x,y,z) coordinates refer to layout.scene. If scene2, the (x,y,z) coordinates refer to layout.scene2, and so on.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the surface color values, used for setting a color scale independent of z.
Sets the source reference on Chart Studio Cloud for surfacecolor.
Sets the text elements associated with each z value. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the x coordinates.
Sets the calendar system to use with x date data.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the y coordinates.
Sets the calendar system to use with y date data.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the z coordinates.
Sets the calendar system to use with z date data.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using zaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Determines how the items in values are summed. When set to total, items in values are taken to be value of all its descendants. When set to remainder, items in values corresponding to the root and the branches sectors are taken to be the extra part not part of the sum of the values at their leaves.
Determines default for values when it is not provided, by inferring a 1 for each of the leaves and/or branches, otherwise 0.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
4 nested properties
If there is a layout grid, use the domain for this column in the grid for this treemap trace .
If there is a layout grid, use the domain for this row in the grid for this treemap trace .
Sets the horizontal domain of this treemap trace (in plot fraction).
Sets the vertical domain of this treemap trace (in plot fraction).
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables currentPath, root, entry, percentRoot, percentEntry and percentParent. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each sector. If a single string, the same string appears for all data points. If an array of string, the items are mapped in order of this trace's sectors. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the labels of each of the sectors.
Sets the source reference on Chart Studio Cloud for labels.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
Sets the level from which this trace hierarchy is rendered. Set level to '' to start from the root node in the hierarchy. Must be an "id" if ids is filled in, otherwise plotly attempts to find a matching item in labels.
17 nested properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by marker.colorscale. Has an effect only if colors is set to a numerical array. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
Determines whether or not the color domain is computed with respect to the input data (here colors) or the bounds set in marker.cmin and marker.cmax Has an effect only if colors is set to a numerical array. Defaults to false when marker.cmin and marker.cmax are set by the user.
Sets the upper bound of the color domain. Has an effect only if colors is set to a numerical array. Value should have the same units as colors and if set, marker.cmin must be set as well.
Sets the mid-point of the color domain by scaling marker.cmin and/or marker.cmax to be equidistant to this point. Has an effect only if colors is set to a numerical array. Value should have the same units as colors. Has no effect when marker.cauto is false.
Sets the lower bound of the color domain. Has an effect only if colors is set to a numerical array. Value should have the same units as colors and if set, marker.cmax must be set as well.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the color of each sector of this trace. If not specified, the default trace color set is used to pick the sector colors.
Sets the colorscale. Has an effect only if colors is set to a numerical array. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use marker.cmin and marker.cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
Sets the source reference on Chart Studio Cloud for colors.
Sets the maximum rounding of corners (in px).
Determines if the sector colors are faded towards the background from the leaves up to the headers. This option is unavailable when a colorscale is present, defaults to false when marker.colors is set, but otherwise defaults to true. When set to reversed, the fading direction is inverted, that is the top elements within hierarchy are drawn with fully saturated colors while the leaves are faded towards the background color.
4 nested properties
Sets the color of the line enclosing each sector. Defaults to the paper_bgcolor value.
Sets the source reference on Chart Studio Cloud for color.
Sets the width (in px) of the line enclosing each sector.
Sets the source reference on Chart Studio Cloud for width.
4 nested properties
Sets the padding form the bottom (in px).
Sets the padding form the left (in px).
Sets the padding form the right (in px).
Sets the padding form the top (in px).
12 nested properties
When there is no colorscale sets the color of background pattern fill. Defaults to a marker.color background when fillmode is overlay. Otherwise, defaults to a transparent background.
Sets the source reference on Chart Studio Cloud for bgcolor.
When there is no colorscale sets the color of foreground pattern fill. Defaults to a marker.color background when fillmode is replace. Otherwise, defaults to dark grey or white to increase contrast with the bgcolor.
Sets the source reference on Chart Studio Cloud for fgcolor.
Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when fillmode is overlay. Otherwise, defaults to 1.
Determines whether marker.color should be used as a default to bgcolor or a fgcolor.
Sets the shape of the pattern fill. By default, no pattern is used for filling the area.
Sets the source reference on Chart Studio Cloud for shape.
Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.
Sets the source reference on Chart Studio Cloud for size.
Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.
Sets the source reference on Chart Studio Cloud for solidity.
Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, marker.cmin will correspond to the last color in the array and marker.cmax will correspond to the first color.
Determines whether or not a colorbar is displayed for this trace. Has an effect only if colors is set to a numerical array.
Sets the number of rendered sectors from any given level. Set maxdepth to -1 to render all the levels in the hierarchy.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the trace.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the parent sectors for each of the sectors. Empty string items '' are understood to reference the root node in the hierarchy. If ids is filled, parents items are understood to be "ids" themselves. When ids is not set, plotly attempts to find matching items in labels, but beware they must be unique.
Sets the source reference on Chart Studio Cloud for parents.
5 nested properties
Determines which shape is used for edges between barpath labels.
Determines on which side of the the treemap the pathbar should be presented.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the thickness of pathbar (in px). If not specified the pathbar.textfont.size is used with 3 pixles extra padding on each side.
Determines if the path bar is drawn i.e. outside the trace domain and with one pixel gap.
1 nested properties
sets the color of the root node for a sunburst/treemap/icicle trace. this has no effect when a colorscale is used to set the markers.
Determines whether or not the sectors are reordered from largest to smallest.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each sector. If trace textinfo contains a text flag, these elements will be seen on the chart. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Determines which trace information appear on the graph.
Sets the positions of the text elements.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables currentPath, root, entry, percentRoot, percentEntry, percentParent, label and value.
Sets the source reference on Chart Studio Cloud for texttemplate.
4 nested properties
Determines if the positions obtained from solver are flipped on each axis.
Determines d3 treemap solver. For more info please refer to https://github.com/d3/d3-hierarchy#treemap-tiling
Sets the inner padding (in px).
When using squarify packing algorithm, according to https://github.com/d3/d3-hierarchy/blob/v3.1.1/README.md#squarify_ratio this option specifies the desired aspect ratio of the generated rectangles. The ratio must be specified as a number greater than or equal to one. Note that the orientation of the generated rectangles (tall or wide) is not implied by the ratio; for example, a ratio of two will attempt to produce a mixture of rectangles whose width:height ratio is either 2:1 or 1:2. When using squarify, unlike d3 which uses the Golden Ratio i.e. 1.618034, Plotly applies 1 to increase squares in treemap layouts.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the values associated with each of the sectors. Use with branchvalues to determine how the values are summed.
Sets the source reference on Chart Studio Cloud for values.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
A schema to validate plotly trace properties
Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently.
Sets the bandwidth used to compute the kernel density estimate. By default, the bandwidth is determined by Silverman's rule of thumb.
4 nested properties
Sets the inner box plot fill color.
2 nested properties
Sets the inner box plot bounding line color.
Sets the inner box plot bounding line width.
Determines if an miniature box plot is drawn inside the violins.
Sets the width of the inner box plots relative to the violins' width. For example, with 1, the inner box plots are as wide as the violins.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Sets the fill color. Defaults to a half-transparent variant of the line color, marker color, or marker line color, whichever is available.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Do the hover effects highlight individual violins or sample points or the kernel density estimate or any combination of them?
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the amount of jitter in the sample points drawn. If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the violins.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
2 nested properties
Sets the color of line bounding the violin(s).
Sets the width (in px) of line bounding the violin(s).
7 nested properties
Sets the marker angle in respect to angleref.
Sets the marker color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.cmin and marker.cmax if set.
4 nested properties
Sets the marker.line color. It accepts either a specific color or an array of numbers that are mapped to the colorscale relative to the max and min values of the array or relative to marker.line.cmin and marker.line.cmax if set.
Sets the border line color of the outlier sample points. Defaults to marker.color
Sets the border line width (in px) of the outlier sample points.
Sets the width (in px) of the lines bounding the marker points.
Sets the marker opacity.
Sets the color of the outlier sample points.
Sets the marker size (in px).
Sets the marker symbol type. Adding 100 is equivalent to appending -open to a symbol name. Adding 200 is equivalent to appending -dot to a symbol name. Adding 300 is equivalent to appending -open-dot or dot-open to a symbol name.
3 nested properties
Sets the mean line color.
Determines if a line corresponding to the sample's mean is shown inside the violins. If box.visible is turned on, the mean line is drawn inside the inner box. Otherwise, the mean line is drawn from one side of the violin to other.
Sets the mean line width.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover. For violin traces, the name will also be used for the position coordinate, if x and x0 (y and y0 if horizontal) are missing and the position axis is categorical. Note that the trace name is also used as a default value for attribute scalegroup (please see its description for details).
Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up.
Sets the opacity of the trace.
Sets the orientation of the violin(s). If v (h), the distribution is visualized along the vertical (horizontal).
Sets the position of the sample points in relation to the violins. If 0, the sample points are places over the center of the violins. Positive (negative) values correspond to positions to the right (left) for vertical violins and above (below) for horizontal violins.
If outliers, only the sample points lying outside the whiskers are shown If suspectedoutliers, the outlier points are shown and points either less than 4Q1-3Q3 or greater than 4Q3-3Q1 are highlighted (see outliercolor) If all, all sample points are shown If false, only the violins are shown with no sample points. Defaults to suspectedoutliers when marker.outliercolor or marker.line.outliercolor is set, otherwise defaults to outliers.
Sets the method used to compute the sample's Q1 and Q3 quartiles. The linear method uses the 25th percentile for Q1 and 75th percentile for Q3 as computed using method #10 (listed on http://jse.amstat.org/v14n3/langford.html). The exclusive method uses the median to divide the ordered dataset into two halves if the sample is odd, it does not include the median in either half - Q1 is then the median of the lower half and Q3 the median of the upper half. The inclusive method also uses the median to divide the ordered dataset into two halves but if the sample is odd, it includes the median in both halves - Q1 is then the median of the lower half and Q3 the median of the upper half.
If there are multiple violins that should be sized according to to some metric (see scalemode), link them by providing a non-empty group id here shared by every trace in the same group. If a violin's width is undefined, scalegroup will default to the trace's name. In this case, violins with the same names will be linked together
Sets the metric by which the width of each violin is determined. width means each violin has the same (max) width count means the violins are scaled by the number of sample points making up each violin.
1 nested properties
3 nested properties
Sets the marker color of selected points.
Sets the marker opacity of selected points.
Sets the marker size of selected points.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines on which side of the position value the density function making up one half of a violin is plotted. Useful when comparing two violin traces under overlay mode, where one trace has side set to positive and the other to negative.
Sets the span in data space for which the density function will be computed. Has an effect only when spanmode is set to manual.
Sets the method by which the span in data space where the density function will be computed. soft means the span goes from the sample's minimum value minus two bandwidths to the sample's maximum value plus two bandwidths. hard means the span goes from the sample's minimum to its maximum value. For custom span settings, use mode manual and fill in the span attribute.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets the text elements associated with each sample value. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
1 nested properties
3 nested properties
Sets the marker color of unselected points, applied only when a selection exists.
Sets the marker opacity of unselected points, applied only when a selection exists.
Sets the marker size of unselected points, applied only when a selection exists.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the width of the violin in data coordinates. If 0 (default value) the width is automatically selected based on the positions of other violin traces in the same subplot.
Sets the x sample data or coordinates. See overview for more info.
Sets the x coordinate for single-box traces or the starting coordinate for multi-box traces set using q1/median/q3. See overview for more info.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the y sample data or coordinates. See overview for more info.
Sets the y coordinate for single-box traces or the starting coordinate for multi-box traces set using q1/median/q3. See overview for more info.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A schema to validate plotly trace properties
Determines whether the colorscale is a default palette (autocolorscale: true) or the palette determined by colorscale. In case colorscale is unspecified or autocolorscale is true, the default palette will be chosen according to whether numbers in the color array are all positive, all negative or mixed.
3 nested properties
2 nested properties
Sets the fill ratio of the caps. The default fill value of the caps is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Sets the fill ratio of the slices. The default fill value of the x slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
2 nested properties
Sets the fill ratio of the caps. The default fill value of the caps is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Sets the fill ratio of the slices. The default fill value of the y slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
2 nested properties
Sets the fill ratio of the caps. The default fill value of the caps is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Sets the fill ratio of the slices. The default fill value of the z slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Determines whether or not the color domain is computed with respect to the input data (here value) or the bounds set in cmin and cmax Defaults to false when cmin and cmax are set by the user.
Sets the upper bound of the color domain. Value should have the same units as value and if set, cmin must be set as well.
Sets the mid-point of the color domain by scaling cmin and/or cmax to be equidistant to this point. Value should have the same units as value. Has no effect when cauto is false.
Sets the lower bound of the color domain. Value should have the same units as value and if set, cmax must be set as well.
Sets a reference to a shared color axis. References to these shared color axes are coloraxis, coloraxis2, coloraxis3, etc. Settings for these shared color axes are set in the layout, under layout.coloraxis, layout.coloraxis2, etc. Note that multiple color scales can be linked to the same color axis.
48 nested properties
Sets the color of padded area.
Sets the axis line color.
Sets the width (in px) or the border enclosing this color bar.
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
Determines whether this color bar's length (i.e. the measure in the color variation direction) is set in units of plot fraction or in *pixels. Use len to set the value.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Sets the orientation of the colorbar.
Sets the axis line color.
Sets the width (in px) of the axis line.
If "true", even 4-digit integers are separated
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
Determines whether this color bar's thickness (i.e. the measure in the constant color direction) is set in units of plot fraction or in pixels. Use thickness to set the value.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
Determines where tick labels are drawn relative to the ticks. Left and right options are used when orientation is h, top and bottom when orientation is v.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
Determines the location of color bar's title with respect to the color bar. Defaults to top when orientation if v and defaults to right when orientation if h.
Sets the title of the color bar.
Sets the x position with respect to xref of the color bar (in plot fraction). When xref is paper, defaults to 1.02 when orientation is v and 0.5 when orientation is h. When xref is container, defaults to 1 when orientation is v and 0.5 when orientation is h. Must be between 0 and 1 if xref is container and between -2 and 3 if xref is paper.
Sets this color bar's horizontal position anchor. This anchor binds the x position to the left, center or right of the color bar. Defaults to left when orientation is v and center when orientation is h.
Sets the amount of padding (in px) along the x direction.
Sets the container x refers to. container spans the entire width of the plot. paper refers to the width of the plotting area only.
Sets the y position with respect to yref of the color bar (in plot fraction). When yref is paper, defaults to 0.5 when orientation is v and 1.02 when orientation is h. When yref is container, defaults to 0.5 when orientation is v and 1 when orientation is h. Must be between 0 and 1 if yref is container and between -2 and 3 if yref is paper.
Sets this color bar's vertical position anchor This anchor binds the y position to the top, middle or bottom of the color bar. Defaults to middle when orientation is v and bottom when orientation is h.
Sets the amount of padding (in px) along the y direction.
Sets the container y refers to. container spans the entire height of the plot. paper refers to the height of the plotting area only.
Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]. To control the bounds of the colorscale in color space, use cmin and cmax. Alternatively, colorscale may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
3 nested properties
Sets the color of the contour lines.
Sets whether or not dynamic contours are shown on hover
Sets the width of the contour lines.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
Determines whether or not normal smoothing is applied to the meshes, creating meshes with an angular, low-poly look via flat reflections.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Same as text.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
Sets the maximum boundary for iso-surface plot.
Sets the minimum boundary for iso-surface plot.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
7 nested properties
Ambient light increases overall color visibility but can wash out the image.
Represents the extent that incident rays are reflected in a range of angles.
Epsilon for face normals calculation avoids math issues arising from degenerate geometry.
Represents the reflectance as a dependency of the viewing angle; e.g. paper is reflective when viewing it from the edge of the paper (almost 90 degrees), causing shine.
Alters specular reflection; the rougher the surface, the wider and less contrasty the shine.
Represents the level that incident rays are reflected in a single direction, causing shine.
Epsilon for vertex normals calculation avoids math issues arising from degenerate geometry.
3 nested properties
Numeric vector, representing the X coordinate for each vertex.
Numeric vector, representing the Y coordinate for each vertex.
Numeric vector, representing the Z coordinate for each vertex.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Sets the opacity of the surface. Please note that in the case of using high opacity values for example a value greater than or equal to 0.5 on two surfaces (and 0.25 with four surfaces), an overlay of multiple transparent surfaces may not perfectly be sorted in depth by the webgl API. This behavior may be improved in the near future and is subject to change.
Sets the opacityscale. The opacityscale must be an array containing arrays mapping a normalized value to an opacity value. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example, [[0, 1], [0.5, 0.2], [1, 1]] means that higher/lower values would have higher opacity values and those in the middle would be more transparent Alternatively, opacityscale may be a palette name string of the following list: 'min', 'max', 'extremes' and 'uniform'. The default is 'uniform'.
Reverses the color mapping if true. If true, cmin will correspond to the last color in the array and cmax will correspond to the first color.
Sets a reference between this trace's 3D coordinate system and a 3D scene. If scene (the default value), the (x,y,z) coordinates refer to layout.scene. If scene2, the (x,y,z) coordinates refer to layout.scene2, and so on.
Determines whether or not an item corresponding to this trace is shown in the legend.
Determines whether or not a colorbar is displayed for this trace.
3 nested properties
4 nested properties
Sets the fill ratio of the slices. The default fill value of the slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Specifies the location(s) of slices on the axis. When not specified slices would be created for all points of the axis x except start and end.
Sets the source reference on Chart Studio Cloud for locations.
Determines whether or not slice planes about the x dimension are drawn.
4 nested properties
Sets the fill ratio of the slices. The default fill value of the slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Specifies the location(s) of slices on the axis. When not specified slices would be created for all points of the axis y except start and end.
Sets the source reference on Chart Studio Cloud for locations.
Determines whether or not slice planes about the y dimension are drawn.
4 nested properties
Sets the fill ratio of the slices. The default fill value of the slices is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Specifies the location(s) of slices on the axis. When not specified slices would be created for all points of the axis z except start and end.
Sets the source reference on Chart Studio Cloud for locations.
Determines whether or not slice planes about the z dimension are drawn.
2 nested properties
Sets the fill ratio of the spaceframe elements. The default fill value is 1 meaning that they are entirely shaded. Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Displays/hides tetrahedron shapes between minimum and maximum iso-values. Often useful when either caps or surfaces are disabled or filled with values less than 1.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
4 nested properties
Sets the number of iso-surfaces between minimum and maximum iso-values. By default this value is 2 meaning that only minimum and maximum surfaces would be drawn.
Sets the fill ratio of the iso-surface. The default fill value of the surface is 1 meaning that they are entirely shaded. On the other hand Applying a fill ratio less than one would allow the creation of openings parallel to the edges.
Sets the surface pattern of the iso-surface 3-D sections. The default pattern of the surface is all meaning that the rest of surface elements would be shaded. The check options (either 1 or 2) could be used to draw half of the squares on the surface. Using various combinations of capital A, B, C, D and E may also be used to reduce the number of triangles on the iso-surfaces and creating other patterns of interest.
Hides/displays surfaces between minimum and maximum iso-values.
Sets the text elements associated with the vertices. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the source reference on Chart Studio Cloud for text.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Sets the 4th dimension (value) of the vertices.
Sets the hover text formatting rulefor value using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format.By default the values are formatted using generic number format.
Sets the source reference on Chart Studio Cloud for value.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the X coordinates of the vertices on X axis.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for x.
Sets the Y coordinates of the vertices on Y axis.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for y.
Sets the Z coordinates of the vertices on Z axis.
Sets the hover text formatting rulefor z using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using zaxis.hoverformat.
Sets the source reference on Chart Studio Cloud for z.
A schema to validate plotly trace properties
Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently.
Sets where the bar base is drawn (in position axis units).
Determines whether the text nodes are clipped about the subplot axes. To show the text nodes above axis lines and tick labels, make sure to set xaxis.layer and yaxis.layer to below traces.
3 nested properties
3 nested properties
Sets the line color.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the line width (in px).
Sets the shape of connector lines.
Determines if connector lines are drawn.
Constrain the size of text inside or outside a bar to be no larger than the bar itself.
Assigns extra data each datum. This may be useful when listening to hover, click and selection events. Note that, scatter traces also appends customdata items in the markers DOM elements
Sets the source reference on Chart Studio Cloud for customdata.
1 nested properties
2 nested properties
Sets the marker color of all decreasing values.
Sets the x coordinate step. See x0 for more info.
Sets the y coordinate step. See y0 for more info.
Determines which trace information appear on hover. If none or skip are set, no information is displayed upon hovering. But, if none is set, click and hover events are still fired.
Sets the source reference on Chart Studio Cloud for hoverinfo.
9 nested properties
Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
Sets the source reference on Chart Studio Cloud for align.
Sets the background color of the hover labels for this trace
Sets the source reference on Chart Studio Cloud for bgcolor.
Sets the border color of the hover labels for this trace.
Sets the source reference on Chart Studio Cloud for bordercolor.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to namelength - 3 characters and add an ellipsis.
Sets the source reference on Chart Studio Cloud for namelength.
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo. Variables are inserted using %{variable}, for example "y: %{y}" as well as %{xother}, {%xother}, {%xother}, {%xother}. When showing info for several points, xother will be added to those with different x positions from the first point. An underscore before or after (x|y)other will add a space on that side, only when this field is shown. Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. The variables available in hovertemplate are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables initial, delta and final. Anything contained in tag <extra> is displayed in the secondary box, for example "<extra></extra>.
Sets the source reference on Chart Studio Cloud for hovertemplate.
Sets hover text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. To be seen, trace hoverinfo must contain a text flag.
Sets the source reference on Chart Studio Cloud for hovertext.
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sets the source reference on Chart Studio Cloud for ids.
1 nested properties
2 nested properties
Sets the marker color of all increasing values.
Determines if texts are kept at center or start/end points in textposition inside mode.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Sets the reference to a legend to show this trace in. References to these legends are legend, legend2, legend3, etc. Settings for these legends are set in the layout, under layout.legend, layout.legend2, etc.
Sets the legend group for this trace. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
2 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the title of the legend group.
Sets the legend rank for this trace. Items and groups with smaller ranks are presented on top/left side while with reversed legend.traceorder they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.
Sets the width (in px or fraction) of the legend for this trace.
An array containing types of values. By default the values are considered as 'relative'. However; it is possible to use 'total' to compute the sums. Also 'absolute' could be applied to reset the computed total or to declare an initial value where needed.
Sets the source reference on Chart Studio Cloud for measure.
Sets the source reference on Chart Studio Cloud for meta.
Sets the trace name. The trace name appears as the legend item and on hover.
Shifts the position where the bar is drawn (in position axis units). In group barmode, traces that set offset will be excluded and drawn in overlay mode instead.
Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up.
Sets the source reference on Chart Studio Cloud for offset.
Sets the opacity of the trace.
Sets the orientation of the bars. With v (h), the value of the each bar spans along the vertical (horizontal).
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected are turned on for all points, whereas, any other non-array values means no selection all where the selected and unselected styles have no effect.
Determines whether or not an item corresponding to this trace is shown in the legend.
2 nested properties
Sets the maximum number of points to keep on the plots from an incoming stream. If maxpoints is set to 50, only the newest 50 points will be displayed on the plot.
The stream id number links a data trace on a plot with a stream. See https://chart-studio.plotly.com/settings for more details.
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace's (x,y) coordinates. If trace hoverinfo contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
Sets the angle of the tick labels with respect to the bar. For example, a tickangle of -90 draws the tick labels vertically. With auto the texts may automatically be rotated to fit with the maximum size in bars.
18 nested properties
Sets the source reference on Chart Studio Cloud for color.
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the source reference on Chart Studio Cloud for family.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the source reference on Chart Studio Cloud for lineposition.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets the source reference on Chart Studio Cloud for shadow.
Sets the source reference on Chart Studio Cloud for size.
Sets whether a font should be styled with a normal or italic face from its family.
Sets the source reference on Chart Studio Cloud for style.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the source reference on Chart Studio Cloud for textcase.
Sets the variant of the font.
Sets the source reference on Chart Studio Cloud for variant.
Sets the weight (or boldness) of the font.
Sets the source reference on Chart Studio Cloud for weight.
Determines which trace information appear on the graph. In the case of having multiple waterfalls, totals are computed separately (per trace).
Specifies the location of the text. inside positions text inside, next to the bar end (rotated and scaled if needed). outside positions text outside, next to the bar end (scaled if needed), unless there is another bar stacked on this one, then the text gets pushed inside. auto tries to position text inside the bar, but if the bar is too small and no bar is stacked on this one the text is moved outside. If none, no text appears.
Sets the source reference on Chart Studio Cloud for textposition.
Sets the source reference on Chart Studio Cloud for text.
Template string used for rendering the information text that appear on points. Note that this will override textinfo. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true) are available. Finally, the template string has access to variables initial, delta, final and label.
Sets the source reference on Chart Studio Cloud for texttemplate.
1 nested properties
2 nested properties
Sets the marker color of all intermediate sums and total values.
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Controls persistence of some user-driven changes to the trace: constraintrange in parcoords traces, as well as some editable: true modifications such as name and colorbar.title. Defaults to layout.uirevision. Note that other user-driven trace attribute changes are controlled by layout attributes: trace.visible is controlled by layout.legend.uirevision, selectedpoints is controlled by layout.selectionrevision, and colorbar.(x|y) (accessible with config: {editable: true}) is controlled by layout.editrevision. Trace changes are tracked by uid, which only falls back on trace index if no uid is provided. So if your app can add/remove traces before the end of the data array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid that stays with it as it moves.
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
Sets the bar width (in position axis units).
Sets the source reference on Chart Studio Cloud for width.
Sets the x coordinates.
Alternate to x. Builds a linear space of x coordinates. Use with dx where x0 is the starting coordinate and dx the step.
Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis. If x2, the x coordinates refer to layout.xaxis2, and so on.
Sets the hover text formatting rulefor x using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using xaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the x0 axis. When x0period is round number of weeks, the x0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the x axis.
Sets the source reference on Chart Studio Cloud for x.
Sets the y coordinates.
Alternate to y. Builds a linear space of y coordinates. Use with dy where y0 is the starting coordinate and dy the step.
Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis. If y2, the y coordinates refer to layout.yaxis2, and so on.
Sets the hover text formatting rulefor y using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46By default the values are formatted using yaxis.hoverformat.
Only relevant when the axis type is date. Sets the period positioning in milliseconds or Mn must be a positive integer.
Only relevant when the axis type is date. Sets the base for period positioning in milliseconds or date string on the y0 axis. When y0period is round number of weeks, the y0period0 by default would be on a Sunday i.e. 2000-01-02, otherwise it would be at 2000-01-01.
Only relevant when the axis type is date. Sets the alignment of data points on the y axis.
Sets the source reference on Chart Studio Cloud for y.
Sets the layer on which this trace is displayed, relative to other SVG traces on the same subplot. SVG traces with higher zorder appear in front of those with lower zorder.
A valid color in hex, rgb, rgba, hsl, hsv, or named CSS color
A Plotly colorscale either by name or a custom array of [value, color] pairs.
A string that will pull the value from the traces query results or inject an input value.
If set to an opposite-letter axis id (e.g. x2, y), this axis is bound to the corresponding opposite-letter axis. If set to free, this axis' position is determined by position.
Determines whether long tick labels automatically grow the figure margins.
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
6 nested properties
Clip autorange maximum if it goes beyond this value. Has no effect when autorangeoptions.maxallowed is provided.
Clip autorange minimum if it goes beyond this value. Has no effect when autorangeoptions.minallowed is provided.
Ensure this value is included in autorange.
Sets the source reference on Chart Studio Cloud for include.
Use this value exactly as autorange maximum.
Use this value exactly as autorange minimum.
When tickangle is set to auto, it will be set to the first angle in this array that is large enough to prevent label overlap.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines how that happens: by increasing the range, or by decreasing the domain. Default is domain for axes containing image traces, range otherwise.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines which direction we push the originally specified plot area. Options are left, center (default), and right for x axes, and top, middle (default), and bottom for y axes.
Sets the color of the dividers Only has an effect on multicategory axes.
Sets the width (in px) of the dividers Only has an effect on multicategory axes.
Sets the domain of this axis (in plot fraction).
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Could be used to set the desired inside range of this axis (excluding the labels) when ticklabelposition of the anchored axis has inside. Not implemented for axes with type log. This would be ignored when range is provided.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
If set to another axis id (e.g. x2, y), the range of this axis will match the range of the corresponding axis in data-coordinates space. Moreover, matching axes share auto-range values, category lists and histogram auto-bins. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Moreover, note that matching axes must have the same type.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
14 nested properties
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the tick color.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis, with traces and axes visible for both axes. If false, this axis does not overlay any same-letter axes. In this case, for axes with overlapping domains only the highest-numbered axis will be visible.
Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if anchor is set to free.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
11 nested properties
Sets the background color of the active range selector button.
Sets the background color of the range selector buttons.
Sets the color of the border enclosing the range selector.
Sets the width (in px) of the border enclosing the range selector.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Determines whether or not this range selector is visible. Note that range selectors are only available for x axes of type set to or auto-typed to date.
Sets the x position (in normalized coordinates) of the range selector.
Sets the range selector's horizontal position anchor. This anchor binds the x position to the left, center or right of the range selector.
Sets the y position (in normalized coordinates) of the range selector.
Sets the range selector's vertical position anchor This anchor binds the y position to the top, middle or bottom of the range selector.
8 nested properties
Determines whether or not the range slider range is computed in relation to the input data. If range is provided, then autorange is set to false.
Sets the background color of the range slider.
Sets the border color of the range slider.
Sets the border width of the range slider.
Sets the range of the range slider. If not set, defaults to the full xaxis range. If the axis type is log, then you must take the log of your desired range. If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears.
The height of the range slider as a fraction of the total plot area height.
Determines whether or not the range slider will be visible. If visible, perpendicular axes will be set to fixedrange
2 nested properties
Sets the range of this axis for the rangeslider.
Determines whether or not the range of this axis in the rangeslider use the same value than in the main plot when zooming in/out. If auto, the autorange will be used. If fixed, the range is used. If match, the current range of the corresponding y-axis on the main subplot is used.
If set to another axis id (e.g. x2, y), the range of this axis changes together with the range of the corresponding axis such that the scale of pixels per unit is in a constant ratio. Both axes are still zoomable, but when you zoom one, the other will zoom the same amount, keeping a fixed midpoint. constrain and constraintoward determine how we enforce the constraint. You can chain these, ie yaxis: {scaleanchor: *x*}, xaxis2: {scaleanchor: *y*} but you can only link axes of the same type. The linked axis can have the opposite letter (to constrain the aspect ratio) or the same letter (to match scales across subplots). Loops (yaxis: {scaleanchor: *x*}, xaxis: {scaleanchor: *y*} or longer) are redundant and the last constraint encountered will be ignored to avoid possible inconsistent constraints via scaleratio. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Setting false allows to remove a default constraint (occasionally, you may need to prevent a default scaleanchor constraint from being applied, eg. when having an image trace yaxis: {scaleanchor: "x"} is set automatically in order for pixels to be rendered as squares, setting yaxis: {scaleanchor: false} allows to remove the constraint).
If this axis is linked to another by scaleanchor, this determines the pixel to unit scale ratio. For example, if this value is 10, then every unit on this axis spans 10 times the number of pixels as a unit on the linked axis. Use this for example to create an elevation profile where the vertical scale is exaggerated a fixed amount with respect to the horizontal.
If "true", even 4-digit integers are separated
Determines whether or not a dividers are drawn between the category levels of this axis. Only has an effect on multicategory axes.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not spikes (aka droplines) are drawn for this axis. Note: This only takes affect when hovermode = closest
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether a x (y) axis is positioned at the bottom (left) or top (right) of the plotting area.
Sets the spike color. If undefined, will use the series color
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the drawing mode for the spike line If toaxis, the line is drawn from the data point to the axis the series is plotted on. If across, the line is drawn across the entire plot area, and supercedes toaxis. If marker, then a marker dot is drawn on the axis the series is plotted on
Determines whether spikelines are stuck to the cursor or to the closest datapoints.
Sets the width (in px) of the zero line.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Only for axes with type date or linear. Instead of drawing the major tick label, draw the label for the minor tick that is n positions away from the major tick. E.g. to always draw the label for the minor tick before each major tick, choose ticklabelindex -1. This is useful for date axes with ticklabelmode period if you want to label the period that ends with each major tick instead of the period that begins there.
Sets the source reference on Chart Studio Cloud for ticklabelindex.
Determines where tick labels are drawn with respect to their corresponding ticks and grid lines. Only has an effect for axes of type date When set to period, tick labels are drawn in the middle of the period between ticks.
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. Otherwise on category and multicategory axes the default is allow. In other cases the default is hide past div.
Determines where tick labels are drawn with respect to the axis Please note that top or bottom has no effect on x axes or when ticklabelmode is set to period. Similarly left or right has no effect on y axes or when ticklabelmode is set to period. Has no effect on multicategory axes or when tickson is set to boundaries. When used on axes linked by matches or scaleanchor, no extra padding for inside labels would be added by autorange, so that the scales could match.
Shifts the tick labels by the specified number of pixels in parallel to the axis. Positive values move the labels in the positive direction of the axis.
Sets the standoff distance (in px) between the axis tick labels and their default position. A positive ticklabelstandoff moves the labels farther away from the plot area if ticklabelposition is outside, and deeper into the plot area if ticklabelposition is inside. A negative ticklabelstandoff works in the opposite direction, moving outside ticks towards the plot area and inside ticks towards the outside. If the negative value is large enough, inside ticks can even end up outside and vice versa.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided). If sync, the number of ticks will sync with the overlayed axis set by overlaying property.
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Determines where ticks and grid lines are drawn with respect to their corresponding tick labels. Only has an effect for axes of type category or multicategory. When set to boundaries, ticks and grid lines are drawn half a category to the left/bottom of labels.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the standoff distance (in px) between the axis labels and the title text The default value is a function of the axis tick labels, the title font.size and the axis linewidth. Note that the axis title position is always constrained within the margins, so the actual standoff distance is always less than the set or default value. By setting standoff and turning on automargin, plotly.js will push the margins to fit the axis title at given standoff distance.
Sets the title of this axis.
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Controls persistence of user-driven changes in axis range, autorange, and title if in editable: true configuration. Defaults to layout.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.
If set to an opposite-letter axis id (e.g. x2, y), this axis is bound to the corresponding opposite-letter axis. If set to free, this axis' position is determined by position.
Determines whether long tick labels automatically grow the figure margins.
Determines whether or not the range of this axis is computed in relation to the input data. See rangemode for more info. If range is provided and it has a value for both the lower and upper bound, autorange is set to false. Using min applies autorange only to set the minimum. Using max applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using reversed applies autorange on both ends and reverses the axis direction.
6 nested properties
Clip autorange maximum if it goes beyond this value. Has no effect when autorangeoptions.maxallowed is provided.
Clip autorange minimum if it goes beyond this value. Has no effect when autorangeoptions.minallowed is provided.
Ensure this value is included in autorange.
Sets the source reference on Chart Studio Cloud for include.
Use this value exactly as autorange maximum.
Use this value exactly as autorange minimum.
Automatically reposition the axis to avoid overlap with other axes with the same overlaying value. This repositioning will account for any shift amount applied to other axes on the same side with autoshift is set to true. Only has an effect if anchor is set to free.
When tickangle is set to auto, it will be set to the first angle in this array that is large enough to prevent label overlap.
Using strict a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis type detection. Defaults to layout.autotypenumbers.
Sets the calendar system to use for range and tick0 if this is a date axis. This does not set the calendar for interpreting data on this axis, that's specified in the trace or via the global layout.calendar
Sets the order in which categories on this axis appear. Only has an effect if categoryorder is set to array. Used with categoryorder.
Sets the source reference on Chart Studio Cloud for categoryarray.
Specifies the ordering logic for the case of categorical variables. By default, plotly uses trace, which specifies the order that is present in the data supplied. Set categoryorder to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Set categoryorder to array to derive the ordering from the attribute categoryarray. If a category is not found in the categoryarray array, the sorting behavior for that attribute will be identical to the trace mode. The unspecified categories will follow the categories in categoryarray. Set categoryorder to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines how that happens: by increasing the range, or by decreasing the domain. Default is domain for axes containing image traces, range otherwise.
If this axis needs to be compressed (either due to its own scaleanchor and scaleratio or those of the other axis), determines which direction we push the originally specified plot area. Options are left, center (default), and right for x axes, and top, middle (default), and bottom for y axes.
Sets the color of the dividers Only has an effect on multicategory axes.
Sets the width (in px) of the dividers Only has an effect on multicategory axes.
Sets the domain of this axis (in plot fraction).
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If none, it appears as 1,000,000,000. If e, 1e+9. If E, 1E+9. If power, 1x10^9 (with 9 in a super script). If SI, 1G. If B, 1B.
Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Could be used to set the desired inside range of this axis (excluding the labels) when ticklabelposition of the anchored axis has inside. Not implemented for axes with type log. This would be ignored when range is provided.
Replacement text for specific tick or hover labels. For example using {US: 'USA', CA: 'Canada'} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot's traces If below traces, this axis is displayed below all the subplot's traces, but above the grid lines. Useful when used together with scatter-like traces with cliponaxis set to false to show markers and/or text nodes above this axis.
Sets the axis line color.
Sets the width (in px) of the axis line.
If set to another axis id (e.g. x2, y), the range of this axis will match the range of the corresponding axis in data-coordinates space. Moreover, matching axes share auto-range values, category lists and histogram auto-bins. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Moreover, note that matching axes must have the same type.
Determines the maximum range of this axis.
Determines the minimum range of this axis.
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when tickformat is SI or B.
14 nested properties
Sets the step in-between ticks on this axis. Use with tick0. Must be a positive number, or special strings available to log and date axes. If the axis type is log, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, ... set dtick to 1. To set tick marks at 1, 100, 10000, ... set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, ... set dtick to log_10(5), or 0.69897000433. log has several special values; Lf is a positive number, gives ticks linearly spaced in value (but not position). For example tick0 = 0.1, dtick = L0.5 will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use D1 (all digits) or D2 (only 2 and 5). tick0 is ignored for D1 and D2. If the axis type is date, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, set dtick to 86400000.0. date also has special values Mn must be a positive integer. To set ticks on the 15th of every third month, set tick0 to 2000-01-15 and dtick to M3. To set ticks every 4 years, set dtick to M48
Sets the color of the grid lines.
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Sets the width (in px) of the grid lines.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the tick color.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided).
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If true, the axis lines are mirrored. If ticks, the axis lines and ticks are mirrored. If false, mirroring is disable. If all, axis lines are mirrored on all shared-axes subplots. If allticks, axis lines and ticks are mirrored on all shared-axes subplots.
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to nticks. Has an effect only if tickmode is set to auto.
If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis, with traces and axes visible for both axes. If false, this axis does not overlay any same-letter axes. In this case, for axes with overlapping domains only the highest-numbered axis will be visible.
Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if anchor is set to free.
Sets the range of this axis. If the axis type is log, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis type is date, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axis type is category, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elements null impacts the default autorange.
If normal, the range is computed in relation to the extrema of the input data. If tozero`, the range extends to 0, regardless of the input data If nonnegative, the range is non-negative, regardless of the input data. Applies only to linear axes.
If set to another axis id (e.g. x2, y), the range of this axis changes together with the range of the corresponding axis such that the scale of pixels per unit is in a constant ratio. Both axes are still zoomable, but when you zoom one, the other will zoom the same amount, keeping a fixed midpoint. constrain and constraintoward determine how we enforce the constraint. You can chain these, ie yaxis: {scaleanchor: *x*}, xaxis2: {scaleanchor: *y*} but you can only link axes of the same type. The linked axis can have the opposite letter (to constrain the aspect ratio) or the same letter (to match scales across subplots). Loops (yaxis: {scaleanchor: *x*}, xaxis: {scaleanchor: *y*} or longer) are redundant and the last constraint encountered will be ignored to avoid possible inconsistent constraints via scaleratio. Note that setting axes simultaneously in both a scaleanchor and a matches constraint is currently forbidden. Setting false allows to remove a default constraint (occasionally, you may need to prevent a default scaleanchor constraint from being applied, eg. when having an image trace yaxis: {scaleanchor: "x"} is set automatically in order for pixels to be rendered as squares, setting yaxis: {scaleanchor: false} allows to remove the constraint).
If this axis is linked to another by scaleanchor, this determines the pixel to unit scale ratio. For example, if this value is 10, then every unit on this axis spans 10 times the number of pixels as a unit on the linked axis. Use this for example to create an elevation profile where the vertical scale is exaggerated a fixed amount with respect to the horizontal.
If "true", even 4-digit integers are separated
Moves the axis a given number of pixels from where it would have been otherwise. Accepts both positive and negative values, which will shift the axis either right or left, respectively. If autoshift is set to true, then this defaults to a padding of -3 if side is set to left. and defaults to +3 if side is set to right. Defaults to 0 if autoshift is set to false. Only has an effect if anchor is set to free.
Determines whether or not a dividers are drawn between the category levels of this axis. Only has an effect on multicategory axes.
If all, all exponents are shown besides their significands. If first, only the exponent of the first tick is shown. If last, only the exponent of the last tick is shown. If none, no exponents appear.
Determines whether or not grid lines are drawn. If true, the grid lines are drawn at every tick mark.
Determines whether or not a line bounding this axis is drawn.
Determines whether or not spikes (aka droplines) are drawn for this axis. Note: This only takes affect when hovermode = closest
Determines whether or not the tick labels are drawn.
If all, all tick labels are displayed with a prefix. If first, only the first tick is displayed with a prefix. If last, only the last tick is displayed with a suffix. If none, tick prefixes are hidden.
Same as showtickprefix but for tick suffixes.
Determines whether a x (y) axis is positioned at the bottom (left) or top (right) of the plotting area.
Sets the spike color. If undefined, will use the series color
Sets the dash style of lines. Set to a dash type string (solid, dot, dash, longdash, dashdot, or longdashdot) or a dash length list in px (eg 5px,10px,2px,2px).
Determines the drawing mode for the spike line If toaxis, the line is drawn from the data point to the axis the series is plotted on. If across, the line is drawn across the entire plot area, and supercedes toaxis. If marker, then a marker dot is drawn on the axis the series is plotted on
Determines whether spikelines are stuck to the cursor or to the closest datapoints.
Sets the width (in px) of the zero line.
Sets the placement of the first tick on this axis. Use with dtick. If the axis type is log, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set the tick0 to 2) except when dtick=Ldtick for more info). If the axis type is date, it should be a date string, like date data. If the axis type is category, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.
Sets the angle of the tick labels with respect to the horizontal. For example, a tickangle of -90 draws the tick labels vertically.
Sets the tick color.
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format. We add two items to d3's date formatter: %h for half of the year as a decimal number as well as %{n}f for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat %H~%M~%S.%2f would display 09~15~23.46
Only for axes with type date or linear. Instead of drawing the major tick label, draw the label for the minor tick that is n positions away from the major tick. E.g. to always draw the label for the minor tick before each major tick, choose ticklabelindex -1. This is useful for date axes with ticklabelmode period if you want to label the period that ends with each major tick instead of the period that begins there.
Sets the source reference on Chart Studio Cloud for ticklabelindex.
Determines where tick labels are drawn with respect to their corresponding ticks and grid lines. Only has an effect for axes of type date When set to period, tick labels are drawn in the middle of the period between ticks.
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. Otherwise on category and multicategory axes the default is allow. In other cases the default is hide past div.
Determines where tick labels are drawn with respect to the axis Please note that top or bottom has no effect on x axes or when ticklabelmode is set to period. Similarly left or right has no effect on y axes or when ticklabelmode is set to period. Has no effect on multicategory axes or when tickson is set to boundaries. When used on axes linked by matches or scaleanchor, no extra padding for inside labels would be added by autorange, so that the scales could match.
Shifts the tick labels by the specified number of pixels in parallel to the axis. Positive values move the labels in the positive direction of the axis.
Sets the standoff distance (in px) between the axis tick labels and their default position. A positive ticklabelstandoff moves the labels farther away from the plot area if ticklabelposition is outside, and deeper into the plot area if ticklabelposition is inside. A negative ticklabelstandoff works in the opposite direction, moving outside ticks towards the plot area and inside ticks towards the outside. If the negative value is large enough, inside ticks can even end up outside and vice versa.
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled. tick0 determines which labels are shown. Not implemented for axes with type log or multicategory, or when tickmode is array.
Sets the tick length (in px).
Sets the tick mode for this axis. If auto, the number of ticks is set via nticks. If linear, the placement of the ticks is determined by a starting position tick0 and a tick step dtick (linear is the default value if tick0 and dtick are provided). If array, the placement of the ticks is set via tickvals and the tick text is ticktext. (array is the default value if tickvals is provided). If sync, the number of ticks will sync with the overlayed axis set by overlaying property.
Sets a tick label prefix.
Determines whether ticks are drawn or not. If **, this axis' ticks are not drawn. If outside (inside), this axis' are drawn outside (inside) the axis lines.
Determines where ticks and grid lines are drawn with respect to their corresponding tick labels. Only has an effect for axes of type category or multicategory. When set to boundaries, ticks and grid lines are drawn half a category to the left/bottom of labels.
Sets a tick label suffix.
Sets the text displayed at the ticks position via tickvals. Only has an effect if tickmode is set to array. Used with tickvals.
Sets the source reference on Chart Studio Cloud for ticktext.
Sets the values at which ticks on this axis appear. Only has an effect if tickmode is set to array. Used with ticktext.
Sets the source reference on Chart Studio Cloud for tickvals.
Sets the tick width (in px).
3 nested properties
9 nested properties
HTML font family - the typeface that will be applied by the web browser. The web browser can only apply a font if it is available on the system where it runs. Provide multiple font families, separated by commas, to indicate the order in which to apply fonts if they aren't available.
Sets the kind of decoration line(s) with text, such as an under, over or through as well as combinations e.g. under+over, etc.
Sets the shape and color of the shadow behind text. auto places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
Sets whether a font should be styled with a normal or italic face from its family.
Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
Sets the variant of the font.
Sets the weight (or boldness) of the font.
Sets the standoff distance (in px) between the axis labels and the title text The default value is a function of the axis tick labels, the title font.size and the axis linewidth. Note that the axis title position is always constrained within the margins, so the actual standoff distance is always less than the set or default value. By setting standoff and turning on automargin, plotly.js will push the margins to fit the axis title at given standoff distance.
Sets the title of this axis.
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
Controls persistence of user-driven changes in axis range, autorange, and title if in editable: true configuration. Defaults to layout.uirevision.
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
Determines whether or not a line is drawn at along the 0 value of this axis. If true, the zero line is drawn on top of the grid lines.
Sets the line color of the zero line.
Sets the width (in px) of the zero line.