{"record":{"id":"e8f6e8148e1167fc","repo":"microsoft/qlib","slug":"optimizer-is-not-supported-e8f6e8","errorCode":null,"errorMessage":"optimizer {} is not supported!","messagePattern":"optimizer (.+?) is not supported!","errorType":"exception","errorClass":"NotImplementedError","httpStatus":null,"severity":"error","filePath":"qlib/contrib/model/pytorch_localformer.py","lineNumber":76,"sourceCode":"        self.optimizer = optimizer.lower()\r\n        self.loss = loss\r\n        self.n_jobs = n_jobs\r\n        self.device = torch.device(\"cuda:%d\" % GPU if torch.cuda.is_available() and GPU >= 0 else \"cpu\")\r\n        self.seed = seed\r\n        self.logger = get_module_logger(\"TransformerModel\")\r\n        self.logger.info(\"Naive Transformer:\" \"\\nbatch_size : {}\" \"\\ndevice : {}\".format(self.batch_size, self.device))\r\n\r\n        if self.seed is not None:\r\n            np.random.seed(self.seed)\r\n            torch.manual_seed(self.seed)\r\n\r\n        self.model = Transformer(d_feat, d_model, nhead, num_layers, dropout, self.device)\r\n        if optimizer.lower() == \"adam\":\r\n            self.train_optimizer = optim.Adam(self.model.parameters(), lr=self.lr, weight_decay=self.reg)\r\n        elif optimizer.lower() == \"gd\":\r\n            self.train_optimizer = optim.SGD(self.model.parameters(), lr=self.lr, weight_decay=self.reg)\r\n        else:\r\n            raise NotImplementedError(\"optimizer {} is not supported!\".format(optimizer))\r\n\r\n        self.fitted = False\r\n        self.model.to(self.device)\r\n\r\n    @property\r\n    def use_gpu(self):\r\n        return self.device != torch.device(\"cpu\")\r\n\r\n    def mse(self, pred, label):\r\n        loss = (pred.float() - label.float()) ** 2\r\n        return torch.mean(loss)\r\n\r\n    def loss_fn(self, pred, label):\r\n        mask = ~torch.isnan(label)\r\n\r\n        if self.loss == \"mse\":\r\n            return self.mse(pred[mask], label[mask])\r\n\r","sourceCodeStart":58,"sourceCodeEnd":94,"githubUrl":"https://github.com/microsoft/qlib/blob/79633dd9506ea689e5400dea0197717b5b3d74b7/qlib/contrib/model/pytorch_localformer.py#L58-L94","documentation":"LocalTransformerModel supports only 'adam' (optim.Adam with weight_decay=self.reg) and 'gd' (optim.SGD with the same reg), case-insensitive. Any other optimizer string raises NotImplementedError in __init__, so the model object is never fully constructed.","triggerScenarios":"LocalTransformerModel(optimizer='adamw'|'rmsprop'|anything else); construction fails before fit is ever called.","commonSituations":"Hyperparameter search spaces that enumerate optimizer names from other libraries; typos; configs ported from models with broader optimizer support.","solutions":["Use optimizer='adam' or optimizer='gd'","Subclass to register additional optimizers if needed"],"exampleFix":"# before\nLocalTransformerModel(optimizer=\"adamw\")\n\n# after\nLocalTransformerModel(optimizer=\"adam\")","handlingStrategy":"validation","validationCode":"assert optimizer.lower() in (\"adam\", \"gd\"), f\"unsupported optimizer {optimizer!r}\"","typeGuard":"def is_supported_optimizer(name: str) -> bool:\n    return name.lower() in (\"adam\", \"gd\")","tryCatchPattern":null,"preventionTips":["Use only adam/gd in LocalTransformerModel configs","Centralize optimizer validation for all qlib torch models"],"tags":["qlib","localformer","optimizer","invalid-argument"],"backgroundTag":null,"analyzedSha":"79633dd9506ea689e5400dea0197717b5b3d74b7","analyzedAt":"2026-08-15T07:01:27.511Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}