Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Explore architecting a new simulation API output structure

Open
#133 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Refactor
Clarity
Needs clarification
Activity status
Stale
Tech stack
python

Research direction

Start by tracing how simulation results are assembled and compare the Winners & Losers deciles with Deciles impacts. Review the app v2 context before proposing a consistent output structure. Done means the affected calculations expose a harmonized, reusable structure, with the scope and design agreed by maintainers.

Written by the indexing model from the issue text.

Description

Perhaps this should be done alongside app v2 implementation, but the output structure we surface after running a given society-wide simulation can be challenging to manipulate. For example, the Winners & Losers deciles are an array of 10 items, but the Deciles impacts (which you'd think would be handled the same way) are actually an object with keys corresponding to a given decile. Harmonizing how we treat some of these calculations would allow for more reusable code.

Dominant language
Python
Stars
1
Forks
1
Avg merge
15h 10m
Merged PRs (30d)
12

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from PolicyEngine/policyengine-sim-api

All issues in PolicyEngine/policyengine-sim-api

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.