1ANALYZE-PV-STRUCTURE(1) General Commands Manual ANALYZE-PV-STRUCTURE(1)
2
6 analyze-pv-structure - Analyzes the location of metadata in a variety
7 of RAW, jpeg and video files
8
10 analyze-pv-structure [options] source [outfile]
11 Positional Options:
13 source
14 outfile
15 Options:
17 -h, --help
18 --clear, -c
19 --keep-names, -k
20 --no-dng, -d
21 --video
22 --only-video
23 --include-jpeg, -j
24 --only-jpeg, -J
25 --show-errors, -e
26 --load, -l
27 --verbose, -v
28
30 Analyze PV Structure analyzes photos and videos to help determine how
31 much of a file needs to be read to extract its metadata, embedded
32 thumbnail or render a thumbnail. It is associated with Rapid Photo
33 Downloader.
34 It uses exiv2 to extract photo metadata,and ExifTool to extract video
36 metadata.
37 To work, this program requires that the scanned photos and videos not
39 be in the Linux kernel's disk cache. To ensure this, the program
40 provides option, specified by the command line argument '--clear', to
41 instruct the kernel to sync and then drop clean caches, as well as
42 reclaimable slab objects like dentries and inodes. This is a non-
43 destructive operation and will not free any dirty objects. See
44 https://www.kernel.org/doc/Documentation/sysctl/vm.txt
45 Specify an outfile if you want to share the analysis of your files with
47 others.
48
50 To run this program, you need to install vmtouch. Get it at
51 http://hoytech.com/vmtouch/
52 To see an optional but helpful progress bar, install pyprind:
54 https://github.com/rasbt/pyprind
55
57 -h, --help
58 Show help message and exit.
59 source
61 Directory in which to recursively scan for photos and videos, or a
62 previously saved outfile.
63 outfile
65 Optional file in which to save the analysis.
66 --clear, -c
68 Clear the sync and drop clean caches (see note above). The script
69 will prompt for super user permission to execute this.
70 -v, --verbose
72 Displays program information on the command line as the program
73 runs.
74 -l, --load
76 Don't scan. Instead use previously generated outfile as input.
77 -k, --keep-names
79 If saving the analysis to file, don't first remove the file names
80 and paths from the analysis. Don't specify this option if you want
81 to keep this information private when sharing the analysis with
82 others.
83 -d, --no-dng
85 Don't scan DNG files.
86 --video
88 Scan videos.
89 --only-video
91 Scan only videos, ignoring photos.
92 -j, --include-jpeg
94 Scan jpeg images.
95 -J, --only-jpeg
97 Scan only jpeg images.
98 -e, --show-errors
100 Don't show progress bar while scanning, and instead show all errors
101 output by exiv2 (useful if exiv2 crashes, which takes down this
102 script too).
103
105 sudo analyze-pv-structure -c /home/user/Pictures/ pv_analysis
106 Analyze photos found in the user's Pictures folder, clear the
108 system caches prior to analysis, and save the analysis in the file
109 pv_analysis without any filename or path information.
110 analyze-pv-structure -v pv_analysis
112 Output verbose analysis of the previously saved outfile
114 pv_analysis.
115 analyze-pv-structure --video /home/user/Videos/
117 Analyze videos (and any photos) found in the user's Videos folder.
119
121 rapid-photo-downloader(1)
122
124 Analyze PV Structure was written by Damon Lynch <damonlynch@gmail.com>.
125 This manual page was written by Damon Lynch.
127
129 This program is free software; you can redistribute it and/or modify it
130 under the terms of the GNU General Public License as published by the
131 Free Software Foundation; either version 3, or (at your option) any
132 later version.
133 On Debian GNU/Linux systems, the complete text of the GNU General
135 Public License can be found in `/usr/share/common-licenses/GPL'.
1360.9.13 2018-11-06 ANALYZE-PV-STRUCTURE(1)