alpenglow.cpp package¶

The classes in this module are usually not used directly, but instead through the alpenglow.Getter class. For more info, read TODO: named parameters, memory management and self_test().

offline_learners¶

class alpenglow.cpp.OfflineLearner¶

Bases: sip.wrapper

iterate()¶

self_test()¶

class alpenglow.cpp.OfflineIteratingLearnerParameters¶

Bases: sip.wrapper

number_of_iterations¶

seed¶

class alpenglow.cpp.OfflineIteratingLearner¶

Bases: alpenglow.cpp.OfflineLearner

add_early_simple_updater()¶

add_gradient_updater()¶

add_simple_updater()¶

iterate()¶

self_test()¶

set_gradient_computer()¶

set_model()¶

set_recommender_data()¶

class alpenglow.cpp.OfflineIteratingImplicitLearner¶

Bases: alpenglow.cpp.OfflineLearner

add_early_simple_updater()¶

add_gradient_updater()¶

add_simple_updater()¶

iterate()¶

self_test()¶

set_gradient_computer()¶

set_model()¶

set_negative_sample_generator()¶

set_recommender_data()¶

class alpenglow.cpp.OfflineIteratingImplicitLearnerParameters¶

Bases: sip.wrapper

number_of_iterations¶

seed¶

offline_experiment¶

class alpenglow.cpp.OfflineExperiment¶

Bases: sip.wrapper

add_offline_evaluator()¶

add_offline_learner()¶

run()¶

self_test()¶

offline_evaluators¶

class alpenglow.cpp.OfflineEvaluator¶

Bases: sip.wrapper

evaluate()¶

self_test()¶

class alpenglow.cpp.PrecisionRecallEvaluatorParameters¶

Bases: sip.wrapper

cutoff¶

test_file_name¶

test_file_type¶

time¶

class alpenglow.cpp.PrecisionRecallEvaluator¶

Bases: alpenglow.cpp.OfflineEvaluator

evaluate()¶

self_test()¶

set_model()¶

set_model_filter()¶

set_train_data()¶

class alpenglow.cpp.OfflinePredictions¶

Bases: sip.wrapper

items¶

ranks¶

users¶

class alpenglow.cpp.OfflineRankingComputerParameters¶

Bases: sip.wrapper

top_k¶

class alpenglow.cpp.OfflineRankingComputer¶

Bases: sip.wrapper

compute()¶

set_items()¶

set_toplist_creator()¶

set_users()¶

online_experiment¶

class alpenglow.cpp.ExperimentEnvironment¶

Bases: sip.wrapper

get_max_time()¶

get_min_time()¶

get_popularity_container()¶

get_popularity_sorted_container()¶

get_random()¶

get_recommender_data_iterator()¶

get_top_k()¶

get_train_matrix()¶

is_item_new_for_user()¶

is_lookback()¶

set_parameters()¶

update()¶

class alpenglow.cpp.OnlineExperimentParameters¶

Bases: sip.wrapper

initialize_all¶

lookback¶

max_item¶

max_time¶

max_user¶

min_time¶

random_seed¶

top_k¶

class alpenglow.cpp.OnlineExperiment¶

Bases: sip.wrapper

add_logger()¶

add_updater()¶

inject_experiment_environment_into()¶

run()¶

self_test()¶

set_recommender_data_iterator()¶

Filters¶

This is the filters header file.

class alpenglow.cpp.FactorModelFilter¶

Bases: alpenglow.cpp.ModelFilter, alpenglow.cpp.INeedExperimentEnvironment

get_global_items()¶

get_global_users()¶

run()¶

self_test()¶

set_experiment_environment()¶

set_items()¶

set_model()¶

set_users()¶

class alpenglow.cpp.DummyModelFilter¶

Bases: alpenglow.cpp.ModelFilter, alpenglow.cpp.INeedExperimentEnvironment, alpenglow.cpp.Initializable

init()¶

run()¶

self_test()¶

set_experiment_environment()¶

set_items()¶

set_users()¶

class alpenglow.cpp.AvailabilityFilter¶

Bases: alpenglow.cpp.ModelFilter

This is the docstring for AvailabilityFilter. This filter filters the set of available items based on (time,itemId,duration) triplets. These have to be preloaded before using this filter.

Sample code

def some_function():
  interesting = False
  print 'This line is highlighted.'
  print 'This one is not...'
  print '...but this one is.'

# this is python code
f = rs.AvailabilityFilter()
f.add_availability(10,1,10) #item 1 is available in the time interval (10,20)

active()¶

add_availability()¶

get_global_items()¶

run(rec_dat)¶

Summary line.

Extended description of function.

Parameters:	arg1 (int) – Description of arg1 arg2 (str) – Description of arg2
Returns:	Description of return value
Return type:	bool

self_test()¶

class alpenglow.cpp.ModelFilter¶

Bases: sip.wrapper

active()¶

run()¶

self_test()¶

online_data_updater¶

gradient_computers¶

class alpenglow.cpp.GradientComputer¶

Bases: alpenglow.cpp.Updater

add_gradient_updater()¶

self_test()¶

set_model()¶

class alpenglow.cpp.GradientComputerPointWise¶

Bases: alpenglow.cpp.GradientComputer

get_gradient()¶

self_test()¶

set_objective()¶

update()¶

ranking¶

class alpenglow.cpp.RankComputerParameters¶

Bases: sip.wrapper

random_seed¶

top_k¶

class alpenglow.cpp.RankComputer¶

Bases: alpenglow.cpp.INeedExperimentEnvironment, alpenglow.cpp.Initializable

get_rank()¶

init()¶

self_test()¶

set_experiment_environment()¶

set_model()¶

set_model_filter()¶

set_top_pop_container()¶

set_train_matrix()¶

interfaces¶

objectives¶

class alpenglow.cpp.ObjectivePairWise¶: Bases: sip.wrapper

class alpenglow.cpp.ObjectivePointWise¶

Bases: sip.wrapper

get_gradient()¶

class alpenglow.cpp.ObjectiveListWise¶

Bases: sip.wrapper

get_gradient()¶

class alpenglow.cpp.ObjectiveMSE¶

Bases: alpenglow.cpp.ObjectivePointWise

get_gradient()¶

loggers¶

class alpenglow.cpp.ListConditionalMetaLogger¶

Bases: alpenglow.cpp.ConditionalMetaLogger

should_run()¶

class alpenglow.cpp.ListConditionalMetaLoggerParameters¶

Bases: sip.wrapper

should_run_vector¶

class alpenglow.cpp.InterruptLogger¶

Bases: alpenglow.cpp.Logger

run()¶

class alpenglow.cpp.RankingLog¶

Bases: sip.wrapper

id¶

item¶

prediction¶

rank¶

score¶

time¶

user¶

class alpenglow.cpp.MemoryRankingLoggerParameters¶

Bases: sip.wrapper

min_time¶

out_file¶

class alpenglow.cpp.RankingLogs¶

Bases: sip.wrapper

logs¶

top_k¶

class alpenglow.cpp.MemoryRankingLogger¶

Bases: alpenglow.cpp.Logger

run()¶

set_model()¶

set_rank_computer()¶

set_ranking_logs()¶

class alpenglow.cpp.ConditionalMetaLogger¶

Bases: alpenglow.cpp.Logger, alpenglow.cpp.Initializable

init()¶

run()¶

self_test()¶

set_logger()¶

should_run()¶

class alpenglow.cpp.ProceedingLogger¶

Bases: alpenglow.cpp.Logger, alpenglow.cpp.Initializable, alpenglow.cpp.INeedExperimentEnvironment

init()¶

run()¶

self_test()¶

set_data_iterator()¶

set_experiment_environment()¶

class alpenglow.cpp.OnlinePredictor¶

Bases: alpenglow.cpp.Logger

run()¶

self_test()¶

set_prediction_creator()¶

class alpenglow.cpp.OnlinePredictorParameters¶

Bases: sip.wrapper

file_name¶

min_time¶

time_frame¶

class alpenglow.cpp.PredictionLogger¶

Bases: alpenglow.cpp.Logger

get_predictions()¶

run()¶

self_test()¶

set_prediction_creator()¶

class alpenglow.cpp.OnlinePredictions¶

Bases: sip.wrapper

ids¶

items¶

ranks¶

scores¶

times¶

users¶

class alpenglow.cpp.Logger¶

Bases: sip.wrapper

run()¶

self_test()¶

online_learners¶

class alpenglow.cpp.PeriodicImplicitGradientLearnerParameters¶

Bases: alpenglow.cpp.PeriodicLearnerParameters

learn¶

number_of_iterations¶

seed¶

turn_off_random_shuffling¶

class alpenglow.cpp.PeriodicImplicitGradientLearner¶

Bases: alpenglow.cpp.PeriodicLearner

add_iteration_logger()¶

self_test()¶

set_gradient_computer()¶

set_negative_sample_generator()¶

class alpenglow.cpp.OfflineImplicitGradientLearner¶

Bases: alpenglow.cpp.PeriodicImplicitGradientLearner

self_test()¶

class alpenglow.cpp.OfflineImplicitGradientLearnerParameters¶: Bases: alpenglow.cpp.PeriodicImplicitGradientLearnerParameters

class alpenglow.cpp.LearnerPeriodicDelayedWrapperParameters¶

Bases: sip.wrapper

delay¶

period¶

class alpenglow.cpp.LearnerPeriodicDelayedWrapper¶

Bases: alpenglow.cpp.Updater

self_test()¶

set_wrapped_learner()¶

update()¶

class alpenglow.cpp.PeriodicSamplingLearner¶

Bases: alpenglow.cpp.PeriodicImplicitGradientLearner

self_test()¶

class alpenglow.cpp.PeriodicSamplingLearnerParameters¶

Bases: alpenglow.cpp.PeriodicImplicitGradientLearnerParameters

distribution¶

geometric_param¶

number_of_samples¶

y¶

class alpenglow.cpp.ImplicitGradientLearner¶

Bases: alpenglow.cpp.Updater, alpenglow.cpp.Initializable, alpenglow.cpp.INeedExperimentEnvironment

add_gradient_updater()¶

add_multi_updater()¶

add_simple_updater()¶

init()¶

self_test()¶

set_experiment_environment()¶

set_gradient_computer()¶

set_model()¶

set_negative_sample_generator()¶

set_train_matrix()¶

update()¶

class alpenglow.cpp.PeriodicLearnerParameters¶

Bases: sip.wrapper

base_in_file_name¶

base_out_file_name¶

clear_model¶

mode¶

period_length¶

read_model¶

samplenum_in_periods¶

start_time¶

write_model¶

class alpenglow.cpp.PeriodicLearner¶

Bases: alpenglow.cpp.Updater, alpenglow.cpp.Initializable, alpenglow.cpp.INeedExperimentEnvironment

add_gradient_updater()¶

add_multi_updater()¶

add_simple_updater()¶

init()¶

self_test()¶

set_experiment_environment()¶

set_model()¶

set_recommender_data_iterator()¶

update()¶

class alpenglow.cpp.PeriodicTimeframeImplicitGradientLearnerParameters¶

Bases: alpenglow.cpp.PeriodicImplicitGradientLearnerParameters

timeframe_length¶

class alpenglow.cpp.PeriodicTimeframeImplicitGradientLearner¶

Bases: alpenglow.cpp.PeriodicImplicitGradientLearner

self_test()¶

set_local_items()¶

set_local_train_matrix()¶

negative_sample_generators¶

class alpenglow.cpp.UniformNegativeSampleGenerator¶

Bases: alpenglow.cpp.NegativeSampleGenerator, alpenglow.cpp.Initializable, alpenglow.cpp.INeedExperimentEnvironment

init()¶

self_test()¶

set_experiment_environment()¶

set_items()¶

set_train_matrix()¶

class alpenglow.cpp.UniformNegativeSampleGeneratorParameters¶

Bases: sip.wrapper

filter_repeats¶

initialize_all¶

max_item¶

negative_rate¶

seed¶

class alpenglow.cpp.NegativeSampleGenerator¶

Bases: alpenglow.cpp.Updater

add_updater()¶

self_test()¶

update()¶

general_interfaces¶

class alpenglow.cpp.Updater¶

Bases: sip.wrapper

self_test()¶

update()¶

class alpenglow.cpp.Initializable¶

Bases: sip.wrapper

This interface signals that the implementing class has to be initialized by the experiment runner. The experiment runner calls the initialize() method, which in return calls the class-specific implementation of init() and sets the is_initialized() flag if the initialization was successful. The init() method can check whether the neccessary dependencies have been initialized or not before initializing the instance; and should return the success value accordingly.

If the initialization was not successful, the experiment runner keeps trying to initialize the not-yet initialized objects, thus resolving dependency chains.

init()¶

Has to be implemented by the component.

Returns:	Whether the initialization was successful.
Return type:	bool

initialize()¶

Returns:	Whether the initialization was successful.
Return type:	bool

is_initialized()¶

Returns:	Whether the component has already been initialized.
Return type:	bool

class alpenglow.cpp.INeedExperimentEnvironment¶

Bases: sip.wrapper

set_experiment_environment()¶

utils¶

class alpenglow.cpp.Recency¶

Bases: sip.wrapper

get()¶

update()¶

class alpenglow.cpp.PowerLawRecency¶

Bases: alpenglow.cpp.Recency

get()¶

update()¶

class alpenglow.cpp.PowerLawRecencyParameters¶

Bases: sip.wrapper

delta_t¶

exponent¶

class alpenglow.cpp.SpMatrix¶

Bases: sip.wrapper

clear()¶

erase()¶

get()¶

has_value()¶

increase()¶

insert()¶

read_from_file()¶

resize()¶

row_size()¶

size()¶

update()¶

write_into_file()¶

class alpenglow.cpp.TopPopContainer¶

Bases: sip.wrapper

get_index()¶

get_item()¶

has_changed()¶

increase()¶

reduce()¶

set_threshold()¶

size()¶

class alpenglow.cpp.PopContainer¶

Bases: sip.wrapper

clear()¶

get()¶

increase()¶

reduce()¶

resize()¶

class alpenglow.cpp.PredictionCreatorPersonalized¶

Bases: alpenglow.cpp.PredictionCreator

run()¶

self_test()¶

class alpenglow.cpp.PredictionCreatorPersonalizedParameters¶: Bases: alpenglow.cpp.PredictionCreatorParameters

class alpenglow.cpp.PredictionCreatorParameters¶

Bases: sip.wrapper

lookback¶

top_k¶

class alpenglow.cpp.PredictionCreator¶

Bases: alpenglow.cpp.INeedExperimentEnvironment, alpenglow.cpp.Initializable

init()¶

run()¶

self_test()¶

set_experiment_environment()¶

set_filter()¶

set_model()¶

set_train_matrix()¶

class alpenglow.cpp.PredictionCreatorGlobalParameters¶

Bases: alpenglow.cpp.PredictionCreatorParameters

initial_threshold¶

class alpenglow.cpp.PredictionCreatorGlobal¶

Bases: alpenglow.cpp.PredictionCreator

run()¶

self_test()¶

class alpenglow.cpp.Random¶

Bases: sip.wrapper

get()¶

get_arctg()¶

get_geometric()¶

get_linear()¶

set()¶

class alpenglow.cpp.Bias¶

Bases: sip.wrapper

clear()¶

get()¶

init()¶

update()¶

recommender_data¶

class alpenglow.cpp.DataframeData¶

Bases: alpenglow.cpp.RecommenderData

add_recdats()¶

get()¶

init()¶

size()¶

class alpenglow.cpp.RecPred¶

Bases: sip.wrapper

prediction¶

score¶

class alpenglow.cpp.RecommenderData¶

Bases: alpenglow.cpp.Initializable

get()¶

get_items_into()¶

get_rec_data()¶

get_users_into()¶

init()¶

items()¶

matrix()¶

read_from_file()¶

set_attribute_container()¶

set_max_time()¶

set_rec_dats()¶

size()¶

users()¶

class alpenglow.cpp.RecommenderDataParameters¶

Bases: sip.wrapper

file_name¶

type¶

class alpenglow.cpp.RecDat¶

Bases: sip.wrapper

category¶

eval¶

id¶

item¶

score¶

time¶

user¶

class alpenglow.cpp.FactorRepr¶

Bases: sip.wrapper

entity¶

factors¶

class alpenglow.cpp.UserItemFactors¶

Bases: sip.wrapper

item_factors¶

user_factors¶

class alpenglow.cpp.FactorModelReader¶

Bases: sip.wrapper

read()¶

class alpenglow.cpp.InlineAttributeReader¶

Bases: sip.wrapper

read_attribute()¶

self_test()¶

class alpenglow.cpp.RecommenderDataIterator¶

Bases: alpenglow.cpp.Initializable

get()¶

get_counter()¶

get_following_timestamp()¶

get_future()¶

has_next()¶

init()¶

next()¶

set_recommender_data()¶

size()¶

class alpenglow.cpp.ShuffleIteratorParameters¶

Bases: sip.wrapper

seed¶

class alpenglow.cpp.ShuffleIterator¶

Bases: alpenglow.cpp.RecommenderDataIterator

get()¶

get_following_timestamp()¶

get_future()¶

init()¶

next()¶

models¶

class alpenglow.cpp.ModelMultiUpdater¶

Bases: sip.wrapper

self_test()¶

update()¶

class alpenglow.cpp.ModelSimpleUpdater¶

Bases: alpenglow.cpp.Updater

self_test()¶

update()¶

class alpenglow.cpp.ModelGradientUpdater¶

Bases: sip.wrapper

beginning_of_updating_cycle()¶

end_of_updating_cycle()¶

self_test()¶

update()¶

models.baseline¶

class alpenglow.cpp.PopularityTimeFrameModelUpdater¶

Bases: alpenglow.cpp.ModelSimpleUpdater

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.PopularityTimeFrameModelUpdaterParameters¶

Bases: sip.wrapper

tau¶

class alpenglow.cpp.TransitionProbabilityModel¶

Bases: alpenglow.cpp.Model, alpenglow.cpp.ModelFilter

add()¶

prediction()¶

self_test()¶

class alpenglow.cpp.TransitionProbabilityModelUpdater¶

Bases: alpenglow.cpp.ModelSimpleUpdater

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.TransitionProbabilityModelUpdaterParameters¶

Bases: sip.wrapper

filter_freq_updates¶

label_file_name¶

label_transition_mode¶

mode¶

class alpenglow.cpp.PopularityModel¶

Bases: alpenglow.cpp.Model

add()¶

prediction()¶

class alpenglow.cpp.NearestNeighborModelUpdater¶

Bases: alpenglow.cpp.ModelSimpleUpdater

end_of_updating()¶

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.NearestNeighborModelUpdaterParameters¶

Bases: sip.wrapper

compute_similarity_period¶

period_mode¶

class alpenglow.cpp.NearestNeighborModelParameters¶

Bases: sip.wrapper

direction¶

gamma¶

gamma_threshold¶

norm¶

num_of_neighbors¶

class alpenglow.cpp.NearestNeighborModel¶

Bases: alpenglow.cpp.Model, alpenglow.cpp.ModelFilter

add()¶

prediction()¶

self_test()¶

class alpenglow.cpp.PersonalPopularityModel¶

Bases: alpenglow.cpp.Model

add()¶

prediction()¶

class alpenglow.cpp.PopularityModelUpdater¶

Bases: alpenglow.cpp.ModelSimpleUpdater

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.PersonalPopularityModelUpdater¶

Bases: alpenglow.cpp.ModelSimpleUpdater

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.Model¶

Bases: sip.wrapper

add()¶

clear()¶

prediction()¶

read()¶

self_test()¶

write()¶

class alpenglow.cpp.MassPredictor¶

Bases: sip.wrapper

predict()¶

set_model()¶

class alpenglow.cpp.SimilarityModel¶

Bases: sip.wrapper

similarity()¶

models.combination¶

models.factor¶

class alpenglow.cpp.AsymmetricFactorModelUpdater¶

Bases: alpenglow.cpp.ModelSimpleUpdater

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.SvdppModel¶

Bases: alpenglow.cpp.Model

add()¶

clear()¶

prediction()¶

self_test()¶

class alpenglow.cpp.SvdppModelParameters¶

Bases: sip.wrapper

begin_max¶

begin_min¶

dimension¶

gamma¶

history_weight¶

norm_type¶

seed¶

use_sigmoid¶

user_vector_weight¶

class alpenglow.cpp.SvdppModelGradientUpdaterParameters¶

Bases: sip.wrapper

cumulative_item_updates¶

learning_rate¶

class alpenglow.cpp.SvdppModelGradientUpdater¶

Bases: alpenglow.cpp.ModelGradientUpdater

beginning_of_updating_cycle()¶

end_of_updating_cycle()¶

init()¶

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.AsymmetricFactorModel¶

Bases: alpenglow.cpp.Model

add()¶

clear()¶

prediction()¶

self_test()¶

class alpenglow.cpp.AsymmetricFactorModelParameters¶

Bases: sip.wrapper

begin_max¶

begin_min¶

dimension¶

gamma¶

initialize_all¶

max_item¶

norm_type¶

seed¶

use_sigmoid¶

class alpenglow.cpp.FactorModel¶

Bases: alpenglow.cpp.Model, alpenglow.cpp.SimilarityModel, alpenglow.cpp.Initializable

add()¶

clear()¶

init()¶

prediction()¶

self_test()¶

set_item_recency()¶

set_user_recency()¶

similarity()¶

class alpenglow.cpp.FactorModelParameters¶

Bases: sip.wrapper

begin_max¶

begin_min¶

dimension¶

initialize_all¶

max_item¶

max_user¶

use_item_bias¶

use_sigmoid¶

use_user_bias¶

class alpenglow.cpp.SvdppModelUpdater¶

Bases: alpenglow.cpp.ModelSimpleUpdater

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.FactorModelGradientUpdaterParameters¶

Bases: sip.wrapper

learning_rate¶

learning_rate_bias¶

regularization_rate¶

regularization_rate_bias¶

turn_off_item_bias_updates¶

turn_off_item_factor_updates¶

turn_off_user_bias_updates¶

turn_off_user_factor_updates¶

class alpenglow.cpp.FactorModelGradientUpdater¶

Bases: alpenglow.cpp.ModelGradientUpdater

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.AsymmetricFactorModelGradientUpdater¶

Bases: alpenglow.cpp.ModelGradientUpdater

beginning_of_updating_cycle()¶

end_of_updating_cycle()¶

self_test()¶

set_model()¶

update()¶

class alpenglow.cpp.AsymmetricFactorModelGradientUpdaterParameters¶

Bases: sip.wrapper

cumulative_item_updates¶

learning_rate¶