plotly.py-docs/generated/plotly.graph_objects.Box.html at debug · plotly/plotly.py-docs

History

478 lines (446 loc) · 40.5 KB

Raw

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

323

324

325

326

327

328

329

330

331

332

333

334

335

336

337

338

339

340

341

342

343

344

345

346

347

348

349

350

351

352

353

354

355

356

357

358

359

360

361

362

363

364

365

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

382

383

384

385

386

387

388

389

390

391

392

393

394

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

415

416

417

418

419

420

421

422

423

424

425

426

427

428

429

430

431

432

433

434

435

436

437

438

439

440

441

442

443

444

445

446

447

448

449

450

451

452

453

454

455

456

457

458

459

460

461

462

463

464

465

466

467

468

469

470

471

472

473

474

475

476

477

478

<!DOCTYPE html>

<head>

<title>plotly.graph_objects.Box — 4.6.0 documentation</title>

</head><body>

</button>

</a>

</div>

<a role="button"

id="dLabelGlobalToc"

data-toggle="dropdown"

data-target="#"

href="../index.html">Site </a>

<ul class="dropdown-menu globaltoc"

role="menu"

aria-labelledby="dLabelGlobalToc"><ul class="current">

<li class="toctree-l1"><a class="reference internal" href="../plotly.express.html"><code class="docutils literal notranslate">plotly.express</code>: high-level interface for data visualization</a></li>

<li class="toctree-l1 current"><a class="reference internal" href="../plotly.graph_objects.html"><code class="docutils literal notranslate">plotly.graph_objects</code>: low-level interface to figures, traces and layout</a></li>

<li class="toctree-l1"><a class="reference internal" href="../plotly.subplots.html"><code class="docutils literal notranslate">plotly.subplots</code>: helper function for laying out multi-plot figures</a></li>

<li class="toctree-l1"><a class="reference internal" href="../plotly.figure_factory.html"><code class="docutils literal notranslate">plotly.figure_factory</code>: helper methods for building specific complex charts</a></li>

<li class="toctree-l1"><a class="reference internal" href="../plotly.io.html"><code class="docutils literal notranslate">plotly.io</code>: low-level interface for displaying, reading and writing figures</a></li>

</ul>

</li>

<a role="button"

id="dLabelLocalToc"

data-toggle="dropdown"

data-target="#"

href="#">Page </a>

<ul class="dropdown-menu localtoc"

role="menu"

aria-labelledby="dLabelLocalToc"><ul>

<li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate">plotly.graph_objects</code>.Box</a></li>

<li><a class="reference internal" href="#id1"><code class="xref py py-mod docutils literal notranslate">plotly.graph_objects</code>.box</a></li>

</ul>

</li>

<li>

<a href="plotly.graph_objects.Table.html" title="Previous Chapter: plotly.graph_objects.Table">« plotly.graph_...

</a>

</li>

<li>

<a href="plotly.graph_objects.Violin.html" title="Next Chapter: plotly.graph_objects.Violin">plotly.graph_... »

</a>

</li>

</ul>

</div>

</form>

</div>

<h1><a class="reference internal" href="plotly.graph_objects.html#module-plotly.graph_objects" title="plotly.graph_objects"><code class="xref py py-mod docutils literal notranslate">plotly.graph_objects</code></a>.Box<a class="headerlink" href="#plotly-graph-objs-box" title="Permalink to this headline">¶</a></h1>

class <code class="sig-prename descclassname">plotly.graph_objects.</code><code class="sig-name descname">Box</code>(arg=None, alignmentgroup=None, boxmean=None, boxpoints=None, customdata=None, customdatasrc=None, dx=None, dy=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, hovertemplate=None, hovertemplatesrc=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, jitter=None, legendgroup=None, line=None, lowerfence=None, lowerfencesrc=None, marker=None, mean=None, meansrc=None, median=None, mediansrc=None, meta=None, metasrc=None, name=None, notched=None, notchspan=None, notchspansrc=None, notchwidth=None, offsetgroup=None, opacity=None, orientation=None, pointpos=None, q1=None, q1src=None, q3=None, q3src=None, quartilemethod=None, sd=None, sdsrc=None, selected=None, selectedpoints=None, showlegend=None, stream=None, text=None, textsrc=None, uid=None, uirevision=None, unselected=None, upperfence=None, upperfencesrc=None, visible=None, whiskerwidth=None, width=None, x=None, x0=None, xaxis=None, xcalendar=None, xsrc=None, y=None, y0=None, yaxis=None, ycalendar=None, ysrc=None, **kwargs)<a class="headerlink" href="#plotly.graph_objects.Box" title="Permalink to this definition">¶</a></dt>

<code class="sig-name descname">__init__</code>(arg=None, alignmentgroup=None, boxmean=None, boxpoints=None, customdata=None, customdatasrc=None, dx=None, dy=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, hovertemplate=None, hovertemplatesrc=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, jitter=None, legendgroup=None, line=None, lowerfence=None, lowerfencesrc=None, marker=None, mean=None, meansrc=None, median=None, mediansrc=None, meta=None, metasrc=None, name=None, notched=None, notchspan=None, notchspansrc=None, notchwidth=None, offsetgroup=None, opacity=None, orientation=None, pointpos=None, q1=None, q1src=None, q3=None, q3src=None, quartilemethod=None, sd=None, sdsrc=None, selected=None, selectedpoints=None, showlegend=None, stream=None, text=None, textsrc=None, uid=None, uirevision=None, unselected=None, upperfence=None, upperfencesrc=None, visible=None, whiskerwidth=None, width=None, x=None, x0=None, xaxis=None, xcalendar=None, xsrc=None, y=None, y0=None, yaxis=None, ycalendar=None, ysrc=None, **kwargs)<a class="headerlink" href="#plotly.graph_objects.Box.__init__" title="Permalink to this definition">¶</a></dt>

<dd>Construct a new Box object

Each box spans from quartile 1 (Q1) to quartile 3 (Q3). The

second quartile (Q2, i.e. the median) is marked by a line

inside the box. The fences grow outward from the boxes’ edges,

by default they span +/- 1.5 times the interquartile range

(IQR: Q3-Q1), The sample mean and standard deviation as well as

notches and the sample, outlier and suspected outliers points

can be optionally added to the box plot. The values and

positions corresponding to each boxes can be input using two

signatures. The first signature expects users to supply the

sample values in the <code class="docutils literal notranslate">y</code> data array for vertical boxes (<code class="docutils literal notranslate">x</code> for

horizontal boxes). By supplying an <code class="docutils literal notranslate">x</code> (<code class="docutils literal notranslate">y</code>) array, one box per

distinct <code class="docutils literal notranslate">x</code> (<code class="docutils literal notranslate">y</code>) value is drawn If no <code class="docutils literal notranslate">x</code> (<code class="docutils literal notranslate">y</code>) list is

provided, a single box is drawn. In this case, the box is

positioned with the trace <code class="docutils literal notranslate">name</code> or with <code class="docutils literal notranslate">x0</code> (<code class="docutils literal notranslate">y0</code>) if

provided. The second signature expects users to supply the

boxes corresponding Q1, median and Q3 statistics in the <code class="docutils literal notranslate">q1</code>,

<code class="docutils literal notranslate">median</code> and <code class="docutils literal notranslate">q3</code> data arrays respectively. Other box features

relying on statistics namely <code class="docutils literal notranslate">lowerfence</code>, <code class="docutils literal notranslate">upperfence</code>,

<code class="docutils literal notranslate">notchspan</code> can be set directly by the users. To have plotly

compute them or to show sample points besides the boxes, users

can set the <code class="docutils literal notranslate">y</code> data array for vertical boxes (<code class="docutils literal notranslate">x</code> for

horizontal boxes) to a 2D array with the outer length

corresponding to the number of boxes in the traces and the

inner length corresponding the sample size.

<dt class="field-odd">Parameters</dt>

<li>arg – dict of properties compatible with this constructor or

an instance of <a class="reference internal" href="#plotly.graph_objects.Box" title="plotly.graph_objects.Box"><code class="xref py py-class docutils literal notranslate">plotly.graph_objects.Box</code></a></li>

<li>alignmentgroup – 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.</li>

<li>boxmean – 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 <code class="docutils literal notranslate">mean</code> is set. Defaults to “sd”

when <code class="docutils literal notranslate">sd</code> is set Otherwise defaults to False.</li>

<li>boxpoints – If “outliers”, only the sample points lying outside the

whiskers are shown If “suspectedoutliers”, the outlier

points are shown and points either less than 4*Q1-3*Q3

or greater than 4*Q3-3*Q1 are highlighted (see

<code class="docutils literal notranslate">outliercolor</code>) If “all”, all sample points are shown

If False, only the box(es) are shown with no sample

points Defaults to “suspectedoutliers” when

<code class="docutils literal notranslate">marker.outliercolor</code> or <code class="docutils literal notranslate">marker.line.outliercolor</code> is

set. Defaults to “all” under the q1/median/q3

signature. Otherwise defaults to “outliers”.</li>

<li>customdata – 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</li>

<li>customdatasrc – Sets the source reference on Chart Studio Cloud for

customdata .</li>

<li>dx – Sets the x coordinate step for multi-box traces set

using q1/median/q3.</li>

<li>dy – Sets the y coordinate step for multi-box traces set

using q1/median/q3.</li>

<li>fillcolor – Sets the fill color. Defaults to a half-transparent

variant of the line color, marker color, or marker line

color, whichever is available.</li>

<li>hoverinfo – Determines which trace information appear on hover. If

<code class="docutils literal notranslate">none</code> or <code class="docutils literal notranslate">skip</code> are set, no information is displayed

upon hovering. But, if <code class="docutils literal notranslate">none</code> is set, click and hover

events are still fired.</li>

<li>hoverinfosrc – Sets the source reference on Chart Studio Cloud for

hoverinfo .</li>

<li>hoverlabel – <a class="reference internal" href="plotly.graph_objects.box.html#plotly.graph_objects.box.Hoverlabel" title="plotly.graph_objects.box.Hoverlabel"><code class="xref py py-class docutils literal notranslate">plotly.graph_objects.box.Hoverlabel</code></a> instance

or dict with compatible properties</li>

<li>hoveron – Do the hover effects highlight individual boxes or

sample points or both?</li>

<li>hovertemplate – Template string used for rendering the information that

appear on hover box. Note that this will override

<code class="docutils literal notranslate">hoverinfo</code>. 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-3.x-api-

reference/blob/master/Formatting.md#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-3.x-api-

reference/blob/master/Time-Formatting.md#format for

details on the date formatting syntax. The variables

available in <code class="docutils literal notranslate">hovertemplate</code> are the ones emitted as

event data described at this link

<a class="reference external" href="https://plotly.com/javascript/plotlyjs-events/#event">https://plotly.com/javascript/plotlyjs-events/#event</a>-

data. Additionally, every attributes that can be

specified per-point (the ones that are <code class="docutils literal notranslate">arrayOk: true</code>)

are available. Anything contained in tag <code class="docutils literal notranslate"><extra></code> is

displayed in the secondary box, for example

“<extra>{fullData.name}</extra>”. To hide the secondary

box completely, use an empty tag <code class="docutils literal notranslate"><extra></extra></code>.</li>

<li>hovertemplatesrc – Sets the source reference on Chart Studio Cloud for

hovertemplate .</li>

<li>hovertext – Same as <code class="docutils literal notranslate">text</code>.</li>

<li>hovertextsrc – Sets the source reference on Chart Studio Cloud for

hovertext .</li>

<li>ids – 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.</li>

<li>idssrc – Sets the source reference on Chart Studio Cloud for

ids .</li>

<li>jitter – 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).</li>

<li>legendgroup – Sets the legend group for this trace. Traces part of

the same legend group hide/show at the same time when

toggling legend items.</li>

<li>line – <a class="reference internal" href="plotly.graph_objects.box.html#plotly.graph_objects.box.Line" title="plotly.graph_objects.box.Line"><code class="xref py py-class docutils literal notranslate">plotly.graph_objects.box.Line</code></a> instance or dict

with compatible properties</li>

<li>lowerfence – 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

<code class="docutils literal notranslate">lowerfence</code> is not provided but a sample (in <code class="docutils literal notranslate">y</code> or

<code class="docutils literal notranslate">x</code>) is set, we compute the lower as the last sample

point below 1.5 times the IQR.</li>

<li>lowerfencesrc – Sets the source reference on Chart Studio Cloud for

lowerfence .</li>

<li>marker – <a class="reference internal" href="plotly.graph_objects.box.html#plotly.graph_objects.box.Marker" title="plotly.graph_objects.box.Marker"><code class="xref py py-class docutils literal notranslate">plotly.graph_objects.box.Marker</code></a> instance or

dict with compatible properties</li>

<li>mean – 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 <code class="docutils literal notranslate">mean</code> is not

provided but a sample (in <code class="docutils literal notranslate">y</code> or <code class="docutils literal notranslate">x</code>) is set, we

compute the mean for each box using the sample values.</li>

<li>meansrc – Sets the source reference on Chart Studio Cloud for

mean .</li>

<li>median – Sets the median values. There should be as many items

as the number of boxes desired.</li>

<li>mediansrc – Sets the source reference on Chart Studio Cloud for

median .</li>

<li>meta – Assigns extra meta information associated with this

trace that can be used in various text attributes.

Attributes such as trace <code class="docutils literal notranslate">name</code>, graph, axis and

colorbar <code class="docutils literal notranslate">title.text</code>, annotation <code class="docutils literal notranslate">text</code>

<code class="docutils literal notranslate">rangeselector</code>, <code class="docutils literal notranslate">updatemenues</code> and <code class="docutils literal notranslate">sliders</code> <code class="docutils literal notranslate">label</code>

text all support <code class="docutils literal notranslate">meta</code>. To access the trace <code class="docutils literal notranslate">meta</code>

values in an attribute in the same trace, simply use

<code class="docutils literal notranslate">%{meta[i]}</code> where <code class="docutils literal notranslate">i</code> is the index or key of the

<code class="docutils literal notranslate">meta</code> item in question. To access trace <code class="docutils literal notranslate">meta</code> in

layout attributes, use <code class="docutils literal notranslate">%{data[n[.meta[i]}</code> where <code class="docutils literal notranslate">i</code>

is the index or key of the <code class="docutils literal notranslate">meta</code> and <code class="docutils literal notranslate">n</code> is the trace

index.</li>

<li>metasrc – Sets the source reference on Chart Studio Cloud for

meta .</li>

<li>name – Sets the trace name. The trace name appear as the

legend item and on hover. For box traces, the name will

also be used for the position coordinate, if <code class="docutils literal notranslate">x</code> and

<code class="docutils literal notranslate">x0</code> (<code class="docutils literal notranslate">y</code> and <code class="docutils literal notranslate">y0</code> if horizontal) are missing and the

position axis is categorical</li>

<li>notched – 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 <a class="reference external" href="https://sites.google.com/site/davidsstatistics/home">https://sites.google.com/site/davidsstatistics/home</a>

/notched-box-plots for more info. Defaults to False

unless <code class="docutils literal notranslate">notchwidth</code> or <code class="docutils literal notranslate">notchspan</code> is set.</li>

<li>notchspan – Sets the notch span from the boxes’ <code class="docutils literal notranslate">median</code> 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 <code class="docutils literal notranslate">notchspan</code> is not provided

but a sample (in <code class="docutils literal notranslate">y</code> or <code class="docutils literal notranslate">x</code>) is set, we compute it as

1.57 * IQR / sqrt(N), where N is the sample size.</li>

<li>notchspansrc – Sets the source reference on Chart Studio Cloud for

notchspan .</li>

<li>notchwidth – Sets the width of the notches relative to the box’

width. For example, with 0, the notches are as wide as

the box(es).</li>

<li>offsetgroup – 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.</li>

<li>opacity – Sets the opacity of the trace.</li>

<li>orientation – Sets the orientation of the box(es). If “v” (“h”), the

distribution is visualized along the vertical

(horizontal).</li>

<li>pointpos – 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</li>

<li>q1 – Sets the Quartile 1 values. There should be as many

items as the number of boxes desired.</li>

<li>q1src – Sets the source reference on Chart Studio Cloud for q1

.</li>

<li>q3 – Sets the Quartile 3 values. There should be as many

items as the number of boxes desired.</li>

<li>q3src – Sets the source reference on Chart Studio Cloud for q3

.</li>

<li>quartilemethod – 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 <a class="reference external" href="http://www.amstat.org/publication">http://www.amstat.org/publication</a>

s/jse/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.</li>

<li>sd – 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 <code class="docutils literal notranslate">sd</code> is not provided but a sample (in <code class="docutils literal notranslate">y</code>

or <code class="docutils literal notranslate">x</code>) is set, we compute the standard deviation for

each box using the sample values.</li>

<li>sdsrc – Sets the source reference on Chart Studio Cloud for sd

.</li>

<li>selected – <a class="reference internal" href="plotly.graph_objects.box.html#plotly.graph_objects.box.Selected" title="plotly.graph_objects.box.Selected"><code class="xref py py-class docutils literal notranslate">plotly.graph_objects.box.Selected</code></a> instance or

dict with compatible properties</li>

<li>selectedpoints – 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 <code class="docutils literal notranslate">unselected</code> are turned on for all points, whereas,

any other non-array values means no selection all where

the <code class="docutils literal notranslate">selected</code> and <code class="docutils literal notranslate">unselected</code> styles have no effect.</li>

<li>showlegend – Determines whether or not an item corresponding to this

trace is shown in the legend.</li>

<li>stream – <a class="reference internal" href="plotly.graph_objects.box.html#plotly.graph_objects.box.Stream" title="plotly.graph_objects.box.Stream"><code class="xref py py-class docutils literal notranslate">plotly.graph_objects.box.Stream</code></a> instance or

dict with compatible properties</li>

<li>text – 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 <code class="docutils literal notranslate">hoverinfo</code> must contain

a “text” flag.</li>

<li>textsrc – Sets the source reference on Chart Studio Cloud for

text .</li>

<li>uid – Assign an id to this trace, Use this to provide object

constancy between traces during animations and

transitions.</li>

<li>uirevision – Controls persistence of some user-driven changes to the

trace: <code class="docutils literal notranslate">constraintrange</code> in <code class="docutils literal notranslate">parcoords</code> traces, as well

as some <code class="docutils literal notranslate">editable: true</code> modifications such as <code class="docutils literal notranslate">name</code>

and <code class="docutils literal notranslate">colorbar.title</code>. Defaults to <code class="docutils literal notranslate">layout.uirevision</code>.

Note that other user-driven trace attribute changes are

controlled by <code class="docutils literal notranslate">layout</code> attributes: <code class="docutils literal notranslate">trace.visible</code> is

controlled by <code class="docutils literal notranslate">layout.legend.uirevision</code>,

<code class="docutils literal notranslate">selectedpoints</code> is controlled by

<code class="docutils literal notranslate">layout.selectionrevision</code>, and <code class="docutils literal notranslate">colorbar.(x|y)</code>

(accessible with <code class="docutils literal notranslate">config: {editable: true}</code>) is

controlled by <code class="docutils literal notranslate">layout.editrevision</code>. Trace changes are

tracked by <code class="docutils literal notranslate">uid</code>, which only falls back on trace index

if no <code class="docutils literal notranslate">uid</code> is provided. So if your app can add/remove

traces before the end of the <code class="docutils literal notranslate">data</code> array, such that

the same trace has a different index, you can still

preserve user-driven changes if you give each trace a

<code class="docutils literal notranslate">uid</code> that stays with it as it moves.</li>

<li>unselected – <a class="reference internal" href="plotly.graph_objects.box.html#plotly.graph_objects.box.Unselected" title="plotly.graph_objects.box.Unselected"><code class="xref py py-class docutils literal notranslate">plotly.graph_objects.box.Unselected</code></a> instance

or dict with compatible properties</li>

<li>upperfence – 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

<code class="docutils literal notranslate">upperfence</code> is not provided but a sample (in <code class="docutils literal notranslate">y</code> or

<code class="docutils literal notranslate">x</code>) is set, we compute the lower as the last sample

point above 1.5 times the IQR.</li>

<li>upperfencesrc – Sets the source reference on Chart Studio Cloud for

upperfence .</li>

<li>visible – 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).</li>

<li>whiskerwidth – Sets the width of the whiskers relative to the box’

width. For example, with 1, the whiskers are as wide as

the box(es).</li>

<li>width – 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.</li>

<li>x – Sets the x sample data or coordinates. See overview for

more info.</li>

<li>x0 – 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.</li>

<li>xaxis – 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 <code class="docutils literal notranslate">layout.xaxis</code>. If “x2”, the x

coordinates refer to <code class="docutils literal notranslate">layout.xaxis2</code>, and so on.</li>

<li>xcalendar – Sets the calendar system to use with <code class="docutils literal notranslate">x</code> date data.</li>

<li>xsrc – Sets the source reference on Chart Studio Cloud for x

.</li>

<li>y – Sets the y sample data or coordinates. See overview for

more info.</li>

<li>y0 – 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.</li>

<li>yaxis – 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 <code class="docutils literal notranslate">layout.yaxis</code>. If “y2”, the y

coordinates refer to <code class="docutils literal notranslate">layout.yaxis2</code>, and so on.</li>

<li>ycalendar – Sets the calendar system to use with <code class="docutils literal notranslate">y</code> date data.</li>

<li>ysrc – Sets the source reference on Chart Studio Cloud for y

.</li>

</ul>

</dd>

<dt class="field-even">Returns</dt>

</dd>

<dt class="field-odd">Return type</dt>

</dd>

</dl>

</dd></dl>

</div>

<h1><a class="reference internal" href="plotly.graph_objects.html#module-plotly.graph_objects" title="plotly.graph_objects"><code class="xref py py-mod docutils literal notranslate">plotly.graph_objects</code></a>.box<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h1>

</colgroup>

<tbody>

<tr class="row-odd"><td><a class="reference internal" href="#module-plotly.graph_objects.box" title="plotly.graph_objects.box"><code class="xref py py-obj docutils literal notranslate">plotly.graph_objects.box</code></a></td>

</tr>

</tbody>

</table>

</div>

var _gaq = _gaq || [];

_gaq.push(['_setAccount', 'UA-39373211-1']);

_gaq.push(['_setDomainName', 'none']);

_gaq.push(['_setAllowLinker', true]);

_gaq.push(['_trackPageview']);

(function() {

var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;

ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';

var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);

})();

</script>

</body>

</html>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FilesExpand file tree

plotly.graph_objects.Box.html

Latest commit

History

plotly.graph_objects.Box.html

File metadata and controls