Skip to content

Commit 17daea7

Browse files
authored
Standardised references to config_path (#905)
1 parent 326e6f7 commit 17daea7

1 file changed

Lines changed: 6 additions & 6 deletions

File tree

docs/UseOverviewGuide.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -265,11 +265,11 @@ deeplabcut.create_training_model_comparison(config_path, num_shuffles=1, net_typ
265265
For mutli-animal training we use batch processing. This means that we'd like the data to be similarly sized. You can of course have differing size of images you label (and we suggest cropping out useless pixels!). So, we have a new function that can pre-process your data to be compatible with batch training. Please run this function before you `create_multianmialtraining_dataset`:
266266

267267
```python
268-
deeplabcut.cropimagesandlabels(path_config_file)
268+
deeplabcut.cropimagesandlabels(config_path)
269269
```
270270
Then run:
271271
```python
272-
deeplabcut.create_multianimaltraining_dataset(path_config_file, allow_growth=True)
272+
deeplabcut.create_multianimaltraining_dataset(config_path, allow_growth=True)
273273
```
274274
(more details [here](functionDetails.md#f-create-training-datasets))
275275

@@ -304,7 +304,7 @@ We highly suggest that you read the docstring for this function to edit inputs a
304304

305305
You can also plot the scoremaps, locref layers, and PAFs:
306306
```python
307-
deeplabcut.extract_save_all_maps(path_config_file, shuffle=shuffle, Indices=[0, 5])
307+
deeplabcut.extract_save_all_maps(config_path, shuffle=shuffle, Indices=[0, 5])
308308
```
309309
- you can drop "Indices" to run this on all training/testing images (this is slow!)
310310

@@ -319,7 +319,7 @@ deeplabcut.analyze_videos(config_path,['/fullpath/project/videos/'], videotype='
319319
**maDeepLabCut**: there is a new step that allows you to plot *all* detections first. This allows you to check the pose-estimation quality before tracking of individuals! We recommend doing this step when you are running quality checks on new videos, etc. Once you have optimized pose-estimation and tracking, this is not required. `scorername` can be gotten from `scorername = deeplabcut.analyze_videos (...)` or just looking at the name of the DLC scorer in the folder name, h5 file, etc.
320320

321321
```python
322-
deeplabcut.create_video_with_all_detections(path_config_file, ['videofile_path'], scorername)
322+
deeplabcut.create_video_with_all_detections(config_path, ['videofile_path'], scorername)
323323
```
324324

325325
### Assemble & Refine Tracklets in maDeepLabCut:
@@ -330,15 +330,15 @@ deeplabcut.create_video_with_all_detections(path_config_file, ['videofile_path']
330330
First, you need to convert detections to tracklets. This step has several tracker types (`track_method`), and we recommend testing which one works best on your data.
331331

332332
```python
333-
deeplabcut.convert_detections2tracklets(path_config_file, ['videofile_path'], videotype='mp4',
333+
deeplabcut.convert_detections2tracklets(config_path, ['videofile_path'], videotype='mp4',
334334
shuffle=1, trainingsetindex=0, track_method='')
335335
```
336336
You should **cross-validate** the tracking parameters. ([Here is more information](functionDetails.md#cross-validation-of-inference-parameters-a-madeeplabcut-critical-point)). Namely, you can iteratively change the parameters, run `convert_detections2tracklets` then load them in the GUI (`refine_tracklets`). Note, that in the main Project Manager GUI there is a button for you to launch the inference file to seemlessly edit and rapidly test.
337337

338338
Secondly, you need to **refine the tracklets**. You can fix both "major" ID swaps, i.e. perhaps when animals cross, and you can micro-refine the individual body points. You will load the `...trackertype.pickle` file that was created above, and then you can launch a GUI to interactively refine the data. This also has several options, so please check out the docstring. Upon saving the refined tracks you get an `.h5` file (akin to what you might be used to from standard DLC. You can also load (1) filter this to take care of small jitters, and (2) load this `.h5` this to refine (again) in case you find another issue, etc!
339339

340340
```python
341-
deeplabcut.refine_tracklets(path_config_file, pickle_or_h5_file, videofile_path, min_swap_len=2, min_tracklet_len=2, trail_len=50)
341+
deeplabcut.refine_tracklets(config_path, pickle_or_h5_file, videofile_path, min_swap_len=2, min_tracklet_len=2, trail_len=50)
342342
```
343343
[Read more here!](functionDetails.md#madeeplabcut-critical-point---assemble--refine-tracklets)
344344

0 commit comments

Comments
 (0)