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 OS/X	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-2023 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.16.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.0>

home | help