Skip to content

Commit

Permalink
[Term Entry] Python:Plotly Express: .scatter_3d()
Browse files Browse the repository at this point in the history
* new term added scatter3d()

* Added the output images

* Update scatter_3d.md

* Rename scatter_3d.md to scatter-3d.md

* Update scatter-3d.md

* Update scatter.md

updating scatter.md

* Update scatter-3d.md

fixed content

* Rename scatter-3d.md to scatter-3d.md

file name changed

* Update scatter-3d.md

* Update scatter-3d.md

fixed link

* Minor changes

---------
  • Loading branch information
pritamjr authored Nov 9, 2024
1 parent 3fa778e commit e075696
Show file tree
Hide file tree
Showing 3 changed files with 85 additions and 0 deletions.
85 changes: 85 additions & 0 deletions content/plotly/concepts/express/terms/scatter-3d/scatter-3d.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
---
Title: '.scatter_3d()'
Description: 'Creates a 3D scatter plot to visualize data points across three dimensions (x, y, z) with options for color, size, and hover data.'
Subjects:
- 'Data Science'
- 'Data Visualization'
Tags:
- 'Graphs'
- 'Libraries'
- 'Plotly'
- 'Data'
CatalogContent:
- 'learn-python-3'
- 'paths/computer-science'
---

The **`.scatter_3d()`** method in the `plotly.express` module creates a 3D scatter plot to visualize the relationships between three variables using markers in a three-dimensional space. The data points are plotted based on their values on the `x`, `y`, and `z` axes. It also allows customizing marker colors, sizes, and symbols.

## Syntax

The `x`, `y`, and `z` parameters are required and accept values as a string, integer, `Series`, or array-like object, representing the data for each axis. Optional parameters, such as `color`, `symbol`, and `size`, customize the markers' appearance. If `data_frame` is not provided, a `DataFrame` will be constructed from other arguments.

```pseudo
plotly.express.scatter_3d(data_frame=None, x=None, y=None, z=None, color=None, symbol=None, size=None, ...)
```

- `data_frame`: The Pandas [`DataFrame`](https://www.codecademy.com/resources/docs/pandas/dataframe) containing the data to visualize.
- `x`: The column name in `data_frame`, `Series`, or array-like object for x-axis data.
- `y`: The column name in `data_frame`, `Series`, or array-like object for y-axis data.
- `z`: The column name in `data_frame`, `Series`, or array-like object for z-axis data.
- `color`: The column name in `data_frame`, `Series`, or array-like object to specify marker colors.
- `symbol`: The column name in `data_frame`, `Series`, or array-like object for assigning marker symbols.
- `size`: The column name in `data_frame`, `Series`, or array-like object to assign marker sizes.

> **Note:** The ellipsis in the syntax (...) indicates additional optional parameters that can be used to customize the plot further.
## Examples

The examples below demonstrate how the [`.scatter()`](https://www.codecademy.com/resources/docs/plotly/express/scatter) method creates a 2D scatter plot, while the `.scatter_3d()` method provides a more complex visualization in three dimensions, utilizing additional parameters for color and symbol customization.

### Example 1

The following example demonstrates the use of the `.scatter()` method:

```py
# Defining 'x' and 'y' as array-like objects
import plotly.express as px
x = [1, 3, 5, 7, 9]
y = [4, 6, 5, 8, 2]

# Creating a scatter plot
fig = px.scatter(x = x, y = y)

# Displaying the plot
fig.show()
```

The output for the above code is as follows:

![The output for the above example](https://raw.githubusercontent.com/Codecademy/docs/main/media/plotlyScatter3dOutput1.png)

### Example 2

This example illustrates the use of the `.scatter_3d()` method, showcasing its capability to utilize more parameters for enhanced visualization:

```py
import plotly.express as px

# Sample Data
x = [1, 3, 5, 7, 9]
y = [4, 6, 5, 8, 2]
z = [7, 2, 9, 4, 8]
color = ['red', 'green', 'blue', 'purple', 'orange']
symbol = ['circle', 'square', 'diamond', 'star', 'triangle-up']

# Creating a 3D scatter plot
fig = px.scatter_3d(x=x, y=y, z=z, color=color, symbol=symbol, title="3D Scatter Plot with Colors and Symbols")

# Displaying the plot
fig.show()
```

The above code produces the following output:

![The output for the above example](https://raw.githubusercontent.com/Codecademy/docs/main/media/plotlyScatter3dOutput2.png)
Binary file added media/plotlyScatter3dOutput1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added media/plotlyScatter3dOutput2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit e075696

Please sign in to comment.