This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

# Monte Carlo Business Case Analysis using pandas

This package provides some tools and examples to analyse high-impact business decisions, and dodge many of the problems of using spreadsheets.

## Background

Pandas is increasingly becoming a standard tool in scientific computing. Could it also have a role in the CFO’s office? CFOs regularly need to analyse the impact of different projects or business cases, and they almost universally do this using spreadsheets. Spreadsheets have many advantages - they have a low barrier to entry and are easy for most people to understand. However as they get more complicated, disadvantages start to appear; in particular, they can be inflexible and highly error-prone.

The application here is made more interesting and useful by being ‘Monte Carlo’ analysis. Traditional business case analysis takes single point estimates of sales, costs and prices, and calculates a single profit forecast. Everybody knows the profit will not turn out to be exactly equal to the forecast. But it is not clear what the range of profits might be, or how likely a loss is. ‘Monte Carlo’ analysis solves this problem by allowing ranges or distributions on the assumptions; the forecast is then a range of outcomes.

For more background, see the [talk](http://racingtadpole.com/blog/business-case-python-pandas/).

## Package structure

Slides and an ipython notebook are included in the talks directory. The talk, titled “Monte Carlo Business Case Analysis using pandas”, was presented at the Science and Data mini-conference for PyCon Australia (1 Aug 2014), as well as the Sydney Python group on 5 June 2014. It is an introduction to both Monte Carlo Business Case Analysis and pandas. You can find it online at [racingtadpole.com/blog/business-case-python-pandas](http://racingtadpole.com/blog/business-case-python-pandas/). The slides have been prepared using the html5 presentation engine [Shower](https://github.com/shower/shower).

The montepylib directory includes:

  • io.py - routines to simplify data input
  • manip.py - routines to manipulate DataFrames
  • utils.py - utility routines like is_string_int
  • sim.py - the core simulation routines
  • extend.py - adds some useful methods to DataFrame

See the examples directory for more, including testing your model.

## Quick start

First install the package:

pip install montepylib

Then, in python, try:

from pandas import Series, DataFrame import pandas as pd from montepylib.sim import Simulator

volume = DataFrame([[‘Factory A’,’Widget X’,200,30.0],[‘Factory A’,’Widget Y’,100,15.0],[‘Factory B’,’Widget X’,300,50.0]], columns=[‘factory’,’widget’,’mean’,’sd’]) costs = DataFrame([[‘Factory A’,’Widget X’,1,.2],[‘Factory A’,’Widget Y’,.6,.1],[‘Factory B’,’Widget X’,1.2,.25],[‘Factory B’,’Widget Y’,.7,.12]], columns=[‘factory’,’widget’,’mean’,’sd’]) price = DataFrame([[‘Widget X’,5,.5], [‘Widget Y’,3,.3]], columns=[‘widget’,’mean’,’sd’])

mc = Simulator() N = 5000 sim_vol = mc.sim_from_params(N, volume, ‘volume’) sim_costs = mc.sim_from_params(N, costs, ‘cost’) sim_price = mc.sim_from_params(N, price, ‘price’)

sim = mc.merge(sim_vol, sim_costs, sim_price, how=’left’) sim[‘margin’] = sim[‘price’] - sim[‘cost’] sim[‘profit’] = sim[‘volume’] * sim[‘margin’]

sim_factory = sim.groupby([‘factory’, ‘iteration’]).sum()[[‘profit’,’volume’]] total_per_iteration = sim_factory.groupby(level=’iteration’).sum() total_per_iteration.hist(xrot=90);

summary_per_factory = sim_factory.groupby(level=’factory’).describe().unstack(level=0) summary_per_factory # profit volume # factory Factory A Factory B Factory A Factory B # count 5000.000000 5000.000000 5000.000000 5000.000000 # mean 1041.392873 1142.445923 299.692542 300.461622 # std 167.320088 255.161823 33.146621 50.388224 # min 411.263495 370.741291 150.234686 127.378759 # 25% 929.578744 965.513249 277.282007 266.361845 # 50% 1032.065933 1129.047618 299.882982 300.278990 # 75% 1148.330681 1308.399140 321.756739 334.676815 # max 1808.573213 2167.622599 420.227083 478.421165

For the base case, use N = 0:

N = 0 # include the same code as above to calculate sim_factory sim_factory # profit volume # factory iteration # Factory A base case 1040 300 # Factory B base case 1140 300

For sensitivity analysis, use N = -1:

N = -1 # include the same code as above to calculate total_per_iteration total_per_iteration # profit volume # iteration # base case 2180 600 # high cost 2055 600 # high price 2460 600 # high volume 2526 695 # low cost 2305 600 # low price 1900 600 # low volume 1834 505

See the examples directory for a more detailed example, including testing your model.

## Other implementations

Pandas is not the only way to do this. For another approach, I have also explored using R - see [this post](http://racingtadpole.com/blog/monte-carlo-cashflow-modelling-in-r/) for some examples, and see the book [“Business Case Analysis with R”](http://leanpub.com/bizanalysiswithr) by Robert D. Brown, 2013. Or if you want to free yourself from using simulations and deal directly with mathematical distributions, you could even use [Mathematica](http://www.wolfram.com/mathematica/)…

Release History

Release History

0.1.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
montepylib-0.1.0.tar.gz (2.0 MB) Copy SHA256 Checksum SHA256 Source Aug 6, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting