AFA Data Dictionary

variable	description	Comment	Common Symbols
Class: ProjectSetting
forecast_start_date	start of forecasting for project	is project level variable of datetime type, any module which does any production/pressure forecasting will need to use this
forecast_end_date	end of forecasting for project	is project level variable of datetime type, any module which does any production/pressure forecasting will need to use this
Class: UserSetting, SpadDeclineCurve
min_arps_exponent	minimum value for Arps Exponent	these variables are set in user settings and are used in the initial calculation of the SPAD Decline auto-analysis. They constraint the auto analysis range for arps exponent.
max_arps_exponent	maximum value for Arps Exponent
pressures
press_initial_psia		Can be used in any physics based model, including material balance, PVT, flow equations, RTA/PTA etc	P_i
press_sandface_psia	Pressures at bottom of well		P_sf
press_tubing_psia	wellhead pressure	In physics models, often converted to press_sandface_psia (the user can select tubing or casing)	P_wh
press_casing_psia	wellhead pressure	In physics models, often converted to press_sandface_psia	P_wh
press_average_psia		In physics models, often converted to press_sandface_psia (the user can select tubing or casing)	P_r , P
press_mp		This may be used a general case where when we have function that take
press_initial_mp
press_average_mp
~~pressure_sandface_mp~~
press_reduced		Always dimensionless. Used heavily in PVT and EOS
press_critical_psia
press_average_psia_ star		Currently used in FBM for “Flowing P/z “ where average reservoir pressure is caculated using PI etc.	P_r , P
Temperatures
temperature_reservoir_far	Temperature at bottom of well or in subsurface		T_f
temperature_critical_rankin		Used in many PVT equations and EOS. Used heavily in PVT and EOS
temperature_wellhead_far
temperature_reduced		Always dimensionless.
Resource Volumes
ogip_bcf	original gas-in-place	used for scenarios with only 1 gas-in-place value such as conventional models	G, OGIP
ogip_bcf_total	original gas-in-place	used for scenarios with only where there may be multiple gas sources (CSG, Shale, etc)	G_t, OGIP_t
ogip_bcf_free	free gas component of original gas-in-place	Generally used in systems like shale and/or CSG/CBM. Can be zero if Sw =1	G_f, OGIP_f
ogip_bcf_absorbed	adsorbed gas component of gas-in-place	Generally used in systems like shale and/or CSG/CBM	G_a, OGIP_a
ogip_mmscf	see above, different units
ogip_mmscf_total	see above, different units
ogip_mmscf_free	see above, different units
ogip_mmscf_absorbed	see above, different units

ooip_bbl	original oil-in-place
ooip_mbbl	see above, different units
owip_bbl	original water-in-place	Currently used in CSG, and other models where there is a moveable water
Permeability & Flow Capacity
perm_md	permeability - general
perm_x_md	permeability x-direction
perm_y_md	permeability y-direction
perm_z_md	permeability z-direction
perm_hz_md	derived from perm_x_md and perm_y_md
perm_vert_md
net_pay_ft		Used in all physics modules, RTA, PTA, and similar. Generally a user input.	h
Viscosity
viscosity_gas_cp		from correlation or EOS, and used in any of the physics based modules (Tahk, RTA, PTA, FMB etc)	ug, mu_g, u_g
viscosity_water_cp		from correlation or EOS, and used in any of the physics based modules (Tahk, RTA, PTA, FMB etc)	uw, mu_w, u_w
viscosity_oil_cp		from correlation or EOS, and used in any of the physics based modules (Tahk, RTA, PTA, FMB etc)
viscosity_mixture_cp		Used in wellbore model (when fluid viscosities are combined)
viscosity_XX		Distinguish between slip and no slip viscosity
Velocity (Often used in Closed Conduits and Pipes)
velocity_gas_superficial or ~~vel_gas_super_fps~~
Velocity_fts
velocity_water_superficial or ~~vel_water_superficial_fps~~
velocity_oil_superficial or ~~vel_oil_superficial_fps~~
velocity_mixture_fps


area_Acres
diameter_in
re_ft
rw_ft
Formation Volume Factors
Bo	oil formation volume factor	generally dimensionless sbbl/rbbl scf/rcf scm/rcm
Bw	water formation volume factor	generally dimensionless sbbl/rbbl scf/rcf scm/rcm
Bg_dim	gas formation volume factor unit 1
Bg_scfbbl	gas formation volume factor unit 2
RS_scfbbl	solution gas ratio
Z-factors
z_factor	gas deviation factor, super compressibility factor, etc.	Used in any gas physics modules, and from PVT and EOS. Numerically calculated.	z
z_star	generalized z values for scenarios beyond traditonal z-factor	Can be applied to multiple scenarios Back-calculated from PSS equation and P* Account for unconventional systems in P/z	z*, z
z_star_initial	z_star at initial boundary conditions for non traditional situations	Can be applied to multiple scenarios Back-calculated from PSS equation and P* Account for unconventional systems in P/z	z_i*, z_i
gas_specific_gravity			Sg, SG
oil_API
dimensionless RTA/PTA variables and nomenclature
X
X
X




Relative Permeability & Saturations
nw	water relative perm exponent	dimesionless
no	oil relative perm exponnent	dimensionless
ng	gas relative perm exponent	dimensionless
krg	relative permeability to gas	dimensionless
krw	relative permeability to water	dimensionless
kro	relative permeability to oil	dimensionless
sw_initial		Need to discuss units with engineers (passing decimal vs percentages)
sw_connate		Need to discuss units with engineers
sw_average	average water saturation	Need to discuss units with engineers
CSG or shale variables
gas_content_scfton
langmuir_vl_scfton
langmuir_pl_psia
langmuir_ash_content	Average ash fraction
langmuir_wat_content	Average equilibrium moisture
rho_coal_gcc
water_sat_initial		what do we use as inputs for units?
water_sat_current
compressibilities
cw_psia	water compressibility	PVT or EOS
cg_psia	gas compressibility	PVT or EOS
co_psia	oil compressibility	PVT or EOS
cf_psia	formation compressibility	Can be a user input, or correlation. Correlation for most cases. User input for coal bed methane
ct_psia	total system compressibility	numerous combinations from cw, cg, co, and cf above.
porosity_initial	reservoir porosity