Technology moves fast! ⚡ Don't get left behind.🚶 Subscribe to our mailing list to keep up with latest and greatest in open source projects! 🏆


Subscribe to our mailing list

guesstimate-app

Create Fermi Estimates and Perform Monte Carlo Estimates

Subscribe to updates I use guesstimate-app


Statistics on guesstimate-app

Number of watchers on Github 1868
Number of open issues 27
Average time to close an issue 9 days
Main language JavaScript
Average time to merge a PR about 7 hours
Open pull requests 12+
Closed pull requests 34+
Last commit almost 2 years ago
Repo Created over 3 years ago
Repo Last Updated about 1 year ago
Size 7.81 MB
Homepage http://getguessti...
Organization / Authorgetguesstimate
Latest Releasev1.0.1
Contributors8
Page Updated
Do you use guesstimate-app? Leave a review!
View open issues (27)
View guesstimate-app activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating guesstimate-app for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

Guesstimate is a tool for performing estimates using monte carlo experiments. It can be used similarly to excel, but provides the option of providing ranges and distributions as values instead of individual points. Other metrics can do mathematical operations on these cells/metrics. After each new input is added or changed, a set of 5000 samples is randomly generated from each input and goes through the specified operations to produce confidence intervals in the output.

Using Guesstimate

See GetGuesstimate.com to use.

Create a Collection

create_collection

Create a Metric with a Guess

create_guess You can enter individual numbers or ranges.

  • [25,35]: A 90% confidence interval between 25 and 35.

Currently all ranges are converted into normal distributions by default, but can be changed to uniform distributions.

Create a Metric with a Function input

create_function Use the = sign as the first character of a guesstimate input to make it a function (similar to Excel and Google Sheets). Each metric has a variable name which is made of two randomly chosen letters. When the function input is selected, you can either type a metric's symbol to use it in a calculation, or simply click on it.

The functions are processed using Math.js. As such, it has several mathematical constants and functions that are useable.

Different Visualization Methods

visualizations

Metric Visualizations

There are a few different ways of visualizing metrics. These are the following:

  • Normal: A view with metric names, basic distribution stats (mean & std deviation), and a picture of the distribution in the background.
  • Basic: The same as normal, but without the distribution image. This helps speed up calculations.
  • Scientific: The same as normal, but the distribution image is larger and there are a few extra statistics. Mean and standard deviation are labeled with more detail.
  • Debugging: This is used for making the system, and is a view of the React props that each metric component contains. This may be interesting to you, but is not that useful for general use.

Arrows

Arrows between metrics can be turned on or off. They can be useful, but also add complication to the UI. In the future the arrow layout may improve significantly. By default they show when there are less than 20 metrics in a model, and are hidden when there are more.

Distribution View

distributions Click on Metrics to see more information about their distributions. The Distribution shows a large view of the Distribution, information about different percentiles, and a description.

Limitations

There are many things that will be improved. Some of the more important limitations include:

  1. Distribution types are limited to normal, uniform, and a few discrete types with math.js functions
  2. Everything is public.
  3. Only the creator of a collection is allowed to save edits to that collection.
  4. Metrics can't be shared between collections.

Technical Information

Guesstimate is a Single Page Application. Everything in this repo is the client side, which is one reason why this is called 'guesstimate-app'.

There are two important third party systems. Authentication is done with Auth0, and search/indexing is done with Algolia. This means that running it yourself involves some setup, but on the other hand it's pretty easy set up compared to what you may need in comparable systems. Both of these are free for moderate use. I recommend both, though should note that the way I set up Algolia was a bit hacky (not sure how to do it right).

There is also a small server in Rails, which is not yet on Github. I'd like to work on security a bit more before putting it on here (if select people want to work on it I'd be happy to share in a small group). However, this is quite tiny; just 2 models (users, spaces).

All models are stored and saved as 'spaces'. The spreadsheet content is all stored as json in Postgres. You can see the full requests if you look at the network tab in chrome.

However, while there are a few third party systems, everything will still work with just guesstimate-app, as long as you don't try to log in or save. In practice this means that you can do quite a bit of development, as you can edit any model on the site (just can't save them). It also makes much development quite simple when it's just on the website (not the server). The line that controls this is here:

"start": "BUILD_DEV=0 NODE_ENV=development API_ENV=production webpack-dev-server"

API_ENV=production (as opposed to development) means that it will use the production APIs.

How to run

First, make sure that git and node are installed.

git clone https://github.com/getguesstimate/guesstimate-app.git

cd guesstimate-app

npm install

npm start

There are often errors with specific things, but it depends on what is already installed on the computer. Later we could put it in a docker container or something.

Performance Testing & Optimization

When running in development mode (npm start), Guesstimate records performance statistics about a subset of its react renders, actions, and selectors. These statistics are recorded and accessible through a Javascript object embedded in the window, called recorder, with the following API:

  • recorder.nestedTimeline prints a heirarchical view of all events the recorder has tracked so far, appropriately nested. For example, if the recorder tracks renders on component A and component B, with B a child of A, the nested timeline view will show information about the rendering of B nested within the entry for the rendering of A.
  • recorder.timeline prints a timeseries of all events the recorder has tracked so far.
  • recorder.renderTimings is an object that stores how long each component has taken to render (inclusive).
  • recorder.selectorTimings is an object that stores how long each selector has taken to run (inclusive).
  • recorder.actionCounts is an object that stores how many times each action type has been dispatched.
  • recorder.renderCounts is an object that stores how many times each tracked component has been rendered.
  • recorder.selectorCounts is an object that stores how many times each tracked selector was run.

To track additional components or selectors, simply add the appropriate recorder methods into the lifecycle. In particular, for a component, insert the following:

  • window.recorder.recordMountEvent(this) within componentWillMount
  • window.recorder.recordUnmountEvent(this) within componentWillUnmount
  • window.recorder.recordRenderStartEvent(this) within componentWillUpdate
  • window.recorder.recordRenderStopEvent(this) within componentDidUpdate

Within a selector, insert the following:

  • window.recorder.recordSelectorStart([NAME]) at the start of the selector's execution (or the start of the first selector within the selector chain).
  • window.recorder.recordSelectorStop([NAME], [DATA]) just before the selector returns, with data being any data you'd like to track in the timeline with that selector event (the return value is typical).
guesstimate-app open issues Ask a question     (View All Issues)
  • over 2 years Sometimes metric card displays seem to break:
  • over 2 years Drag & Dropping an Existing Card Selects new Card
  • over 2 years A space at the end of email address in new member form breaks 'Invite User'
  • over 2 years Show fact history in client somehow
  • over 2 years History of facts fetched from server
  • over 2 years Facts need modals
  • over 2 years Fact cards need 'tiny' view for fact graph.
  • over 2 years Facts should use modified metric card
  • over 2 years Facts from functions should contain equations
  • over 2 years What happened to the samples textbox in the distribution view?
  • over 2 years Return list of top editors for metric, based on time.
  • over 2 years Return list of top editors for fact, based on time.
  • over 2 years All facts returned in response to link actions
  • over 2 years Support double-triangular distribution for software estimation
  • almost 3 years TextForm within modal gives the following error
  • almost 3 years Subscribe to private model plan, get dropped on page with a button "Create A Private Model" and clicking that button in Safari does nothing
  • almost 3 years Release Fact Book V0.12
  • almost 3 years Facts should be enabled per users, as well as organizations
  • almost 3 years Fact sidebar should show for public facts
  • almost 3 years Add toggle for facts to be public
  • almost 3 years Default privacy behavior is unexpected
  • almost 3 years Behavior is too dependent on current state
  • almost 3 years Shortcuts use ctrl instead of cmd on Mac
  • almost 3 years New Organization Page gives this console warning
  • almost 3 years Space dropdown / fuzzy search
  • almost 3 years Calculators have optional image links
  • almost 3 years List calculator count on card
  • almost 3 years Relevant Key Command sidebar
  • almost 3 years Automatically adjust two letter combinations to be capital
  • almost 3 years Space after input should show 'to upper_bound' syntax
guesstimate-app open pull requests (View All Pulls)
  • Organization creation improvements
  • Adds the ability to import slurps, either via the file menu on the model page, or from the standalone page /import_from_slurp
  • The calculator should always show the current and correct answer.
  • Adds a mode to show all inputs and makes the view options toggles. Closes 573.
  • Graph propagation lib refactor.
  • Refactor DAG system for more robustness.
  • Highlight first degree edges differently
  • Appropriate focusing behavior following a click on the boundary around a metric card. Closes #546
  • Adds a mode to show all inputs and make view options toggles. Closes #573.
  • Preventing clicks on the lognormal icon when lognormal is an invalid choice. Closes #553.
  • Fix broken headings in Markdown files
  • updates README to be more markdown-ish
guesstimate-app list of languages used
guesstimate-app latest release notes
v1.0.1 The Dynamic Fact Graph

This release exposes exportable fact functionality, allowing users to export facts from models. Those facts are kept in sync with upstream fact changes, allowing users to form a dynamic fact graph for their organizations.

v1.0.0 Guesstimate 1.0

Re-initializing our release state at 1.0.0, as we plan to use releases more actively in the future with code deployments.

A lot has changed since the last release, including:

  • Private organizational support.
  • Fact bank support (facts are metrics that can be used across many models).
  • Calculators.
  • A variety of UI improvements.
  • A new simulation propagation engine.
v0.4.1 Copying Models & Financial Functions

Improvements

  • Users can now copy models, giving them quick access to edit & save others' models (#115).
  • Users can now use financial functions via FinanceJS (#183).
    • Amortization (AM)
    • Compound Annual Growth Rate (CAGR)
    • Compound Interest (CI)
    • Discount Factor (DF)
    • Future Value (FV)
    • Leverage Ratio (LR)
    • Net Present Value (NPV)
    • Payback Period (PP)
    • Profitability Index (PI)
    • Return on Investment (ROI)
    • Rule of 72 (R72)
    • Weighted Average Cost of Capital (WACC)

Bug Fixes

  • Model names on the public models page should be in the correct case (#186 here, #14 on the server).
  • Deterministic functions should only require 1 sample (#182).
  • Unparsable inputs shouldn't try to sample (#188).
Other projects in JavaScript