Skip to main content

factor model

Project description

This programme is built for back-testing factors.


  • python 3.5
  • pandas 0.23.0
  • numba 0.38.0
  • empyrical 0.5.0
  • data_box
  • pickle
  • multiprocessing
  • joblib


Basic definitions

  1. v_t,s_t,c_t: total value, stock value and cash value at time t after trading
  2. v^f_t,s^f_t,c^f_t: total value, stock value and cash value at time t before trading
  3. ss,sv: suspended stock value and valid stock value
  4. r_t: return at time t
  5. cost_t: cost to trade at time t

Note: s,ss,sv are all vectors while others are numbers


  1. v_t = |s_t| + c_t
  2. s^f_t = s_{t-1} * (1 + r_t) = ss^f_t + sv^f_t = ss_t + sv^f_t
  3. ss_t <- suspend, s^f_t
  4. c_{t-1} + |sv^f_t| = |sv_t| + c_t + cost_t ( where c_t, cost_t >= 0 )
  5. cost_t =|sv_t - sv^f_t| * costRate
  6. weight_t <- factor_{t-1},industry_t,suspend_t ( |weight_t| = 1 or 0 if there is no valid stocks or factors or industries)
  7. define cost^f_t = (2|sv^f_t| + c_{t-1}) * costRate s.t. cost^f_t >= cost_t, which is greater than the maximum cost we may have during the trade
  8. define available_value^f_t = c_{t-1} + |sv^f_t| - cost^f_t, which means the value ( = |sv_t| if weight_t != 0) we have in stocks after trading
  9. let sv_t = weight_t * available_value^f_t s.t. c_t = c_{t-1} + |sv^f_t| - |sv_t| - cost_t >=0

Thus to update v_t, we would start with calculating s^f_t, ss, sv^f_t, then cost^f_t, available_value^f_t, then sv_t, cost_t and c_t, and finally v_t


Data Box: pre-process

from data_box import data_box
# freq can be 'd' or 'm', for detail please refer to db.set_lag doc.

Where price,ind,ind_weight,sus,factor0,factor1 are all dataframes with index as date (yyyymmdd,int) and column as tickers. You can save and load this data box object by'path') and db.load('path'). You can find more in data_box project.

Back Test

from single_factor_model import run_back_test

single process


multi process



with __name__=='__main__':

To check detailed position of each portfolio each day, just assign weight_path.

Summary and Plot

calculate return including long short portfolio(and reverse)

from single_factor_model import calc_return
Return = calc_return(Value,Turnover,long_short,double_side_cost=0.003)


from single_factor_model import summary



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for single-factor-model, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size single_factor_model-0.3.0-py3-none-any.whl (12.1 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page