.TH "OSMIUM" "1" "1.5.1" "" ""
.SH NAME
.PP
osmium \- multipurpose tool for working with OpenStreetMap data
.SH SYNOPSIS
.PP
\f[B]osmium\f[] \f[I]COMMAND\f[] [\f[I]ARG\f[]...]
.PD 0
.P
.PD
\f[B]osmium\f[] \-\-version
.SH DESCRIPTION
.PP
Multipurpose tool for working with OpenStreetMap data.
.PP
Run \f[B]osmium help\f[] \f[I]COMMAND\f[] to get more information about
a command.
.SH OPTIONS
.TP
.B \-h, \-\-help
Show usage and list of commands.
.RS
.RE
.TP
.B \-\-version
Show program version.
.RS
.RE
.SH COMMANDS
.TP
.B add\-locations\-to\-ways
add node locations to ways in OSM file
.RS
.RE
.TP
.B apply\-changes
apply OSM change file(s) to OSM data file
.RS
.RE
.TP
.B cat
concatenate OSM files and convert to different formats
.RS
.RE
.TP
.B changeset\-filter
filter changesets from OSM changeset files
.RS
.RE
.TP
.B check\-refs
check referential integrity of OSM file
.RS
.RE
.TP
.B derive\-changes
create OSM change file from two OSM files
.RS
.RE
.TP
.B diff
display differences between OSM files
.RS
.RE
.TP
.B extract
create geographical extracts from an OSM file
.RS
.RE
.TP
.B fileinfo
show information about an OSM file
.RS
.RE
.TP
.B getid
get objects from OSM file by ID
.RS
.RE
.TP
.B help
show help about commands
.RS
.RE
.TP
.B merge
merge several OSM files into one
.RS
.RE
.TP
.B merge\-changes
merge several OSM change files into one
.RS
.RE
.TP
.B renumber
renumber object IDs
.RS
.RE
.TP
.B show
show OSM file
.RS
.RE
.TP
.B sort
sort OSM files
.RS
.RE
.TP
.B time\-filter
filter OSM data by time from a history file
.RS
.RE
.SH COMMON OPTIONS
.PP
Most commands support the following options:
.TP
.B \-h, \-\-help
Show short usage information.
.RS
.RE
.TP
.B \-v, \-\-verbose
Set verbose mode.
The program will output information about what it is doing to
\f[I]stderr\f[].
.RS
.RE
.SH MEMORY USAGE
.PP
Osmium commands try to do their work as memory efficient as possible.
But some osmium commands still need to load quite a bit of data into
main memory.
In some cases this means that only smaller datasets can be handled.
Look into the man pages for the individual commands to learn more about
their memory use.
.PP
If you use the \f[B]\-v\f[], \f[B]\-\-verbose\f[] option on most
commands they will print out their peak memory usage at the end.
This is the actual amount of memory used including the program code
itself, any needed libraries and the data.
(Printing of memory usage is currently only available on Linux systems.)
.PP
If an osmium command exits with an "Out of memory" error, try running it
with \f[B]\-\-verbose\f[] on smaller datasets to get an idea how much
memory it needs.
.SH SEE ALSO
.IP \[bu] 2
\f[B]osmium\-add\-locations\-to\-ways\f[](1),
\f[B]osmium\-apply\-changes\f[](1), \f[B]osmium\-cat\f[](1),
\f[B]osmium\-changeset\-filter\f[](1), \f[B]osmium\-check\-refs\f[](1),
\f[B]osmium\-derive\-changes\f[](1), \f[B]osmium\-diff\f[](1),
\f[B]osmium\-extract\f[](1), \f[B]osmium\-fileinfo\f[](1),
\f[B]osmium\-getid\f[](1), \f[B]osmium\-merge\f[](1),
\f[B]osmium\-merge\-changes\f[](1), \f[B]osmium\-renumber\f[](1),
\f[B]osmium\-show\f[](1), \f[B]osmium\-sort\f[](1),
\f[B]osmium\-time\-filter\f[](1), \f[B]osmium\-file\-formats\f[](5)
.IP \[bu] 2
Osmium website (http://osmcode.org/osmium-tool/)
.SH COPYRIGHT
.PP
Copyright (C) 2013\-2017 Jochen Topf <jochen@topf.org>.

License GPLv3+: GNU GPL version 3 or later
<https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH CONTACT
.PP
If you have any questions or want to report a bug, please go to
http://osmcode.org/contact.html
.SH AUTHORS
Jochen Topf <jochen@topf.org>.