Skip to content

Commit 0bcd89d

Browse files
bcui19hanlintdblalock
committed
Changing 'stable' to 'latest' in notebooks in examples (mosaicml#1534)
* Fixed references * Fixing typo Co-authored-by: dblalock <[email protected]> Co-authored-by: Hanlin Tang <[email protected]> Co-authored-by: dblalock <[email protected]>
1 parent e19a56a commit 0bcd89d

File tree

4 files changed

+28
-28
lines changed

4 files changed

+28
-28
lines changed

examples/early_stopping.ipynb

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,8 +32,8 @@
3232
"\n",
3333
"Let's get started!\n",
3434
"\n",
35-
"[earlystopper]: https://docs.mosaicml.com/en/stable/api_reference/composer.callbacks.early_stopper.html#composer.callbacks.early_stopper.EarlyStopper\n",
36-
"[thresholdstopper]: https://docs.mosaicml.com/en/stable/api_reference/composer.callbacks.threshold_stopper.html#composer.callbacks.threshold_stopper.ThresholdStopper\n",
35+
"[earlystopper]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.callbacks.EarlyStopper.html\n",
36+
"[thresholdstopper]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.callbacks.ThresholdStopper.html\n",
3737
"[getting_started]: https://docs.mosaicml.com/en/stable/examples/getting_started.html\n",
3838
"[welcome_tour]: https://docs.mosaicml.com/en/stable/getting_started/welcome_tour.html"
3939
]
@@ -134,7 +134,7 @@
134134
"\n",
135135
"Finally, set up the model, optimizer, scheduler, and an [evaluator][evaluator].\n",
136136
"\n",
137-
"[evaluator]: https://docs.mosaicml.com/en/stable/api_reference/composer.core.evaluator.html#composer.core.evaluator.Evaluator"
137+
"[evaluator]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Evaluator.html#evaluator"
138138
]
139139
},
140140
{
@@ -194,10 +194,10 @@
194194
"\n",
195195
"See the [API Reference][api] for more information.\n",
196196
"\n",
197-
"[evaluator]: https://docs.mosaicml.com/en/stable/api_reference/composer.core.evaluator.html#composer.core.evaluator.Evaluator\n",
198-
"[trainer]: https://docs.mosaicml.com/en/stable/api_reference/composer.trainer.trainer.html#composer.trainer.trainer.Trainer\n",
199-
"[time]: https://docs.mosaicml.com/en/stable/trainer/time.html\n",
200-
"[api]: https://docs.mosaicml.com/en/stable/api_reference/composer.callbacks.early_stopper.html#composer.callbacks.early_stopper.EarlyStopper\n",
197+
"[evaluator]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Evaluator.html#evaluator\n",
198+
"[trainer]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Trainer.html#trainer\n",
199+
"[time]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Time.html#time\n",
200+
"[api]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.callbacks.EarlyStopper.html\n",
201201
"\n",
202202
"Here, we'll use our callback to track the Accuracy metric over one epoch on the test dataset:"
203203
]
@@ -266,7 +266,7 @@
266266
"- `threshold`: The float threshold that dictates when to halt training.\n",
267267
"- `stop_on_batch`: If `True`, training can halt in the middle of an epoch, rather than just add the end.\n",
268268
"\n",
269-
"[thresholdstopper]: https://docs.mosaicml.com/en/stable/api_reference/composer.callbacks.threshold_stopper.html#composer.callbacks.threshold_stopper.ThresholdStopper"
269+
"[thresholdstopper]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.callbacks.ThresholdStopper.html"
270270
]
271271
},
272272
{

examples/getting_started.ipynb

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@
3838
"\n",
3939
"[welcome_tour]: https://docs.mosaicml.com/en/stable/getting_started/welcome_tour.html\n",
4040
"[pytorch_basics]: https://pytorch.org/tutorials/beginner/basics/intro.html\n",
41-
"[trainer]: https://docs.mosaicml.com/en/stable/api_reference/composer.trainer.trainer.html#composer.trainer.trainer.Trainer"
41+
"[trainer]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Trainer.html#trainer"
4242
]
4343
},
4444
{
@@ -156,7 +156,7 @@
156156
"**Note**: The model below is an instance of a [ComposerModel][composer_model]. Models need to be wrapped in this class, which provides a convenient interface between the underlying PyTorch model and the Trainer.\n",
157157
"\n",
158158
"[custom_models_tutorial]: https://docs.mosaicml.com/en/stable/tutorials/adding_models_datasets.html#models\n",
159-
"[composer_model]: https://docs.mosaicml.com/en/stable/api_reference/composer.models.base.html#composer.models.base.ComposerModel"
159+
"[composer_model]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.ComposerModel.html#composer.ComposerModel"
160160
]
161161
},
162162
{
@@ -228,7 +228,7 @@
228228
"\n",
229229
"Finally, we instantiate an [InMemoryLogger][in_memory_logger] that records all the data from the Composer Trainer. We will use this logger to generate data plots after we complete training.\n",
230230
"\n",
231-
"[in_memory_logger]: https://docs.mosaicml.com/en/stable/api_reference/composer.loggers.in_memory_logger.html"
231+
"[in_memory_logger]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.loggers.InMemoryLogger.html"
232232
]
233233
},
234234
{
@@ -272,7 +272,7 @@
272272
"\n",
273273
"\n",
274274
"[trainer_docs]: https://docs.mosaicml.com/en/stable/trainer/using_the_trainer.html\n",
275-
"[api]: https://docs.mosaicml.com/en/stable/api_reference/composer.trainer.trainer.html#composer.trainer.trainer.Trainer\n",
275+
"[api]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Trainer.html#trainer\n",
276276
"[composer_model]: https://docs.mosaicml.com/en/stable/composer_model.html\n",
277277
"[dataloaders]: https://docs.mosaicml.com/en/stable/trainer/dataloaders.html\n",
278278
"[time]: https://docs.mosaicml.com/en/stable/trainer/time.html\n",

examples/huggingface_models.ipynb

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -158,7 +158,7 @@
158158
"\n",
159159
"See the [API Reference][api] for additional details.\n",
160160
"\n",
161-
"[api]: https://docs.mosaicml.com/en/stable/api_reference/composer.models.huggingface.html#composer.models.huggingface.HuggingFaceModel"
161+
"[api]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.models.HuggingFaceModel.html"
162162
]
163163
},
164164
{
@@ -222,7 +222,7 @@
222222
"cell_type": "markdown",
223223
"metadata": {},
224224
"source": [
225-
"We will now specify a Composer `Trainer` object and run our training! `Trainer` has many arguments that are described in our [documentation](https://docs.mosaicml.com/en/stable/api_reference/composer.trainer.trainer.html), so we'll discuss only the less-obvious arguments used below:\n",
225+
"We will now specify a Composer `Trainer` object and run our training! `Trainer` has many arguments that are described in our [documentation](https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Trainer.html#trainer), so we'll discuss only the less-obvious arguments used below:\n",
226226
"\n",
227227
"- `max_duration` - a string specifying how long to train. This can be in terms of batches (e.g., `'10ba'` is 10 batches) or epochs (e.g., `'1ep'` is 1 epoch), [among other options][time].\n",
228228
"- `schedulers` - a (list of) PyTorch or Composer learning rate scheduler(s) that will be composed together.\n",

examples/training_without_local_storage.ipynb

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -249,17 +249,17 @@
249249
"\n",
250250
"* [Logger][Logger]: Composer includes a centralized logger, which passes logged data to each `LoggerDestination` (more on that below). Logged data can be either metrics or artifacts. The logger is similar to Python's built-in `logging.getLogger(...)` but is designed to log structured metrics and artifacts in addition to just text.\n",
251251
"\n",
252-
"[Logger]: https://docs.mosaicml.com/en/stable/api_reference/composer.loggers.logger.html#composer.loggers.logger.Logger\n",
252+
"[Logger]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Logger.html#logger\n",
253253
"\n",
254254
"* [LoggerDestination][LoggerDestination]: Where logs are sent is specified via the `loggers` argument of the [Trainer constructor][trainer]. The centralized `Logger` (above) passes all metrics and artifacts to each `LoggerDestination`, which is responsible for handling and storing the data. For example, Composer includes `LoggerDestination`s for logging to [files][FileLogger], [TensorBoard][TensorboardLogger], [Weights & Biases][wandb], and [Object Stores][ObjectStoreLogger] like S3. Not all `LoggerDestination`s support storing all types of data; for example, the [ObjectStoreLogger][ObjectStoreLogger] only supports logging artifacts, whereas the [FileLogger][FileLogger] only supports logging files. Others, such as the [WandBLogger][wandb], support both.\n",
255255
"\n",
256-
"[LoggerDestination]: https://docs.mosaicml.com/en/stable/api_reference/composer.loggers.logger_destination.html#composer.loggers.logger_destination.LoggerDestination\n",
257-
"[trainer]: https://docs.mosaicml.com/en/stable/api_reference/composer.trainer.trainer.html#composer.trainer.trainer.Trainer\n",
258-
"[FileLogger]: https://docs.mosaicml.com/en/stable/api_reference/composer.loggers.file_logger.html#composer.loggers.file_logger.FileLogger\n",
259-
"[TensorboardLogger]: https://docs.mosaicml.com/en/stable/api_reference/composer.loggers.tensorboard_logger.html#composer.loggers.tensorboard_logger.TensorboardLogger\n",
260-
"[wandb]: https://docs.mosaicml.com/en/stable/api_reference/composer.loggers.wandb_logger.html#composer.loggers.wandb_logger.WandBLogger\n",
261-
"[ObjectStoreLogger]: https://docs.mosaicml.com/en/stable/api_reference/composer.loggers.object_store_logger.html#composer.loggers.object_store_logger.ObjectStoreLogger\n",
262-
"[FileLogger]: https://docs.mosaicml.com/en/stable/api_reference/composer.loggers.file_logger.html#composer.loggers.file_logger.FileLogger\n",
256+
"[LoggerDestination]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.loggers.LoggerDestination.html\n",
257+
"[trainer]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Trainer.html#trainer\n",
258+
"[FileLogger]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.loggers.FileLogger.html\n",
259+
"[TensorboardLogger]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.loggers.TensorboardLogger.html#tensorboardlogger\n",
260+
"[wandb]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.loggers.WandBLogger.html\n",
261+
"[ObjectStoreLogger]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.loggers.ObjectStoreLogger.html#objectstorelogger\n",
262+
"[FileLogger]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.loggers.FileLogger.html#filelogger\n",
263263
"\n",
264264
"* Metrics: A metric is a scalar, such as accuracy, that can be logged. Usually you would want to plot metrics over time (e.g., to see how accuracy improves over batches).\n",
265265
"\n",
@@ -268,15 +268,15 @@
268268
"* [ObjectStore][ObjectStore]: The abstract `ObjectStore` class provides an API for uploading and downloading checkpoints. Composer includes object store implementations for [S3][S3], [SFTP][SFTP], and [Libcloud][Libcloud]. You can also write your own implementation by extending the [base class][ObjectStore] if you are using a custom backend.\n",
269269
"\n",
270270
"[Artifacts]: https://docs.mosaicml.com/en/stable/trainer/artifact_logging.html\n",
271-
"[ObjectStore]: https://docs.mosaicml.com/en/stable/api_reference/composer.utils.object_store.object_store.html#composer.utils.object_store.object_store.ObjectStore\n",
272-
"[S3]: https://docs.mosaicml.com/en/stable/api_reference/composer.utils.object_store.s3_object_store.html#composer.utils.object_store.s3_object_store.S3ObjectStore\n",
273-
"[SFTP]: https://docs.mosaicml.com/en/stable/api_reference/composer.utils.object_store.sftp_object_store.html#composer.utils.object_store.sftp_object_store.SFTPObjectStore\n",
274-
"[Libcloud]: https://docs.mosaicml.com/en/stable/api_reference/composer.utils.object_store.libcloud_object_store.html#composer.utils.object_store.libcloud_object_store.LibcloudObjectStore\n",
271+
"[ObjectStore]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.utils.ObjectStore.html\n",
272+
"[S3]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.utils.S3ObjectStore.html\n",
273+
"[SFTP]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.utils.SFTPObjectStore.html\n",
274+
"[Libcloud]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.utils.LibcloudObjectStore.html\n",
275275
"\n",
276276
"We'll use these components together to back up our checkpoints and TensorBoard TF Event files to the cloud. Internally, the [CheckpointSaver][CheckpointSaver] callback and [TensorboardLogger][TensorboardLogger] pass all generated files to the [Logger][Logger] as artifacts by calling [Logger.file_artifact][Logger_file_artifact]. The Logger then passes these files to each [LoggerDestination][LoggerDestination] (specified via the `loggers` argument of the [Trainer constructor][trainer]). A `LoggerDestination`, which can implement the `log_file_artifact` method, is responsible for uploading the file to the cloud.\n",
277277
"\n",
278-
"[CheckpointSaver]: https://docs.mosaicml.com/en/stable/api_reference/composer.callbacks.checkpoint_saver.html#composer.callbacks.checkpoint_saver.CheckpointSaver\n",
279-
"[Logger_file_artifact]: https://docs.mosaicml.com/en/stable/api_reference/composer.loggers.logger.html#composer.loggers.logger.Logger.file_artifact\n",
278+
"[CheckpointSaver]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.callbacks.CheckpointSaver.html#checkpointsaver\n",
279+
"[Logger_file_artifact]: https://docs.mosaicml.com/en/stable/api_reference/generated/composer.Logger.html#composer.Logger.file_artifact\n",
280280
"\n",
281281
"\n",
282282
"Here, our \"cloud\" will be an S3 bucket. To upload checkpoints and TensorBoard TF Event files to the bucket, we'll add the [ObjectStoreLogger][ObjectStoreLogger] with the [S3ObjectStore][S3] backend to our list of logger destinations. This class asynchronously uploads artifacts to an object store without blocking the training loop."

0 commit comments

Comments
 (0)