% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/easy_plots.R
\name{easy_scatter}
\alias{easy_scatter}
\title{Scatter Plot with Regression Line and Correlation Annotation}
\usage{
easy_scatter(
  formula,
  data,
  color_by = NULL,
  smooth = TRUE,
  ellipse = TRUE,
  title = NULL
)
}
\arguments{
\item{formula}{A formula: \code{y ~ x}.}

\item{data}{A data frame.}

\item{color_by}{Optional column name to color points by a third variable.}

\item{smooth}{Logical; show regression line? Default \code{TRUE}.}

\item{ellipse}{Logical; draw a 95\% data ellipse? Default \code{TRUE}.}

\item{title}{Custom plot title.}
}
\value{
An \code{"easystat_result"} object with \code{plot_object}.
}
\description{
Draws a scatter plot for two numeric variables, overlays a linear regression
line with confidence band, and annotates the Pearson r and p-value.
}
