Categorical (.cat) Accessor
===========================

.. currentmodule:: pandasCore

Access categorical methods on Series with categorical data via ``.cat``.

Example
-------

.. code-block:: python

   import pandasCore as pd

   s = pd.Series(pd.Categorical(['a', 'b', 'a', 'c']))
   s.cat.categories    # ['a', 'b', 'c']
   s.cat.codes         # [0, 1, 0, 2]
   s.cat.ordered       # False

Attributes
----------

.. list-table::
   :widths: 25 75
   :header-rows: 1

   * - Attribute
     - Description
   * - categories
     - Categories of this categorical
   * - codes
     - Integer codes for categories
   * - ordered
     - Whether categories are ordered

Methods
-------

.. list-table::
   :widths: 25 75
   :header-rows: 1

   * - Method
     - Description
   * - add_categories(new_categories)
     - Add new categories
   * - remove_categories(removals)
     - Remove categories
   * - remove_unused_categories()
     - Remove unused categories
   * - rename_categories(new_categories)
     - Rename categories
   * - reorder_categories(new_categories)
     - Reorder categories
   * - set_categories(new_categories)
     - Set categories
   * - as_ordered()
     - Set as ordered
   * - as_unordered()
     - Set as unordered