Inputs & Outputs

Input Parameters

Production Studio uses two main types of inputs:

• StudioInputs

• SimulationInputs

The StudioInputs class is responsible for managing and validating the inputs required for running production pipelines in the production_studio module. The SimulationInputs class is responsible for managing and validating the inputs required for running simulations in the production_studio module.

Below is a list of StudioInputs and SimulationInputs that can be used for simulation.

Field Name	Type	Description	Expected Value	Units	Default
num_wells_list	Optional[List[Optional[int]]]	List of the number of wells for each month.	[10, 15, 20]	Number of wells completed per month	None
future_production	Optional[List[Optional[float]]]	List of future production targets.	[5.85, 5.84, 5.88, 5.9]	Production units (e.g., mmbbl / day for oil, bcf / day for gas)	None
gas_exp_params	Optional[List[Optional[float]]]	Exponential parameters for gas production.	[11500, -0.05, 300]	Production units (e.g., mmbbl / day for oil, bcf / day for gas)	None
oil_exp_params	Optional[List[Optional[float]]]	Exponential parameters for oil production.	[23, -0.04, 0.1]	Production units (e.g., mmbbl / day for oil, bcf / day for gas)	None
num_til_days	Optional[int]	Number of TIL (Time to Initial Load) days.	30	Days	0
simulation_start	Optional[str]	The start date of the simulation, jumping point off SynMax’s short term forecast.	"2025-02-01"	Date	The first day of the current month.
well_efficiency_factor	Optional[float]	Efficiency factor for wells.	1.2	Multiplier	1
crew_efficiency_factor	Optional[float]	Efficiency factor for frac crews.	1.1	Multiplier	1
well_frac_ratio	Optional[float]	Ratio of wells to frac crews.	2.5	Ratio	calculated using historical data
simulation_type	Required[str]	Type of simulation.	"Forward"	N/A	None
production_type	Optional[str]	Type of production.	"Gas"	N/A	None
sim_duration	Optional[int]	Duration of the simulation.	12	Months	None
wells_range	Optional[List[int]]	Range for the number of wells.	[10, 15]	Count	None
num_simulations	Optional[int]	Number of simulations.	10	Count	None
well_frac_ranges	Optional[List[Optional[Dict[str,List[int]]]]]	Range for the number of wells to frac crews.	[{"wells_range": [10, 15]}, {"wells_range": [10, 20]}]	Count	None

Output Fields

Field	Type	Description	Expected Value
num_wells_list	Optional[List[Optional[int]]]	List of the number of wells for each month.	[10, 17, 10, 18]
num_months_list	Optional[List[Optional[int]]]	List of the number of months for each simulation run.	[1, 2, 3, 4]
num_fracs_list	Optional[List[Optional[float]]]	List of the number of frac crews for each month.	[4.0, 6.8, 4.0, 7.2]
num_til_days	Optional[int]	Number of TIL (Time to Initial Load) days.	30
gas_exp_params	Optional[List[Optional[float]]]	Exponential parameters for gas production.	[11500.0, -0.05, 160.0]
oil_exp_params	Optional[List[Optional[float]]]	Exponential parameters for oil production.	[23.0, -0.04, 1.0]
simulation_start	Optional[str]	The start date of the simulation.	'2025-02-01T00:00:00'
well_efficiency_factor	Optional[float]	Efficiency factor for wells.	1.2
crew_efficiency_factor	Optional[float]	Efficiency factor for frac crews.	1.1
well_frac_ratio	Optional[float]	Ratio of wells to frac crews.	2.5
avg_fracs	Optional[int]	Average number of fractures.	6
avg_gas	Optional[float]	Average gas production rate.	5.83
avg_oil	Optional[float]	Average oil production rate.	0.09
avg_well_frac_ratio	Optional[float]	Ratio of fractures to wells.	3.4403873892048535
avg_wells	Optional[int]	Average number of wells.	24
gas_decl_def	Optional[float]	Gas production decline rate.	-0.048086993134153336
gas_ipr_def	Optional[int]	Initial gas production rate.	11454
gas_min_def	Optional[int]	Minimum gas production rate.	296
oil_decl_def	Optional[float]	Oil production decline rate.	-0.08133736573120617
oil_ipr_def	Optional[int]	Initial oil production rate.	287
oil_min_def	Optional[int]	Minimum oil production rate.	2