Visualize your Portfolio’s Performance and Generate a Nice Report with R

[This article was first published on R Programming – DataScience+, and kindly contributed to R-bloggers]. (You can report issue about the content on this page here)
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.


    1. Visualizing Data


    1. Data Visualisation
    2. dplyr
    3. ggplot2
    4. lares
    5. R Programming

    There are few things more exciting than seeing your stocks values going up! I started investing last year in stocks and, like visualization and R lover, I couldn’t help but create some nice plots and functions to automate the process of watching it happen.

    Some of you might already know the lares package; I’ve included these following ‘stocks family’ functions for some time now but today is the day in which I’ll share with you its nice useful outputs.


    The overall idea of these functions is to visualize your stocks and portfolio’s performance with a just a few lines of simple code. I’ve created individual functions for each of the calculations and plots, and some other functions that gather all of them into a single list of objects for further use.

    On the other hand, the lares package is “my personal library used to automate and speed my everyday work on Analysis and Machine Learning tasks”. I am more than happy to share it with you for your personal use. Feel free to install, use, and comment on any of its code and functionalities and I’ll happy to help you with it. I have previously shared other uses of the library in other posts which might also interest you: Visualizing ML Results (binary), Visualizing ML Results (continuous) and AutoML to understand datasets.

    • NOTE 1: The following post was written by a non-economist or professional investor. I am open to your comments and technical corrections if needed. Glad to learn as always!
    • NOTE 2: I will be using the less customizable functions in this post so we can focus more on the outputs than in the coding part; but once again, feel free to use the functions and dive into the library to understand or change them!
    • NOTE 3: All currency units are USD ($).

    Get Historical Values

    Let’s start by downloading a dummy Excel file which contains the recommended input format. In there, you will find three tabs which must be filled with your personal data:

    1. Portfolio: a summary of your investments. Each row represents a Stock and gathers some data from the other 2 tabs. The only inputs you have to fill are Stocks symbols or Tickers, and a given category you wish to group them by (US Stocks, International, Recommended by Bernardo…)
    2. Funds: here you will log any inputs or outputs of cash to your investment account. The required values are date and amount. There is an additional column for personal use to write notes and concepts if you want to.
    3. Transactions: this last tab will be your purchase log. You should write which, when, how many, and by how much did you buy each of your stocks.

    Now we get to the fun part: R! Even though you might have already installed the lares library before, I strongly recommend to update it with the following command because I’ve created some of the gathering functions recently (yesterday):


    NOTE: It may take a while to install the first time because I have some dependencies on other big libraries (like h2o ~123MB). But don’t worry, all of them are quite useful!

    After you have filled your data (or you might just want to try the dummy’s), we import it. To quicken the process, we can use the get_stocks function which automatically imports all tabs from your file and returns a list with these three tables.

    df <- get_stocks(filename = "dummyPortfolio.xlsx")

    Calculations and Plots

    To understand where we are now we need to understand where we were before. Let’s download our historical data from the first day we purchased each stock until today included. After that, we automatically process (dplyr mostly) all the data in such a way that we can get the variance for each day, percentages, growth, etc. Finally, some nice plots (ggplot2 mostly) are created; even though they will have some redundant information, they will give us a wider perspective on our whole portfolio.

    For further customization, there are three parameters I’ve added to the function:

    1. tax: What percentage of your dividends does Uncle Sam (or equivalent) bite?
    2. expenses: How much does your bank or broker charges per transaction?
    3. cash_fix: Literally, how much do you want to sum to your current cash balance to fix it.

    Sometimes, the results need a little adjustment because of dividends not yet published or a little difference in quoting timings. Usually, I wouldn’t use this parameter.

    If your values are tax = 30, expenses = 7, cash_fix = 0, you can simply run the following code to process your portfolio’s data (if not, put them inside the function):

    dfp <- stocks_objects(df)

    That’s it! Now we have everything we need to visualize our stocks’ growth and portfolio’s performance. Let’s take a look at some of the plots created:

    First, I’d like to see an overall daily plot for my portfolio’s ups and downs. It is relevant to see percentages for daily changes and for absolute changes so we don’t panic when a crazy-steep-roller-coaster-day happens.


    Will show the following plot:

    Then, I’d like to see a plot with all my stocks and its numbers, order by relevance (value). We can see all of our stock’s current data (grey boxes at the left), how many we have and their current value. Next to it, at each bar’s foot, the amount invested and their weighted average purchase price. And the head of the bars, we have the earnings metrics: how much have they grown/shrank in absolute currency numbers or percentages. We can also see a symbol, located at today’s total value, that represents if the value has increased or decreased compared to your total stock investment.


    Will plot the following:

    The next cool plot we get shows the daily percentage change since the first stock you purchased for each Ticker. The grids will group and plot each stock into the category you defined at your Excel’s Portfolio tab. There are also some points added at those days you did transactions; with those you can evaluate in the future if it was or not a good moment to buy/sell (don’t worry: no one can predict the future!)


    Will generate this plot:

    Generate Report

    We can generate a nice HTML report with our portfolio’s performance using another quick command. It uses RMarkdown for rendering the plots and table into a single document. In addition to our prior plots, there is one more which shows the distribution of stocks into categories and a nice table with all the useful data summarizing everything up.


    Now you have a new nice HTML report created in your working directory. You can download this post’s report here.

    Extra tip

    RServer + cronR + mailR: RStudio in the cloud has indubitably been a great friend of mine for some time now. It automates daily tasks such as reporting, updating Google Sheets, sending mails, creating databases… and you only have to write the code once! It is a great way to get more independence from your company’s Tech Team. You could set a cronR job to send a daily or weekly report to your email automatically with this great tool.

    Hope you guys enjoyed this post. If you have any doubts, comments, pull requests, issues, just let me know! Please, do LinkedIn me if you want to connect.

    Thanks for your time ????

    Related Post

    1. Exploring San Francisco Bay Area’s Bike Share System
    2. Analysis and Visualization of Blue Bikes Sharing in Boston
    3. Analysis of Los Angeles Crime with R
    4. Mapping the Prevalence of Alzheimer Disease Mortality in the USA
    5. Animating the Goals of the World Cup: Comparing the old vs. new gganimate and tweenr API

    To leave a comment for the author, please follow the link and comment on their blog: R Programming – DataScience+. offers daily e-mail updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/data-science job.
    Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.

    Never miss an update!
    Subscribe to R-bloggers to receive
    e-mails with the latest R posts.
    (You will not see this message again.)

    Click here to close (This popup will not appear again)