Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New term added scatter3d() #5194

Open
wants to merge 14 commits into
base: main
Choose a base branch
from

Conversation

pritamjr
Copy link

@pritamjr pritamjr commented Sep 7, 2024

Description

Added a new term entry on the .scatter_3d() method of the express in the path docs/content/plotly/concepts/express/terms/scatter_3d under the file name scatter_3d.md

Issue Solved

Closes - [Term Entry] Python Plotly - express .scatter_3d() #5169

Type of Change

  • Adding a new entry
  • Updating the documentation

Checklist

  • All writings are my own.
  • My entry follows the Codecademy Docs style guide.
  • My changes generate no new warnings.
  • I have performed a self-review of my own writing and code.
  • I have checked my entry and corrected any misspellings.
  • I have made corresponding changes to the documentation if needed.
  • I have confirmed my changes are not being pushed from my forked main branch.
  • I have confirmed that I'm pushing from a new branch named after the changes I'm making.
  • I have linked any issues that are relevant to this PR in the Issues Solved section.

@CLAassistant
Copy link

CLAassistant commented Sep 7, 2024

CLA assistant check
All committers have signed the CLA.

@cigar-galaxy82 cigar-galaxy82 self-assigned this Sep 7, 2024
@cigar-galaxy82
Copy link
Contributor

Hi @pritamjr thank you for contributing to Codecademy docs, I have suggested a few changes please modify them and change the folder and the file name to [scatter-3d/scatter-3d.md

@@ -0,0 +1,80 @@
---
Title: '.scatter_3d()'
Description: 'The .scatter_3d() method in the Plotly library creates a 3D scatter plot, displaying data points based on their values on the x, y, and z axes. This is a powerful tool for visualizing the relationships between three numerical variables in a three-dimensional space, with the option to add color, symbol, and size to the markers for more customization.'
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Description: 'The .scatter_3d() method in the Plotly library creates a 3D scatter plot, displaying data points based on their values on the x, y, and z axes. This is a powerful tool for visualizing the relationships between three numerical variables in a three-dimensional space, with the option to add color, symbol, and size to the markers for more customization.'
Description: 'The .scatter_3d() method in the Plotly library creates a 3D scatter plot, displaying data points based on their values on the x, y, and z axes.'

- '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` and `y` axes. It also allows customizing marker colors, sizes, and symbols.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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` and `y` axes. It also allows customizing marker colors, sizes, and symbols.
The **`.scatter_3d()`** method in the ![Plotly Express module](https://www.codecademy.com/resources/docs/plotly/express) 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.


# Displaying the plot
fig.show()

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove blank line 75

Comment on lines 25 to 31
- `data_frame`: The Pandas [`DataFrame`](https://www.codecademy.com/resources/docs/pandas/dataframe) holding 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 specifying marker colors.
- `symbol`: The column name in `data_frame`, `Series` or array_like object assigning marker symbols.
- `size`: The column name in `data_frame`, `Series` or array_like object assgining marker sizes.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- `data_frame`: The Pandas [`DataFrame`](https://www.codecademy.com/resources/docs/pandas/dataframe) holding 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 specifying marker colors.
- `symbol`: The column name in `data_frame`, `Series` or array_like object assigning marker symbols.
- `size`: The column name in `data_frame`, `Series` or array_like object assgining marker sizes.
- `data_frame`: The Pandas [`DataFrame`](https://www.codecademy.com/resources/docs/pandas/dataframe) holding 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 specifying marker colors.
- `symbol`: The column name in `data_frame`, `Series` or array_like object assigning marker symbols.
- `size`: The column name in `data_frame`, `Series` or array_like object assigning marker sizes.


The parameters `x`, `y`, and `z` parameters are required and represent either a string, integer, `Series`, or array-like object. Other parameters such as `color`, `symbol`, and `size` are optional and can customize the appearance of the markers. If `data_frame` is missing, a `DataFrame` is constructed using the other arguments.

> Note: The ellipsis in the syntax (...) indicates additional optional parameters that can be used to further customize the plot.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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


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

## Example
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Example
## Example 1


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

Here is another example that customizes the 3D scatter plot with colors and symbols for the data points:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Here is another example that customizes the 3D scatter plot with colors and symbols for the data points:
The below example demonstrates the use of the `.scatter_3d()` method

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also add an heading as Example 2 before this example

@mamtawardhani
Copy link
Collaborator

@pritamjr are you still working on this?
If you do not revert back within the next 3 days, I'll have to unassign you and close this PR

@mamtawardhani
Copy link
Collaborator

mamtawardhani commented Oct 31, 2024

@Sriparno08 I was planning to make the changes by myself, as I think since this issue is old, we can close it. However, this PR has the scatter.md file as well, how should I proceed here, please help

I guess I'll have to do it from my device and unstage the scatter.md file, correct me if i'm wrong

@Sriparno08
Copy link
Collaborator

Hey @mamtawardhani, you can do one thing. You can copy the contents from the scatter.md file in the main branch to the scatter.md file in the PR branch. This way, the scatter.md file will most probably vanish from the 'Files changed' tab.

Copy link
Collaborator

@mamtawardhani mamtawardhani left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for contributing to Codecademy Docs @pritamjr 😄

The entry looks good for a second round of review 🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants