Skip to content

Commit 2673bee

Browse files
Data formats icons change (#242)
* content/data-formats: Change yellow circles to rectangles to better suit the style * content/data-formats: Fix a typo in json example
1 parent f346075 commit 2673bee

File tree

1 file changed

+25
-25
lines changed

1 file changed

+25
-25
lines changed

β€Žcontent/data-formats.rstβ€Ž

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -117,18 +117,18 @@ Table below describes some data formats:
117117
118118
* - :ref:`Pickle <pickle>`
119119
- ❌
120-
- 🟑
120+
- 🟨
121121
- βœ…
122-
- 🟑
123-
- 🟑
122+
- 🟨
123+
- 🟨
124124
- ❌
125125

126126
* - :ref:`CSV <csv>`
127127
- βœ…
128128
- ❌
129129
- ❌
130130
- βœ…
131-
- 🟑
131+
- 🟨
132132
- βœ…
133133

134134
* - :ref:`Feather <feather>`
@@ -142,14 +142,14 @@ Table below describes some data formats:
142142
* - :ref:`Parquet <parquet>`
143143
- ❌
144144
- βœ…
145-
- 🟑
145+
- 🟨
146146
- βœ…
147-
- 🟑
147+
- 🟨
148148
- βœ…
149149

150150
* - :ref:`npy <npy>`
151151
- ❌
152-
- 🟑
152+
- 🟨
153153
- ❌
154154
- ❌
155155
- βœ…
@@ -174,7 +174,7 @@ Table below describes some data formats:
174174
* - :ref:`JSON <json>`
175175
- βœ…
176176
- ❌
177-
- 🟑
177+
- 🟨
178178
- ❌
179179
- ❌
180180
- βœ…
@@ -183,22 +183,22 @@ Table below describes some data formats:
183183
- ❌
184184
- ❌
185185
- ❌
186-
- 🟑
186+
- 🟨
187187
- ❌
188188
- βœ…
189189

190190
* - :ref:`Graph formats <graph>`
191-
- 🟑
192-
- 🟑
191+
- 🟨
192+
- 🟨
193193
- ❌
194194
- ❌
195195
- ❌
196-
- 🟑
196+
- 🟨
197197

198198
.. important::
199199

200200
- βœ… : Good
201-
- 🟑 : Ok / depends on a case
201+
- 🟨 : Ok / depends on a case
202202
- ❌ : Bad
203203

204204

@@ -215,10 +215,10 @@ Pickle
215215

216216
- **Type**: Binary format
217217
- **Packages needed:** None (:mod:`pickle`-module is included with Python).
218-
- **Space efficiency:** 🟑
218+
- **Space efficiency:** 🟨
219219
- **Arbitrary data:** βœ…
220-
- **Tidy data:** 🟑
221-
- **Array data:** 🟑
220+
- **Tidy data:** 🟨
221+
- **Array data:** 🟨
222222
- **Long term archival/sharing:** ❌! See warning below.
223223
- **Best use cases:** Saving Python objects for debugging.
224224

@@ -285,7 +285,7 @@ CSV (comma-separated values)
285285
- **Space efficiency:** ❌
286286
- **Arbitrary data:** ❌
287287
- **Tidy data:** βœ…
288-
- **Array data:** 🟑
288+
- **Array data:** 🟨
289289
- **Long term archival/sharing:** βœ…
290290
- **Best use cases:** Sharing data. Small data. Data that needs to be human-readable.
291291

@@ -409,9 +409,9 @@ Parquet
409409
- **Type:** Binary format
410410
- **Packages needed:** pandas, pyarrow
411411
- **Space efficiency:** βœ…
412-
- **Arbitrary data:** 🟑
412+
- **Arbitrary data:** 🟨
413413
- **Tidy data:** βœ…
414-
- **Array data:** 🟑
414+
- **Array data:** 🟨
415415
- **Long term archival/sharing:** βœ…
416416
- **Best use cases:** Working with big datasets in tidy data format. Archival of said data.
417417

@@ -494,7 +494,7 @@ npy (numpy array format)
494494

495495
- **Type**: Binary format
496496
- **Packages needed:** numpy
497-
- **Space efficiency:** 🟑
497+
- **Space efficiency:** 🟨
498498
- **Arbitrary data:** βœ…
499499
- **Tidy data:** ❌
500500
- **Array data:** βœ…
@@ -680,7 +680,7 @@ JSON (JavaScript Object Notation)
680680
- **Type**: Text format
681681
- **Packages needed:** None (:mod:`json`-module is included with Python).
682682
- **Space efficiency:** ❌
683-
- **Arbitrary data:** 🟑
683+
- **Arbitrary data:** 🟨
684684
- **Tidy data:** ❌
685685
- **Array data:** ❌
686686
- **Long term archival/sharing:** βœ…
@@ -695,7 +695,7 @@ nested data with multiple layers or lots of interconnections.
695695
Similarly to other popular files, Pandas can write and read json files with :meth:`~pandas.DataFrame.to_json`- and :func:`~pandas.read_json`-functions::
696696

697697
dataset.to_json('dataset.json')
698-
dataset_json = pd.read_csv('dataset.json')
698+
dataset_json = pd.read_json('dataset.json')
699699

700700

701701
.. _excel:
@@ -714,7 +714,7 @@ Excel
714714
- **Packages needed:** `openpyxl <https://openpyxl.readthedocs.io/en/stable/>`__
715715
- **Space efficiency:** ❌
716716
- **Arbitrary data:** ❌
717-
- **Tidy data:** 🟑
717+
- **Tidy data:** 🟨
718718
- **Array data:** ❌
719719
- **Long term archival/sharing:** βœ…
720720
- **Best use cases:** Sharing data in many fields. Quick data analysis.
@@ -734,11 +734,11 @@ Graph formats (adjency lists, gt, GraphML etc.)
734734

735735
- **Type**: Many different formats
736736
- **Packages needed:** Depends on a format.
737-
- **Space efficiency:** 🟑
737+
- **Space efficiency:** 🟨
738738
- **Arbitrary data:** ❌
739739
- **Tidy data:** ❌
740740
- **Array data:** ❌
741-
- **Long term archival/sharing:** 🟑
741+
- **Long term archival/sharing:** 🟨
742742
- **Best use cases:** Saving graphs or data that can be represented as a graph.
743743

744744
There are plenty of data formats for storing graphs.

0 commit comments

Comments
Β (0)