DOC: update to reflect changes in Categorical

* rename of levels -> categories * don't use the `Categorical` constructor if thats not needed * introduce the new methods to manipulate categories
pandas-dev · Sep 25, 2014 · 3f282da · 3f282da
1 parent 4c45d7f
commit 3f282da
Show file tree

Hide file tree

Showing 4 changed files with 295 additions and 315 deletions.
diff --git a/doc/source/10min.rst b/doc/source/10min.rst
@@ -652,11 +652,11 @@ Since version 0.15, pandas can include categorical data in a ``DataFrame``. For
     # Alternative: df["grade"] = df["raw_grade"].astype("category")
     df["grade"]
 
-    # Rename the levels
-    df["grade"].cat.levels = ["very good", "good", "very bad"]
+    # Rename the categories inplace
+    df["grade"].cat.categories = ["very good", "good", "very bad"]
 
-    # Reorder the levels and simultaneously add the missing levels
-    df["grade"].cat.reorder_levels(["very bad", "bad", "medium", "good", "very good"])
+    # Reorder the categories and simultaneously add the missing categories
+    df["grade"] = df["grade"].cat.set_categories(["very bad", "bad", "medium", "good", "very good"])
     df["grade"]
     df.sort("grade")
     df.groupby("grade").size()