Skip to content

Add a command reference - #936

Open
caglarpir wants to merge 3 commits into
mapillary:mainfrom
caglarpir:docs-command-reference
Open

caglarpir wants to merge 3 commits into
mapillary:mainfrom
caglarpir:docs-command-reference

Conversation

@caglarpir

Copy link
Copy Markdown
Contributor

Adds docs/command_reference.md: what each command does, its options and defaults, examples, and the gotchas that users run into, with the exit codes and the environment variables. It describes main, plus the GPX reading of #935 (only track points with a time that can be read; routes and waypoints are not read), which ships in the same release.

The examples were run against main (uploads with --dry_run).

docs/command_reference.md: what each command does, its options and
defaults, examples, and the gotchas that users run into, with the exit
codes and the environment variables. It describes main, and the GPX
reading of mapillary#935, which ships in the same release.
upload skips what it uploaded before by the checksum of a whole image
sequence, video or zip file: a sequence with one image added is
uploaded again, and a video is recognized by its file alone.
check_upload_history reports zip files too, and looks images up one by
one.
- Only native rejects EXIF GPS minutes or seconds above 60: with
  ExifTool installed, the exiftool_runtime fallback geotags the image at
  a wrong position.
- One image that fails to upload fails its sequence; exit code 17 also
  stops the upload.
- Interval sampling reads the creation time only with --geotag_source
  gpx; with --video_geotag_source gpx it refuses a long track, as
  distance sampling does, and the error prints the track start only for
  a track shorter than a day.
- processed_file_count counts files by extension before processing,
  including those that --filetypes leaves out.
- In sample_video, --video_start_time only sets the capture times.
- The config is a file in ~/.config/mapillary/configs/, and
  MAPILLARY_CONFIG_PATH must name a file.
- Smaller: which errors move on to the next source, when gpx without a
  path stops the command, error entries are not schema-checked, the
  other image extensions, --dryrun.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant