Skip to content

Commit 4c14ba4

Browse files
committed
Merge branch 'source-design-merge' of https://github.com/plotly/documentation into source-design-merge
2 parents d87210b + f9384b1 commit 4c14ba4

File tree

7 files changed

+935
-0
lines changed

7 files changed

+935
-0
lines changed

_includes/documentation_eg.html

Lines changed: 89 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,21 @@
4646
{% elsif page.display_as == "real_dataset" %}
4747
{% assign real_dataset = true %}
4848
<!-- END OF SCIKIT CUSTOM LAYOUT -->
49+
50+
<!-- START OF NUMPY CUSTOM LAYOUT -->
51+
{% elsif page.display_as == "getting-started" %}
52+
{% assign getting-started = true %}
53+
{% elsif page.display_as == "numpy-array" %}
54+
{% assign numpy-array = true %}
55+
{% elsif page.display_as == "modify-the-array" %}
56+
{% assign modify-the-array = true %}
57+
{% elsif page.display_as == "return-a-value" %}
58+
{% assign return-a-value = true %}
59+
{% elsif page.display_as == "numpy-random" %}
60+
{% assign numpy-random = true %}
61+
{% elsif page.display_as == "numpy-statistics" %}
62+
{% assign numpy-statistics = true %}
63+
<!-- END OF NUMPY CUSTOM LAYOUT -->
4964
{% endif %}
5065
{% endfor %}
5166

@@ -142,6 +157,80 @@
142157

143158
<!-- END OF SCIKIT CUSTOM LAYOUT -->
144159

160+
161+
<!-- START OF NUMPY CUSTOM LAYOUT -->
162+
163+
<!-- GETTING STARTED -->
164+
{% if getting-started %}
165+
<section class="--tutorial-section">
166+
<header class="--section-header"><a href="#getting-started " id="aes">Getting Started</a>
167+
<div class="icon copy" data-tooltip="Click to copy direct link.">
168+
<svg style="width:24px;height:24px" viewBox="0 0 24 24">
169+
<path fill="#000000"
170+
d="M10.59,13.41C11,13.8 11,14.44 10.59,14.83C10.2,15.22 9.56,15.22 9.17,14.83C7.22,12.88 7.22,9.71 9.17,7.76V7.76L12.71,4.22C14.66,2.27 17.83,2.27 19.78,4.22C21.73,6.17 21.73,9.34 19.78,11.29L18.29,12.78C18.3,11.96 18.17,11.14 17.89,10.36L18.36,9.88C19.54,8.71 19.54,6.81 18.36,5.64C17.19,4.46 15.29,4.46 14.12,5.64L10.59,9.17C9.41,10.34 9.41,12.24 10.59,13.41M13.41,9.17C13.8,8.78 14.44,8.78 14.83,9.17C16.78,11.12 16.78,14.29 14.83,16.24V16.24L11.29,19.78C9.34,21.73 6.17,21.73 4.22,19.78C2.27,17.83 2.27,14.66 4.22,12.71L5.71,11.22C5.7,12.04 5.83,12.86 6.11,13.65L5.64,14.12C4.46,15.29 4.46,17.19 5.64,18.36C6.81,19.54 8.71,19.54 9.88,18.36L13.41,14.83C14.59,13.66 14.59,11.76 13.41,10.59C13,10.2 13,9.56 13.41,9.17Z"/>
171+
</svg>
172+
</div>
173+
</header>
174+
<section class="--grid">
175+
<ul class="--grid-list">
176+
{% for page in languagelistimg %}
177+
{% if page.display_as == "getting-started" %}
178+
<li style="background-image: url({{site.imgurl}}{{page.thumbnail}});" class="--grid-item">
179+
<a href="{% if page.permalink contains 'http' %}{{page.permalink}}{% else %}/{{page.permalink}}{% endif %}">
180+
<div class="--item-meta"><span>{{page.name}}</span></div>
181+
<div class="--item-image">
182+
<span>View Tutorial</span>
183+
<img src="{{site.imgurl}}{{page.thumbnail}}" alt="{{page.name}}">
184+
</div>
185+
</a>
186+
187+
</li>
188+
189+
{% endif %}
190+
{% endfor %}
191+
</ul>
192+
</section>
193+
</section>
194+
195+
{% endif %}
196+
197+
<!-- NUMPY ARRAY -->
198+
{% if numpy-array %}
199+
<section class="--tutorial-section">
200+
<header class="--section-header"><a href="#numpy-array " id="aes">Numpy Array</a>
201+
<div class="icon copy" data-tooltip="Click to copy direct link.">
202+
<svg style="width:24px;height:24px" viewBox="0 0 24 24">
203+
<path fill="#000000"
204+
d="M10.59,13.41C11,13.8 11,14.44 10.59,14.83C10.2,15.22 9.56,15.22 9.17,14.83C7.22,12.88 7.22,9.71 9.17,7.76V7.76L12.71,4.22C14.66,2.27 17.83,2.27 19.78,4.22C21.73,6.17 21.73,9.34 19.78,11.29L18.29,12.78C18.3,11.96 18.17,11.14 17.89,10.36L18.36,9.88C19.54,8.71 19.54,6.81 18.36,5.64C17.19,4.46 15.29,4.46 14.12,5.64L10.59,9.17C9.41,10.34 9.41,12.24 10.59,13.41M13.41,9.17C13.8,8.78 14.44,8.78 14.83,9.17C16.78,11.12 16.78,14.29 14.83,16.24V16.24L11.29,19.78C9.34,21.73 6.17,21.73 4.22,19.78C2.27,17.83 2.27,14.66 4.22,12.71L5.71,11.22C5.7,12.04 5.83,12.86 6.11,13.65L5.64,14.12C4.46,15.29 4.46,17.19 5.64,18.36C6.81,19.54 8.71,19.54 9.88,18.36L13.41,14.83C14.59,13.66 14.59,11.76 13.41,10.59C13,10.2 13,9.56 13.41,9.17Z"/>
205+
</svg>
206+
</div>
207+
</header>
208+
<section class="--grid">
209+
<ul class="--grid-list">
210+
{% for page in languagelistimg %}
211+
{% if page.display_as == "numpy-array" %}
212+
<li style="background-image: url({{site.imgurl}}{{page.thumbnail}});" class="--grid-item">
213+
<a href="{% if page.permalink contains 'http' %}{{page.permalink}}{% else %}/{{page.permalink}}{% endif %}">
214+
<div class="--item-meta"><span>{{page.name}}</span></div>
215+
<div class="--item-image">
216+
<span>View Tutorial</span>
217+
<img src="{{site.imgurl}}{{page.thumbnail}}" alt="{{page.name}}">
218+
</div>
219+
</a>
220+
221+
</li>
222+
223+
{% endif %}
224+
{% endfor %}
225+
</ul>
226+
</section>
227+
</section>
228+
229+
{% endif %}
230+
231+
<!-- END OF NUMPY CUSTOM LAYOUT -->
232+
233+
145234
<!-- START OF GGPLOT CUSTOM LAYOUT -->
146235

147236
<!-- Aesthetics -->
Lines changed: 185 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
1+
---
2+
permalink: numpy/array/
3+
description: The basics for creating NumPy arrays.
4+
name: Arrays | plotly
5+
has_thumbnail: true
6+
thumbnail: thumbnail/numpy_array.jpg
7+
layout: user-guide
8+
name: Arrays
9+
language: numpy
10+
title: Arrays | plotly
11+
display_as: numpy-array
12+
has_thumbnail: true
13+
page_type: example_index
14+
order: 1
15+
---
16+
{% raw %}
17+
<div class="cell border-box-sizing text_cell rendered">
18+
<div class="prompt input_prompt">
19+
</div>
20+
<div class="inner_cell">
21+
<div class="text_cell_render border-box-sizing rendered_html">
22+
<h4 id="New-to-Plotly?">New to Plotly?<a class="anchor-link" href="#New-to-Plotly?">&#182;</a></h4><p>Plotly's Python library is free and open source! <a href="https://plot.ly/python/getting-started/">Get started</a> by downloading the client and <a href="https://plot.ly/python/getting-started/">reading the primer</a>.
23+
<br>You can set up Plotly to work in <a href="https://plot.ly/python/getting-started/#initialization-for-online-plotting">online</a> or <a href="https://plot.ly/python/getting-started/#initialization-for-offline-plotting">offline</a> mode, or in <a href="https://plot.ly/python/getting-started/#start-plotting-online">jupyter notebooks</a>.
24+
<br>We also have a quick-reference <a href="https://images.plot.ly/plotly-documentation/images/python_cheat_sheet.pdf">cheatsheet</a> (new!) to help you get started!</p>
25+
26+
</div>
27+
</div>
28+
</div>
29+
<div class="cell border-box-sizing text_cell rendered">
30+
<div class="prompt input_prompt">
31+
</div>
32+
<div class="inner_cell">
33+
<div class="text_cell_render border-box-sizing rendered_html">
34+
<h3 id="Version">Version<a class="anchor-link" href="#Version">&#182;</a></h3>
35+
</div>
36+
</div>
37+
</div>
38+
<div class="cell border-box-sizing code_cell rendered">
39+
<div class="input">
40+
<div class="prompt input_prompt">In&nbsp;[1]:</div>
41+
<div class="inner_cell">
42+
<div class="input_area">
43+
<div class=" highlight hl-ipython2"><pre><span></span><span class="kn">import</span> <span class="nn">numpy</span> <span class="kn">as</span> <span class="nn">np</span>
44+
<span class="n">np</span><span class="o">.</span><span class="n">__version__</span>
45+
</pre></div>
46+
47+
</div>
48+
</div>
49+
</div>
50+
51+
<div class="output_wrapper">
52+
<div class="output">
53+
54+
55+
<div class="output_area"><div class="prompt output_prompt">Out[1]:</div>
56+
57+
58+
<div class="output_text output_subarea output_execute_result">
59+
<pre>&#39;1.11.2&#39;</pre>
60+
</div>
61+
62+
</div>
63+
64+
</div>
65+
</div>
66+
67+
</div>
68+
<div class="cell border-box-sizing text_cell rendered">
69+
<div class="prompt input_prompt">
70+
</div>
71+
<div class="inner_cell">
72+
<div class="text_cell_render border-box-sizing rendered_html">
73+
<h3 id="Imports">Imports<a class="anchor-link" href="#Imports">&#182;</a></h3>
74+
</div>
75+
</div>
76+
</div>
77+
<div class="cell border-box-sizing text_cell rendered">
78+
<div class="prompt input_prompt">
79+
</div>
80+
<div class="inner_cell">
81+
<div class="text_cell_render border-box-sizing rendered_html">
82+
<p>This tutorial imports <a href="http://www.numpy.org/">Numpy</a>.</p>
83+
84+
</div>
85+
</div>
86+
</div>
87+
<div class="cell border-box-sizing code_cell rendered">
88+
<div class="input">
89+
<div class="prompt input_prompt">In&nbsp;[2]:</div>
90+
<div class="inner_cell">
91+
<div class="input_area">
92+
<div class=" highlight hl-ipython2"><pre><span></span><span class="kn">import</span> <span class="nn">plotly.plotly</span> <span class="kn">as</span> <span class="nn">py</span>
93+
<span class="kn">import</span> <span class="nn">plotly.graph_objs</span> <span class="kn">as</span> <span class="nn">go</span>
94+
</pre></div>
95+
96+
</div>
97+
</div>
98+
</div>
99+
100+
</div>
101+
<div class="cell border-box-sizing text_cell rendered">
102+
<div class="prompt input_prompt">
103+
</div>
104+
<div class="inner_cell">
105+
<div class="text_cell_render border-box-sizing rendered_html">
106+
<h4 id="Create-an-Array">Create an Array<a class="anchor-link" href="#Create-an-Array">&#182;</a></h4><p>Very similar to the Python list object, a <code>numpy array</code> is an array for which data can be appended, removed, and can be reshaped. The data can be read according to other programming languages (eg. C, Fortran) and instantiated as all-zeros or as an empty array.</p>
107+
108+
</div>
109+
</div>
110+
</div>
111+
<div class="cell border-box-sizing code_cell rendered">
112+
<div class="input">
113+
<div class="prompt input_prompt">In&nbsp;[3]:</div>
114+
<div class="inner_cell">
115+
<div class="input_area">
116+
<div class=" highlight hl-ipython2"><pre><span></span><span class="n">x</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">])</span>
117+
<span class="n">y</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="mi">4</span><span class="p">,</span> <span class="mi">7</span><span class="p">,</span> <span class="mi">2</span><span class="p">])</span>
118+
119+
<span class="n">trace</span> <span class="o">=</span> <span class="n">go</span><span class="o">.</span><span class="n">Scatter</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="n">x</span><span class="p">,</span> <span class="n">y</span><span class="o">=</span><span class="n">y</span><span class="p">)</span>
120+
<span class="n">py</span><span class="o">.</span><span class="n">iplot</span><span class="p">([</span><span class="n">trace</span><span class="p">])</span>
121+
</pre></div>
122+
123+
</div>
124+
</div>
125+
</div>
126+
127+
<div class="output_wrapper">
128+
<div class="output">
129+
130+
131+
<div class="output_area"><div class="prompt output_prompt">Out[3]:</div>
132+
133+
<div class="output_html rendered_html output_subarea output_execute_result">
134+
<iframe id="igraph" scrolling="no" style="border:none;" seamless="seamless" src="https://plot.ly/~AdamKulidjian/1496.embed" height="525px" width="100%"></iframe>
135+
</div>
136+
137+
</div>
138+
139+
</div>
140+
</div>
141+
142+
</div>
143+
<div class="cell border-box-sizing text_cell rendered">
144+
<div class="prompt input_prompt">
145+
</div>
146+
<div class="inner_cell">
147+
<div class="text_cell_render border-box-sizing rendered_html">
148+
<h4 id="Create-an-N-D-Array">Create an N-D Array<a class="anchor-link" href="#Create-an-N-D-Array">&#182;</a></h4><p><code>np.ndarray</code> creates an array of a given <code>shape</code> and fills the array with garbage values.</p>
149+
150+
</div>
151+
</div>
152+
</div>
153+
<div class="cell border-box-sizing code_cell rendered">
154+
<div class="input">
155+
<div class="prompt input_prompt">In&nbsp;[4]:</div>
156+
<div class="inner_cell">
157+
<div class="input_area">
158+
<div class=" highlight hl-ipython2"><pre><span></span><span class="n">nd_array</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">(</span><span class="n">shape</span><span class="o">=</span><span class="p">(</span><span class="mi">2</span><span class="p">,</span><span class="mi">3</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="nb">float</span><span class="p">)</span>
159+
<span class="n">nd_array</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">=</span> <span class="n">x</span>
160+
<span class="n">nd_array</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">=</span> <span class="n">y</span>
161+
162+
<span class="n">trace</span> <span class="o">=</span> <span class="n">go</span><span class="o">.</span><span class="n">Scatter</span><span class="p">(</span><span class="n">x</span><span class="o">=</span><span class="n">nd_array</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">y</span><span class="o">=</span><span class="n">nd_array</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
163+
<span class="n">py</span><span class="o">.</span><span class="n">iplot</span><span class="p">([</span><span class="n">trace</span><span class="p">])</span>
164+
</pre></div>
165+
166+
</div>
167+
</div>
168+
</div>
169+
170+
<div class="output_wrapper">
171+
<div class="output">
172+
173+
174+
<div class="output_area"><div class="prompt output_prompt">Out[4]:</div>
175+
176+
<div class="output_html rendered_html output_subarea output_execute_result">
177+
<iframe id="igraph" scrolling="no" style="border:none;" seamless="seamless" src="https://plot.ly/~AdamKulidjian/1498.embed" height="525px" width="100%"></iframe>
178+
</div>
179+
180+
</div>
181+
182+
</div>
183+
</div>
184+
185+
</div>{% endraw %}

0 commit comments

Comments
 (0)