Negative sums does not display

.gitignore

@@ -8,3 +8,5 @@ site/
 *.mp4
 docs/
 data/
+.idea/
+venv/

README.md

@@ -1,117 +1,126 @@
 # Bar Chart Race
 
-[![](https://img.shields.io/pypi/v/bar_chart_race)](https://pypi.org/project/bar_chart_race)
-[![PyPI - License](https://img.shields.io/pypi/l/bar_chart_race)](LICENSE)
-
 Make animated bar and line chart races in Python with matplotlib or plotly.
 
-![img](https://github.com/dexplo/bar_chart_race/raw/gh-pages/images/covid19_horiz.gif)
-
-## Official Documentation
-
-Visit the [bar_chart_race official documentation](https://www.dexplo.org/bar_chart_race) for detailed usage instructions.
-
-## Installation
-
-Install with either:
+Original Repo (without icons) : [https://github.com/dexplo/bar_chart_race](https://github.com/dexplo/bar_chart_race)
 
-* `pip install bar_chart_race`
-* `conda install -c conda-forge bar_chart_race`
+Andres Berejnoi's Repo (with
+icons) : [https://github.com/andresberejnoi/bar_chart_race](https://github.com/andresberejnoi/bar_chart_race)
 
-## Quickstart
+---
 
-Must begin with a pandas DataFrame containing 'wide' data where:
+## Top Computer Science Schools 2000 - 2020
 
-* Every row represents a single period of time
-* Each column holds the value for a particular category
-* The index contains the time component (optional)
-
-The data below is an example of properly formatted data. It shows total deaths from COVID-19 for several countries by date.
+![img](demo.gif)
 
-![img](https://github.com/dexplo/bar_chart_race/raw/gh-pages/images/wide_data.png)
+---
 
-### Create bar and line chart races
+## Installation
 
-There are three core functions available to construct the animations.
+First Create a New Virtual Environment & Activate It:
 
-* `bar_chart_race`
-* `bar_chart_race_plotly`
-* `line_chart_race`
+```
+pip install virtualenv
+virtualenv venv
+.\venv\Scripts\activate
+```
 
-The above animation was created with the help of matplotlib using the following call to `bar_chart_race`.
+Install `bar_chart_race` using `pip`:
 
-```python
-import bar_chart_race as bcr
-df = bcr.load_dataset('covid19_tutorial')
-bcr.bar_chart_race(
-        df=df, 
-        filename='../docs/images/covid19_horiz.gif', 
-        orientation='h', 
-        sort='desc', 
-        n_bars=8, 
-        fixed_order=False, 
-        fixed_max=True, 
-        steps_per_period=20, 
-        period_length=500, 
-        end_period_pause=0,
-        interpolate_period=False, 
-        period_label={'x': .98, 'y': .3, 'ha': 'right', 'va': 'center'}, 
-        period_template='%B %d, %Y', 
-        period_summary_func=lambda v, r: {'x': .98, 'y': .2, 
-                                          's': f'Total deaths: {v.sum():,.0f}', 
-                                          'ha': 'right', 'size': 11}, 
-        perpendicular_bar_func='median', 
-        colors='dark12', 
-        title='COVID-19 Deaths by Country', 
-        bar_size=.95, 
-        bar_textposition='inside',
-        bar_texttemplate='{x:,.0f}', 
-        bar_label_font=7, 
-        tick_label_font=7, 
-        tick_template='{x:,.0f}',
-        shared_fontdict=None, 
-        scale='linear', 
-        fig=None, 
-        writer=None, 
-        bar_kwargs={'alpha': .7},
-        fig_kwargs={'figsize': (6, 3.5), 'dpi': 144},
-        filter_column_colors=False) 
+```
+pip install git+https://github.com/programiz/bar_chart_race.git@master
 ```
 
-### Save animation to disk or embed into a Jupyter Notebook
+You also need to install
+FFmpeg: [https://github.com/BtbN/FFmpeg-Builds/releases/](https://github.com/BtbN/FFmpeg-Builds/releases/)
 
-If you are working within a Jupyter Notebook, leave the `filename` as `None` and it will be automatically embedded into a Jupyter Notebook.
+---
 
-```python
-bcr.bar_chart_race(df=df, filename=None)
-```
+## Usage
 
-![img](https://github.com/dexplo/bar_chart_race/raw/gh-pages/images/bcr_notebook.png)
+Create a file and use the `bar_chart_race` library as shown below:
 
-### Customization
+```python
+import bar_chart_race as bcr
+import pandas as pd
 
-There are many options to customize the bar chart race to get the animation you desire. Below, we have an animation where the maximum x-value and order of the bars are set for the entire duration. A custom summary label and perpendicular bar of the median is also added.
+df = pd.read_csv("data.csv", index_col="Date")
 
-```python
-def period_summary(values, ranks):
-    top2 = values.nlargest(2)
-    leader = top2.index[0]
-    lead = top2.iloc[0] - top2.iloc[1]
-    s = f'{leader} by {lead:.0f}'
-    return {'s': s, 'x': .99, 'y': .03, 'ha': 'right', 'size': 8}
-
-df_baseball = bcr.load_dataset('baseball').pivot(index='year',
-                                                 columns='name',
-                                                 values='hr')
-df_baseball.bcr.bar_chart_race(
-                   period_length=1000,
-                   fixed_max=True, 
-                   fixed_order=True, 
-                   n_bars=10,
-                   period_summary_func=period_summary,
-                   period_label={'x': .99, 'y': .1},
-                   period_template='Season {x:,.0f}',
-                   title='Top 10 Home Run Hitters by Season Played')
-```
+# replace empty values with 0
+df.fillna(0.0, inplace=True)
 
-![img](https://github.com/dexplo/bar_chart_race/raw/gh-pages/images/baseball_horiz.gif)
+# using the bar_chart_race package
+bcr.bar_chart_race(
+    # must be a DataFrame where each row represents a single period of time.
+    df=df,
+
+    # name of the video file
+    filename="video.mp4",
+
+    # specify location of image folder
+    img_label_folder="bar_image_labels",
+
+    # change the Figure properties
+    fig_kwargs={
+        'figsize': (26, 15),
+        'dpi': 120,
+        'facecolor': '#F8FAFF'
+    },
+
+    # orientation of the bar: h or v
+    orientation="h",
+
+    # sort the bar for each period
+    sort="desc",
+
+    # number of bars to display in each frame
+    n_bars=10,
+
+    # to fix the maximum value of the axis
+    # fixed_max=True,
+
+    # smoothness of the animation
+    steps_per_period=45,
+
+    # time period in ms for each row
+    period_length=1500,
+
+    # custom set of colors
+    colors=[
+        '#6ECBCE', '#FF2243', '#FFC33D', '#CE9673', '#FFA0FF', '#6501E5', '#F79522', '#699AF8', '#34718E', '#00DBCD',
+        '#00A3FF', '#F8A737', '#56BD5B', '#D40CE5', '#6936F9', '#FF317B', '#0000F3', '#FFA0A0', '#31FF83', '#0556F3'
+    ],
+
+    # title and its styles
+    title={'label': 'Programming Language Popularity 1990 - 2020',
+           'size': 52,
+           'weight': 'bold',
+           'pad': 40
+           },
+
+    # adjust the position and style of the period label
+    period_label={'x': .95, 'y': .15,
+                  'ha': 'right',
+                  'va': 'center',
+                  'size': 72,
+                  'weight': 'semibold'
+                  },
+
+    # style the bar label text
+    bar_label_font={'size': 27},
+
+    # style the labels in x and y axis
+    tick_label_font={'size': 27},
+
+    # adjust the style of bar
+    # alpha is opacity of bar
+    # ls - width of edge
+    bar_kwargs={'alpha': .99, 'lw': 0},
+
+    # adjust the bar label format
+    bar_texttemplate='{x:.2f}',
+
+    # adjust the period label format
+    period_template='{x:.0f}',
+)
+```