Tool response
1000→ item = int(prepared.sequence_items[position])
novel = item not in seen
seen.add(item)
if not novel:
# Repeats remain training examples, but they cannot be
# eligible discovery outcomes at the corresponding
# cutoff and therefore keep only the ordinary weight.
weights[position] = config.ordinary_target_weight
continue
timestamps = user_likes.get(item)
1010→ if timestamps is None:
continue
timestamp = int(prepared.sequence_timestamps[position])
upper = min(
timestamp + horizon,
split_timestamp
if position <= last_training_target
else history_end,
)
outcome = int(np.searchsorted(timestamps, timestamp, side="left"))
1020→ if outcome < len(timestamps) and int(timestamps[outcome]) < upper:
weights[position] = config.organic_like_target_weight
grade_three += 1
log(
f"grade-3 first-encounter targets={grade_three:,} "
f"horizon_days={config.discovery_horizon_days}"
)
log(
f"target weighting={config.target_weighting} "
f"min={weights.min():.3f} mean={weights.mean():.3f} "
1030→ f"max={weights.max():.3f}"
)
return weights
def build_dense_block(
prepared: SequenceData,
target_weights: np.ndarray,
users: np.ndarray,
window_starts: np.ndarray,
1040→ process_counts: np.ndarray,
score_starts: np.ndarray,
start: int,
steps: int,
config: Config,
) -> tuple[np.ndarray, ...]:
"""Build one causal sequence block and mark the target rows to score."""
batch_size = len(users)
padding_item = len(prepared.item_ids)
input_items = np.full((batch_size, steps), padding_item, dtype=np.uint16)
1050→ event_features = np.zeros((batch_size, steps, 3), dtype=np.float16)
activity_features = np.zeros((batch_size, steps, 4), dtype=np.float16)
state_ids = np.zeros((batch_size, steps), dtype=np.uint32)
targets = np.zeros((batch_size, steps), dtype=np.uint16)
weights = np.ones((batch_size, steps), dtype=np.float32)
scored = np.zeros((batch_size, steps), dtype=bool)
histories = np.full(
(batch_size, steps, config.bptt_steps),
padding_item,
dtype=np.uint16,
1060→ )
processed = np.zeros(batch_size, dtype=np.int32)
lengths = prepared.lengths
for row, user_row in enumerate(users):
count = min(steps, max(int(process_counts[row]) - start, 0))
if not count:
continue
offset = int(prepared.offsets[user_row])
window_start = int(window_starts[row])
1070→ absolute_start = window_start + start
positions = slice(
offset + absolute_start,
offset + absolute_start + count,
)
target_positions = slice(
offset + absolute_start + 1,
offset + absolute_start + count + 1,
)
input_items[row, :count] = prepared.sequence_items[positions]
1080→ event_features[row, :count] = prepared.event_features[positions]
activity_features[row, :count] = prepared.activity_features[positions]
state_ids[row, :count] = prepared.state_ids[positions]
targets[row, :count] = prepared.sequence_items[target_positions]
weights[row, :count] = target_weights[target_positions]
score_from = min(count, max(int(score_starts[row]) - start, 0))
scored[row, score_from:count] = True
processed[row] = count
user_sequence = prepared.sequence_items[
offset : offset + int(lengths[user_row])
1090→ ]
histories[row, :count] = history_windows(
user_sequence,
absolute_start,
count,
config.bptt_steps,
padding_item,
)
return (
input_items,
1100→ event_features,
activity_features,
state_ids,
targets,
scored,
histories,
processed,
weights,
)
1110→
def score_target_microbatches(
model: base.SequentialTwoTower,
prepared: SequenceData,
config: Config,
sequence_vectors: torch.Tensor,
flat_states: np.ndarray,
flat_activity: np.ndarray,
positive_items: torch.Tensor,
negatives: torch.Tensor,
1120→ negative_weights: torch.Tensor,
sample_weights: np.ndarray,
device: torch.device,
backward: bool,
) -> tuple[dict[str, float], torch.Tensor | None]:
"""Compute one logical block's exact BCE in bounded-memory slices."""
target_count = len(positive_items)
total_weight = float(sample_weights.sum())
if total_weight <= 0:
raise RuntimeError("target block has no positive sample weight")
1130→ sequence_gradient = torch.zeros_like(sequence_vectors) if backward else None
statistics = {
"loss_sum": 0.0,
"positive_sum": 0.0,
"negative_sum": 0.0,
"pair_correct": 0.0,
"weight_sum": 0.0,
}
for begin in range(0, target_count, config.loss_microbatch_size):
end = min(begin + config.loss_microbatch_size, target_count)
1140→ selected_states = flat_states[begin:end]
if backward:
sequence_input = (
sequence_vectors[begin:end].detach().requires_grad_(True)
)
else:
sequence_input = sequence_vectors[begin:end]
liked_vectors, disliked_vectors, _ = pool_explicit_states(
model, prepared, selected_states, device
)
1150→ counts = prepared.state_counts[selected_states]
numeric = np.zeros((end - begin, 6), dtype=np.float32)
numeric[:, :4] = flat_activity[begin:end]
numeric[:, 4] = np.log1p(counts[:, 0]) / 6.0
numeric[:, 5] = np.log1p(counts[:, 1]) / 4.0
query_vectors = user_queries(
model,
sequence_input,
liked_vectors,
disliked_vectors,
1160→ torch.from_numpy(numeric).to(device),
)
positive_vectors, negative_vectors = candidate_vectors(
model,
positive_items[begin:end],
negatives[begin:end],
)
positive_logits = (query_vectors * positive_vectors).sum(dim=1)
negative_logits = torch.einsum(
"bd,bkd->bk", query_vectors, negative_vectors
1170→ )
positive_loss = F.softplus(-positive_logits)
negative_loss = corrected_negative_loss(
negative_logits, negative_weights[begin:end], config
)
selected_weights = torch.from_numpy(
sample_weights[begin:end].astype(np.float32, copy=False)
).to(device)
loss_sum = (
selected_weights * (positive_loss + negative_loss) / 2.0
1180→ ).sum()
if not bool(torch.isfinite(loss_sum)):
raise RuntimeError("dense next-item training produced non-finite loss")
if backward:
(loss_sum / total_weight).backward()
if sequence_input.grad is None:
raise RuntimeError("sequence microbatch did not produce a gradient")
sequence_gradient[begin:end] = sequence_input.grad
statistics["loss_sum"] += float(loss_sum.detach().cpu())
statistics["positive_sum"] += float(positive_logits.detach().sum().cpu())
1190→ statistics["negative_sum"] += float(negative_logits.detach().sum().cpu())
statistics["pair_correct"] += float(
(positive_logits.detach()[:, None] > negative_logits.detach()).sum().cpu()
)
statistics["weight_sum"] += float(selected_weights.sum().detach().cpu())
return statistics, sequence_gradient
def release_accelerator_cache(device: torch.device) -> None:
if device.type == "mps":
1200→ torch.mps.empty_cache()
def run_training_epoch(
model: base.SequentialTwoTower,
optimizer: torch.optim.Optimizer,
prepared: SequenceData,
config: Config,
target_weights: np.ndarray,
window_starts: np.ndarray,
1210→ target_counts: np.ndarray,
item_correction: torch.Tensor,
known_positive_packed: np.ndarray | None,
generator: torch.Generator,
device: torch.device,
epoch: int,
) -> dict[str, float]:
model.train()
train_users = np.flatnonzero(target_counts > 0)
sorted_users = train_users[
1220→ np.argsort(target_counts[train_users], kind="stable")
]
groups = [
sorted_users[start : start + config.user_batch_size]
for start in range(0, len(sorted_users), config.user_batch_size)
]
group_order = torch.randperm(len(groups), generator=generator).numpy()
negative_count = config.uniform_negatives + config.inbatch_negatives
total_loss = 0.0
total_targets = 0
1230→ total_weight = 0.0
total_positive = 0.0
total_negative = 0.0
total_pair_correct = 0.0
batches = 0
started = time.monotonic()
for group_number in group_order:
users = groups[int(group_number)]
group_counts = target_counts[users]
1240→ hidden = torch.zeros(
1, len(users), config.embedding_dim, device=device
)
max_targets = int(group_counts.max())
for start in range(0, max_targets, config.bptt_steps):
steps = min(config.bptt_steps, max_targets - start)
block = build_dense_block(
prepared,
target_weights,
users,
1250→ window_starts[users],
group_counts,
np.zeros(len(users), dtype=np.int64),
start,
steps,
config,
)
sequence_outputs, _ = event_sequence(
model,
torch.from_numpy(block[0].astype(np.int64)).to(device),
1260→ torch.from_numpy(block[1].astype(np.float32)).to(device),
hidden,
)
hidden = torch.stack(
[
sequence_outputs[row, count - 1]
if count
else hidden[0, row]
for row, count in enumerate(block[7])
]
1270→ ).unsqueeze(0).detach()
flat_scored = block[5].reshape(-1)
if not np.any(flat_scored):
continue
mask = torch.from_numpy(flat_scored).to(device)
sequence_vectors = sequence_outputs.reshape(
-1, config.embedding_dim
)[mask]
flat_states = block[3].reshape(-1)[flat_scored]
positive_items = torch.from_numpy(
1280→ block[4].reshape(-1)[flat_scored].astype(np.int64)
).to(device)
known_history = torch.from_numpy(
block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(
np.int64
)
).to(device)
liked_items = torch.from_numpy(
prepared.liked_states[flat_states].astype(np.int64)
).to(device)
1290→ flat_user_rows = np.broadcast_to(
users[:, None], block[5].shape
).reshape(-1)[flat_scored]
negatives, negative_weights = draw_training_negatives(
positive_items,
known_history,
liked_items,
flat_user_rows,
known_positive_packed,
prepared,
1300→ config,
item_correction,
generator,
device,
)
optimizer.zero_grad(set_to_none=True)
statistics, sequence_gradient = score_target_microbatches(
model,
prepared,
config,
1310→ sequence_vectors,
flat_states,
block[2].reshape(-1, 4)[flat_scored].astype(np.float32),
positive_items,
negatives,
negative_weights,
block[8].reshape(-1)[flat_scored],
device,
backward=True,
)
1320→ if sequence_gradient is None:
raise RuntimeError("training block omitted its sequence gradient")
sequence_vectors.backward(sequence_gradient)
nn.utils.clip_grad_norm_(model.parameters(), config.gradient_clip)
optimizer.step()
count = len(positive_items)
total_loss += statistics["loss_sum"]
total_targets += count
total_weight += statistics["weight_sum"]
1330→ total_positive += statistics["positive_sum"]
total_negative += statistics["negative_sum"]
total_pair_correct += statistics["pair_correct"]
batches += 1
if batches % 25 == 0:
release_accelerator_cache(device)
if batches % 250 == 0:
batch_bce = statistics["loss_sum"] / max(
statistics["weight_sum"], 1.0e-12
)
1340→ running_bce = total_loss / max(total_weight, 1.0e-12)
log(
f"epoch={epoch}/{config.epochs} batches={batches:,} "
f"targets={total_targets:,} "
f"batch_bce={batch_bce:.6f} "
f"running_bce={running_bce:.6f} "
f"elapsed={time.monotonic() - started:.1f}s"
)
return {
1350→ "epoch": float(epoch),
"loss": total_loss / max(total_weight, 1.0e-12),
"positive_logit": total_positive / max(total_targets, 1),
"negative_logit": total_negative / max(total_targets * negative_count, 1),
"pair_accuracy": total_pair_correct
/ max(total_targets * negative_count, 1),
"targets": float(total_targets),
"target_weight_sum": total_weight,
"batches": float(batches),
"seconds": time.monotonic() - started,
1360→ }
@torch.no_grad()
def evaluate_validation_bce(
model: base.SequentialTwoTower,
prepared: SequenceData,
config: Config,
target_weights: np.ndarray,
window_starts: np.ndarray,
1370→ training_counts: np.ndarray,
validation_counts: np.ndarray,
item_correction: torch.Tensor,
known_positive_packed: np.ndarray | None,
device: torch.device,
) -> dict[str, float]:
"""Measure deterministic BCE on each user's chronological target suffix."""
model.eval()
totals = training_counts + validation_counts
users_with_validation = np.flatnonzero(validation_counts > 0)
1380→ ordered = users_with_validation[
np.argsort(totals[users_with_validation], kind="stable")
]
groups = [
ordered[start : start + config.user_batch_size]
for start in range(0, len(ordered), config.user_batch_size)
]
generator = torch.Generator(device="cpu").manual_seed(config.seed + 20_000)
total_loss = 0.0
total_targets = 0
1390→ total_weight = 0.0
started = time.monotonic()
for group_number, users in enumerate(groups, start=1):
group_totals = totals[users]
group_starts = training_counts[users]
hidden = torch.zeros(
1, len(users), config.embedding_dim, device=device
)
max_targets = int(group_totals.max())
1400→ for start in range(0, max_targets, config.bptt_steps):
steps = min(config.bptt_steps, max_targets - start)
block = build_dense_block(
prepared,
target_weights,
users,
window_starts[users],
group_totals,
group_starts,
start,
1410→ steps,
config,
)
sequence_outputs, _ = event_sequence(
model,
torch.from_numpy(block[0].astype(np.int64)).to(device),
torch.from_numpy(block[1].astype(np.float32)).to(device),
hidden,
)
hidden = torch.stack(
1420→ [
sequence_outputs[row, count - 1]
if count
else hidden[0, row]
for row, count in enumerate(block[7])
]
).unsqueeze(0)
flat_scored = block[5].reshape(-1)
if not np.any(flat_scored):
continue
1430→ mask = torch.from_numpy(flat_scored).to(device)
sequence_vectors = sequence_outputs.reshape(
-1, config.embedding_dim
)[mask]
flat_states = block[3].reshape(-1)[flat_scored]
positive_items = torch.from_numpy(
block[4].reshape(-1)[flat_scored].astype(np.int64)
).to(device)
known_history = torch.from_numpy(
block[6].reshape(-1, config.bptt_steps)[flat_scored].astype(
1440→ np.int64
)
).to(device)
liked_items = torch.from_numpy(
prepared.liked_states[flat_states].astype(np.int64)
).to(device)
flat_user_rows = np.broadcast_to(
users[:, None], block[5].shape
).reshape(-1)[flat_scored]
negatives, negative_weights = draw_training_negatives(
1450→ positive_items,
known_history,
liked_items,
flat_user_rows,
known_positive_packed,
prepared,
config,
item_correction,
generator,
device,
1460→ )
statistics, _ = score_target_microbatches(
model,
prepared,
config,
sequence_vectors,
flat_states,
block[2].reshape(-1, 4)[flat_scored].astype(np.float32),
positive_items,
negatives,
1470→ negative_weights,
block[8].reshape(-1)[flat_scored],
device,
backward=False,
)
total_loss += statistics["loss_sum"]
total_targets += len(positive_items)
total_weight += statistics["weight_sum"]
if group_number % 25 == 0:
release_accelerator_cache(device)
1480→ return {
"validation_loss": total_loss / max(total_weight, 1.0e-12),
"validation_targets": float(total_targets),
"validation_target_weight_sum": total_weight,
"validation_seconds": time.monotonic() - started,
}
def snapshot_model(model: nn.Module) -> dict[str, torch.Tensor]:
return {
1490→ name: value.detach().cpu().clone()
for name, value in model.state_dict().items()
}
def save_epoch_checkpoint(
checkpoint_dir: Path,
epoch: int,
model_state: dict[str, torch.Tensor],
config: Config,
1500→ diagnostics: dict[str, float],
optimizer: torch.optim.Optimizer,
generator: torch.Generator,
) -> Path:
checkpoint_dir.mkdir(parents=True, exist_ok=True)
path = checkpoint_dir / f"epoch-{epoch:02d}.pt"
torch.save(
{
"epoch": epoch,
"config": asdict(config),
1510→ "diagnostics": diagnostics,
"model_state": model_state,
"optimizer_state": optimizer.state_dict(),
"generator_state": generator.get_state(),
},
path,
)
log(f"saved epoch checkpoint: {path}")
return path
1520→
def train_model(
public: Path,
stage: str,
prepared: SequenceData,
config: Config,
device: torch.device,
checkpoint_dir: Path | None,
resume_checkpoint: Path | None,
) -> tuple[base.SequentialTwoTower, list[dict[str, float]]]:
1530→ partition = chronological_target_partition(
prepared,
config.validation_fraction,
config.max_train_targets_per_user,
config.max_validation_targets_per_user,
)
training_counts = partition.training_counts
validation_counts = partition.validation_counts
log(
f"chronological BCE window: train={int(training_counts.sum()):,} "
1540→ f"validation={int(validation_counts.sum()):,} "
f"selected={partition.selected_count:,} "
f"discarded_old_targets={int(partition.window_starts.sum()):,} "
f"all={prepared.target_count:,}"
)
model = base.SequentialTwoTower(prepared.item_features, model_config(config)).to(
device
)
optimizer = torch.optim.AdamW(
model.parameters(), lr=config.learning_rate, weight_decay=config.weight_decay
1550→ )
generator = torch.Generator(device="cpu").manual_seed(config.seed + 10_000)
item_correction = build_item_correction(
prepared,
config,
partition.window_starts,
training_counts,
)
target_weights = build_target_weights(
public,
1560→ stage,
prepared,
partition.history_training_counts,
config,
)
known_positive_packed = (
build_known_positive_filter(prepared, partition.history_training_counts)
if config.negative_filter_scope == "full-training-history"
else None
)
1570→ history: list[dict[str, float]] = []
best_loss = float("inf")
best_epoch = 0
best_state: dict[str, torch.Tensor] | None = None
epochs_without_improvement = 0
start_epoch = 0
if resume_checkpoint is not None:
payload = torch.load(
resume_checkpoint, map_location=device, weights_only=False
1580→ )
stored_config = payload.get("config", {})
architecture_fields = (
"bptt_steps",
"embedding_dim",
"hidden_dim",
"user_hidden_1",
"user_hidden_2",
"item_hidden_1",
"item_hidden_2",
1590→ )
mismatches = {
name: (stored_config.get(name), getattr(config, name))
for name in architecture_fields
if stored_config.get(name) != getattr(config, name)
}
if mismatches:
raise RuntimeError(
f"resume checkpoint architecture differs: {mismatches}"
)
1600→ stored_filter_scope = stored_config.get(
"negative_filter_scope", "last-100"
)
stored_target_weighting = stored_config.get(
"target_weighting", "uniform"
)
stored_weight_values = (
stored_config.get("ordinary_target_weight", 1.0),
stored_config.get("organic_strong_target_weight", 1.0),
stored_config.get("organic_like_target_weight", 3.0),
1610→ stored_config.get("discovery_horizon_days", 7),
)
current_weight_values = (
config.ordinary_target_weight,
config.organic_strong_target_weight,
config.organic_like_target_weight,
config.discovery_horizon_days,
)
stored_window_values = (
stored_config.get("validation_fraction", 0.10),
1620→ stored_config.get("max_train_targets_per_user", 0),
stored_config.get("max_validation_targets_per_user", 0),
)
current_window_values = (
config.validation_fraction,
config.max_train_targets_per_user,
config.max_validation_targets_per_user,
)
objective_changed = (
stored_filter_scope != config.negative_filter_scope
1630→ or stored_target_weighting != config.target_weighting
or stored_weight_values != current_weight_values
or stored_window_values != current_window_values
)
model.load_state_dict(payload["model_state"])
if "optimizer_state" in payload and not objective_changed:
optimizer.load_state_dict(payload["optimizer_state"])
for group in optimizer.param_groups:
group["lr"] = config.learning_rate
group["weight_decay"] = config.weight_decay
1640→ log(f"restored optimizer state from {resume_checkpoint}")
else:
log(
f"using a fresh AdamW optimizer after loading {resume_checkpoint}"
)
if "generator_state" in payload and not objective_changed:
generator.set_state(payload["generator_state"])
start_epoch = int(payload["epoch"])
if start_epoch >= config.epochs:
raise RuntimeError(
1650→ f"resume epoch {start_epoch} must be below --epochs {config.epochs}"
)
prior = {
str(name): float(value)
for name, value in payload.get("diagnostics", {}).items()
}
if objective_changed:
prior.pop("validation_loss", None)
log(
"BCE objective changed: filter "
1660→ f"{stored_filter_scope}->{config.negative_filter_scope}, "
"target weighting "
f"{stored_target_weighting}->{config.target_weighting}, "
f"target window {stored_window_values}->{current_window_values}; "
"recomputing the resume checkpoint's validation BCE"
)
if "validation_loss" not in prior:
prior.update(
evaluate_validation_bce(
model,
1670→ prepared,
config,
target_weights,
partition.window_starts,
training_counts,
validation_counts,
item_correction,
known_positive_packed,
device,
)
1680→ )
history.append(prior)
best_loss = float(prior["validation_loss"])
best_epoch = start_epoch
best_state = snapshot_model(model)
log(
f"resumed validation-BCE training: epoch={start_epoch} "
f"loss={best_loss:.6f}"
)
1690→ for epoch in range(start_epoch + 1, config.epochs + 1):
diagnostics = run_training_epoch(
model,
optimizer,
prepared,
config,
target_weights,
partition.window_starts,
training_counts,
item_correction,
1700→ known_positive_packed,
generator,
device,
epoch,
)
validation = evaluate_validation_bce(
model,
prepared,
config,
target_weights,
1710→ partition.window_starts,
training_counts,
validation_counts,
item_correction,
known_positive_packed,
device,
)
diagnostics.update(validation)
history.append(diagnostics)
current_state = snapshot_model(model)
1720→ if checkpoint_dir is not None:
save_epoch_checkpoint(
checkpoint_dir,
epoch,
current_state,
config,
diagnostics,
optimizer,
generator,
)
1730→ improved = (
diagnostics["validation_loss"]
< best_loss - config.early_stopping_min_delta
)
if improved:
best_loss = diagnostics["validation_loss"]
best_epoch = epoch
best_state = current_state
epochs_without_improvement = 0
if checkpoint_dir is not None:
1740→ torch.save(
{
"epoch": epoch,
"config": asdict(config),
"diagnostics": diagnostics,
"model_state": current_state,
"optimizer_state": optimizer.state_dict(),
"generator_state": generator.get_state(),
},
checkpoint_dir / "best.pt",
1750→ )
else:
epochs_without_improvement += 1
log(
f"epoch={epoch}/{config.epochs} train_loss={diagnostics['loss']:.5f} "
f"validation_loss={diagnostics['validation_loss']:.5f} "
f"pair_accuracy={diagnostics['pair_accuracy']:.3f} "
f"train_targets={int(diagnostics['targets']):,} "
f"validation_targets={int(diagnostics['validation_targets']):,} "
f"train_seconds={diagnostics['seconds']:.1f} "
1760→ f"validation_seconds={diagnostics['validation_seconds']:.1f}"
)
release_accelerator_cache(device)
if epochs_without_improvement >= config.early_stopping_patience:
log(
f"early stopping after epoch={epoch}; "
f"best_epoch={best_epoch} best_validation_loss={best_loss:.6f}"
)
break
1770→ if best_state is None:
raise RuntimeError("training did not produce a valid checkpoint")
model.load_state_dict(best_state)
model.to(device).eval()
log(
f"restored best validation-BCE checkpoint: epoch={best_epoch} "
f"loss={best_loss:.6f}"
)
return model, history
1780→
@torch.inference_mode()
def inference_queries(
model: base.SequentialTwoTower,
prepared: SequenceData,
config: Config,
device: torch.device,
) -> torch.Tensor:
sequence_rows = prepared.inference_user_rows
lengths = np.where(
1790→ sequence_rows >= 0, prepared.lengths[np.maximum(sequence_rows, 0)], 0
)
ordered = np.argsort(lengths, kind="stable")
result = torch.zeros(
len(sequence_rows), config.embedding_dim, dtype=torch.float32
)
for group_start in range(0, len(ordered), config.user_batch_size):
output_rows = ordered[group_start : group_start + config.user_batch_size]
rows = sequence_rows[output_rows]
group_lengths = lengths[output_rows]
1800→ hidden = torch.zeros(
1, len(output_rows), config.embedding_dim, device=device
)
for start in range(0, int(group_lengths.max(initial=0)), config.bptt_steps):
steps = min(
config.bptt_steps,
int(group_lengths.max(initial=0)) - start,
)
items = np.full(
(len(output_rows), steps),
1810→ len(prepared.item_ids),
dtype=np.uint16,
)
features = np.zeros((len(output_rows), steps, 3), dtype=np.float16)
counts = np.zeros(len(output_rows), dtype=np.int32)
for local_row, sequence_row in enumerate(rows):
if sequence_row < 0:
continue
count = min(steps, max(int(group_lengths[local_row]) - start, 0))
if not count:
1820→ continue
offset = int(prepared.offsets[sequence_row])
selected = slice(offset + start, offset + start + count)
items[local_row, :count] = prepared.sequence_items[selected]
features[local_row, :count] = prepared.event_features[selected]
counts[local_row] = count
outputs, _ = event_sequence(
model,
torch.from_numpy(items.astype(np.int64)).to(device),
torch.from_numpy(features.astype(np.float32)).to(device),
1830→ hidden,
)
next_rows: list[torch.Tensor] = []
for local_row, count in enumerate(counts):
next_rows.append(
outputs[local_row, count - 1]
if count
else hidden[0, local_row]
)
hidden = torch.stack(next_rows).unsqueeze(0)
1840→
liked_items = torch.from_numpy(
prepared.inference_liked_items[output_rows].astype(np.int64)
).to(device)
disliked_items = torch.from_numpy(
prepared.inference_disliked_items[output_rows].astype(np.int64)
).to(device)
queries = user_queries(
model,
hidden.squeeze(0),
1850→ model._mean_context_channel(liked_items),
model._mean_context_channel(disliked_items),
torch.from_numpy(
prepared.inference_user_features[output_rows].astype(np.float32)
).to(device),
)
result[torch.from_numpy(output_rows.astype(np.int64))] = queries.cpu()
return result
1860→@torch.inference_mode()
def rank_candidates(
model: base.SequentialTwoTower,
prepared: SequenceData,
eligibility: CandidateSet,
config: Config,
device: torch.device,
ranking_batch_size: int,
) -> tuple[pd.DataFrame, dict[str, float]]:
model.eval()
1870→ queries = inference_queries(model, prepared, config, device)
item_parts: list[torch.Tensor] = []
for start in range(0, len(prepared.item_ids), 2_048):
rows = torch.arange(
start,
min(start + 2_048, len(prepared.item_ids)),
dtype=torch.long,
device=device,
)
item_parts.append(model.encode_items(rows).cpu())
1880→ items = torch.cat(item_parts)
rows: list[tuple[int, int, int]] = []
for start in range(0, len(eligibility.uids), ranking_batch_size):
end = min(start + ranking_batch_size, len(eligibility.uids))
scores = queries[start:end] @ items.T
eligible = np.unpackbits(
eligibility.packed[start:end],
axis=1,
count=len(prepared.item_ids),
bitorder="little",
1890→ ).astype(bool, copy=False)
scores.masked_fill_(~torch.from_numpy(eligible), -torch.inf)
selected = torch.topk(scores, k=base.TOP_N, dim=1).indices.numpy()
for local_row, columns in enumerate(selected):
uid = int(eligibility.uids[start + local_row])
rows.extend(
(uid, int(prepared.item_ids[column]), rank)
for rank, column in enumerate(columns, start=1)
)
if end == len(eligibility.uids) or end % 1_024 == 0:
1900→ log(f"ranked users={end:,}/{len(eligibility.uids):,}")
query_norm = torch.linalg.vector_norm(queries, dim=1).numpy()
item_norm = torch.linalg.vector_norm(items, dim=1).numpy()
diagnostics = {
"query_norm_mean": float(query_norm.mean()),
"query_norm_std": float(query_norm.std()),
"item_norm_mean": float(item_norm.mean()),
"item_norm_std": float(item_norm.std()),
}
return pd.DataFrame(rows, columns=["uid", "item_id", "rank"]), diagnostics
1910→
def write_ranking(frame: pd.DataFrame, output: Path) -> None:
output.parent.mkdir(parents=True, exist_ok=True)
if output.suffix == ".parquet":
frame.to_parquet(output, index=False, compression="zstd")
elif output.suffix == ".csv":
frame.to_csv(output, index=False)
else:
raise ValueError("--output must end in .parquet or .csv")
1920→
def main() -> int:
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument(
"--stage", choices=("validation", "submission"), default="validation"
)
parser.add_argument("--output", type=Path, required=True)
parser.add_argument("--public-dir", type=Path, required=True)
parser.add_argument("--prepared-cache", type=Path)
1930→ parser.add_argument("--device", choices=("cpu", "mps"), default="cpu")
parser.add_argument("--threads", type=int, default=8)
parser.add_argument("--bptt-steps", type=int, default=Config.bptt_steps)
parser.add_argument(
"--user-batch-size", type=int, default=Config.user_batch_size
)
parser.add_argument("--epochs", type=int, default=Config.epochs)
parser.add_argument("--learning-rate", type=float, default=Config.learning_rate)
parser.add_argument(
"--loss-microbatch-size",
1940→ type=int,
default=Config.loss_microbatch_size,
)
parser.add_argument(
"--negative-filter-scope",
choices=("full-training-history", "last-100"),
default=Config.negative_filter_scope,
)
parser.add_argument(
"--target-weighting",
1950→ choices=("discovery-graded", "organic-strong", "uniform"),
default=Config.target_weighting,
)
parser.add_argument(
"--ordinary-target-weight",
type=float,
default=Config.ordinary_target_weight,
)
parser.add_argument(
"--organic-strong-target-weight",
1960→ type=float,
default=Config.organic_strong_target_weight,
)
parser.add_argument(
"--organic-like-target-weight",
type=float,
default=Config.organic_like_target_weight,
)
parser.add_argument(
"--discovery-horizon-days",
1970→ type=int,
default=Config.discovery_horizon_days,
)
parser.add_argument(
"--validation-fraction",
type=float,
default=Config.validation_fraction,
)
parser.add_argument(
"--max-train-targets-per-user",
1980→ type=int,
default=Config.max_train_targets_per_user,
help="retain this many recent pre-validation targets per user; 0 is uncapped",
)
parser.add_argument(
"--max-validation-targets-per-user",
type=int,
default=Config.max_validation_targets_per_user,
help="retain this many final validation targets per user; 0 is uncapped",
)
1990→ parser.add_argument(
"--early-stopping-patience",
type=int,
default=Config.early_stopping_patience,
)
parser.add_argument(
"--early-stopping-min-delta",
type=float,
default=Config.early_stopping_min_delta,
)