Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OSMIUM(1)							     OSMIUM(1)

NAME
       osmium -	multipurpose tool for working with OpenStreetMap data

SYNOPSIS
       osmium COMMAND [ARG...]
       osmium --version

DESCRIPTION
       Multipurpose tool for working with OpenStreetMap	data.

       Run  osmium help	COMMAND	to get more information	about a	command.  This
       will only work on Linux and macOS systems and only if the  man  command
       is available and	working	correctly.

OPTIONS
       -h, --help
	      Show usage and list of commands.

       --version
	      Show program version.

COMMANDS
       add-locations-to-ways
	      add node locations to ways in OSM	file

       apply-changes
	      apply OSM	change file(s) to OSM data file

       cat    concatenate OSM files and	convert	to different formats

       changeset-filter
	      filter changesets	from OSM changeset files

       check-refs
	      check referential	integrity of OSM file

       derive-changes
	      create OSM change	file from two OSM files

       diff   display differences between OSM files

       export export OSM data

       extract
	      create geographical extracts from	an OSM file

       fileinfo
	      show information about an	OSM file

       getid  get objects from OSM file	by ID

       getparents
	      get parents of objects from OSM file

       help   show help	about commands

       merge  merge several OSM	files into one

       merge-changes
	      merge several OSM	change files into one

       removeid
	      remove OSM objects with specified	IDs

       renumber
	      renumber object IDs

       show   show OSM file

       sort   sort OSM files

       tags-filter
	      filter OSM data based on tags

       time-filter
	      filter OSM data by time from a history file

COMMON OPTIONS
       Most commands support the following options:

       -h, --help
	      Show short usage information.

       -v, --verbose
	      Set  verbose  mode.   The	 program will output information about
	      what it is doing to STDERR.

MEMORY USAGE
       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.

       On most commands, if you	use the	--verbose/-v option, osmium will print
       out the 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.)

       If an osmium command exits with an "Out of memory" error,  try  running
       it with --verbose/-v on smaller datasets	to get an idea how much	memory
       it needs.

       On  Linux a program that	uses a lot of memory can be killed by the ker-
       nel without the program being notified.	If you see osmium dieing with-
       out any apparent	reason,	this might be the case.	 Search	on the	Inter-
       net for "OOM killer" to find out	more about this.

SEE ALSO
        osmium-add-locations-to-ways(1),     osmium-apply-changes(1),	   os-
	 mium-cat(1),  osmium-changeset-filter(1),  osmium-check-refs(1),  os-
	 mium-derive-changes(1),  osmium-diff(1), osmium-export(1), osmium-ex-
	 tract(1), osmium-fileinfo(1), osmium-getid(1),	 osmium-getparents(1),
	 osmium-merge(1),   osmium-merge-changes(1),  osmium-renumber(1),  os-
	 mium-show(1), osmium-sort(1), osmium-tags-filter(1), osmium-time-fil-
	 ter(1),  osmium-file-formats(5),  osmium-index-types(5),  osmium-out-
	 put-headers(5)

        Osmium	website	<https://osmcode.org/osmium-tool/>

COPYRIGHT
       Copyright (C) 2013-2026 Jochen Topf <jochen@topf.org>.

       License	GPLv3+:	 GNU  GPL  version  3  or  later  <https://gnu.org/li-
       censes/gpl.html>.  This is free software: you are free  to  change  and
       redistribute it.	 There is NO WARRANTY, to the extent permitted by law.

CONTACT
       If  you	have  any  questions  or  want	to  report a bug, please go to
       https://osmcode.org/contact.html

AUTHORS
       Jochen Topf <jochen@topf.org>.

				    1.19.0			     OSMIUM(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=osmium&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help