Skip to content

Commit

Permalink
v3.0 edits apply feedback (#3777)
Browse files Browse the repository at this point in the history
  • Loading branch information
sguequierre authored Jan 6, 2025
1 parent 2ba4755 commit c7248b2
Show file tree
Hide file tree
Showing 5 changed files with 35 additions and 31 deletions.
6 changes: 4 additions & 2 deletions docs/data-ai/ai/act.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,10 @@ next: "/data-ai/ai/advanced/upload-external-data/"

You can use the [vision service API](/dev/reference/apis/services/vision/) to get information about your machine's inferences and program behavior based on that.

The following are just a few examples of what you can do with the vision service and other components and services.
Program a line following robot or act in industrial applications like accident prevention or quality assurance.
The following are examples of what you can do using a vision service alongside hardware:

- [Line following robot](#program-a-line-following-robot): Using computer vision to follow objects or a pre-determined path
- [Accident prevention and quality assurance](#act-in-industrial-applications)

## Program a line following robot

Expand Down
8 changes: 6 additions & 2 deletions docs/data-ai/ai/advanced/upload-external-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,12 @@ description: "Upload data to the Viam app from your local computer or mobile dev
prev: "/data-ai/ai/act/"
---

When you configure the data management service, Viam automatically uploads data from the default directory `~/.viam/capture` or the directory you configured to the cloud at the interval you specify.
If you want to upload a batch of data from a different source—such as another directory on your machine, your personal computer, or a mobile device—you can use the Viam app, the data client API, or the Viam mobile app to do so.
When you configure the data management service, Viam automatically uploads data from the default directory `~/.viam/capture` and any directory you configured.
If you want to upload a batch of data to train ML models on from an external source you can also:

- [Sync a batch of data from another directory](#sync-a-batch-of-data-from-another-directory)
- [Upload data with Python](#upload-data-with-python)
- [Upload images from your phone with the Viam mobile app](#upload-images-with-the-viam-mobile-app)

## Sync a batch of data from another directory

Expand Down
6 changes: 2 additions & 4 deletions docs/data-ai/ai/create-dataset.md
Original file line number Diff line number Diff line change
Expand Up @@ -167,7 +167,7 @@ The more varied the provided dataset, the more accurate the resulting model beco

{{< /expand >}}

{{< expand "For tips and tricks on improving model accuracy while capturing data, click here." >}}
## Tips on improving model accuracy

- **More data means better models:** Incorporate as much data as you practically can to improve your model’s overall performance.
- **Include counterexamples:** Include images with and without the object you’re looking to classify.
Expand All @@ -179,9 +179,7 @@ The more varied the provided dataset, the more accurate the resulting model beco
For example, if you plan to use a low-quality camera in production, train with low-quality images.
Similarly, if your model will run all day, capture images in both daylight and nighttime conditions.
- **Vary your angles and distances:** Include image examples from every angle and distance that the model will see in normal use.
- **Ensure labelling accuracy:** Make sure the labels or bounding box annotations you give are accurate.

{{< /expand >}}
- **Ensure labeling accuracy:** Make sure the labels or bounding box annotations you give are accurate.

## Label your images

Expand Down
23 changes: 0 additions & 23 deletions docs/data-ai/capture-data/advanced/how-sync-works.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,28 +74,5 @@ If your machine's disk fills up beyond a certain threshold, the data management

{{< /alert >}}

{{< expand "Automatic data deletion details" >}}

If cloud sync is enabled, the data management service deletes captured data once it has successfully synced to the cloud.

With `viam-server`, the data management service will also automatically delete local data in the event your machine's local storage fills up.
Local data is automatically deleted when _all_ of the following conditions are met:

- Data capture is enabled on the data management service
- Local disk usage percentage is greater than or equal to 90%
- The Viam capture directory is at least 50% of the current local disk usage

If local disk usage is greater than or equal to 90%, but the Viam capture directory is not at least 50% of that usage, a warning log message will be emitted instead and no action will be taken.

Automatic file deletion only applies to files in the specified Viam capture directory, which is set to `~/.viam/capture` by default.
Data outside of this directory is not touched by automatic data deletion.

If your machine captures a large amount of data, or frequently goes offline for long periods of time while capturing data, consider moving the Viam capture directory to a larger, dedicated storage device on your machine if available.
You can change the capture directory using the `capture_dir` attribute.

You can also control how local data is deleted if your machine's local storage becomes full, using the `delete_every_nth_when_disk_full` attribute.

{{< /expand >}}

Data capture supports capturing tabular data directly to MongoDB in addition to capturing to disk.
For more information, see [Capture directly to MongoDB](/data-ai/reference/data/#capture-directly-to-mongodb).
23 changes: 23 additions & 0 deletions docs/data-ai/capture-data/capture-sync.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,29 @@ Click the **Save** button in the top right corner of the page to save your confi

For more advanced attribute configuration information, see [Resource data capture configuration](/data-ai/reference/data/#resource-data-capture-configuration).

{{< expand "Automatic data deletion details" >}}

If cloud sync is enabled, the data management service deletes captured data once it has successfully synced to the cloud.

With `viam-server`, the data management service will also automatically delete local data in the event your machine's local storage fills up.
Local data is automatically deleted when _all_ of the following conditions are met:

- Data capture is enabled on the data management service
- Local disk usage percentage is greater than or equal to 90%
- The Viam capture directory is at least 50% of the current local disk usage

If local disk usage is greater than or equal to 90%, but the Viam capture directory is not at least 50% of that usage, a warning log message will be emitted instead and no action will be taken.

Automatic file deletion only applies to files in the specified Viam capture directory, which is set to `~/.viam/capture` by default.
Data outside of this directory is not touched by automatic data deletion.

If your machine captures a large amount of data, or frequently goes offline for long periods of time while capturing data, consider moving the Viam capture directory to a larger, dedicated storage device on your machine if available.
You can change the capture directory using the `capture_dir` attribute.

You can also control how local data is deleted if your machine's local storage becomes full, using the `delete_every_nth_when_disk_full` attribute.

{{< /expand >}}

## Stop data capture

If this is a test project, make sure you stop data capture to avoid charges for a large amount of unwanted data.
Expand Down

0 comments on commit c7248b2

Please sign in to comment.