For Linux, OS X and Windows. Converts SOSI files to a number of other formats, including shapefile and PostGIS database import files. The parser is still under development.

SOSI is a data format used for exchanging geographical information in Norway. The name is an acronym for "Samordnet Opplegg for Stedfestet Informasjon", which translates into something like "Coordinated Approach for Geospatial Information". Wikipedia has more.

Project home page: sosicon.espenandersen.no.

Contributors are most welcome!

• Swift conversion
• Selectable feature/objtype/field export
• Supports command-line piping
• Written in ANSI C++
• Compiles and runs on OS X, Linux (32 and 64 bit) and Windows

Prebuilt Sosicon binaries are located in the /bin directory of the repo. Choose your OS and put the executable in a location where it can be run from the command line.

• Linux 32-bit executable
• Linux 64-bit executable
• OS X executable
• Windows executable

You can inspect the content of a SOSI file by using the -stat command, like this:

sosicon -stat input.sos

This command will render a list of SOSI elements (geometry types among other things) and SOSI object types (OBJTYPE).

To convert a SOSI file to shape, run Sosicon from the directory where the SOSI file resides. Use the -2shp parameter to emit the three required files: Shape file (shp), database file (dbf) and index file (shx). A projection file (prj) will also be created if the reference grid is recognized by Sosicon.

sosicon -2shp input.sos

On Linux and OS X, batch conversion is supported by piping:

ls *.sos | sosicon -2shp

On Windows, use dir with the /b switch for piping:

dir *.sos /b | sosicon -2shp

The above command will convert every *.sos file in current directory to corresponding shapefiles. The files will be written to the same directory, keeping the file title extended with feature name, geometry type and shp/shx/dbf extensions.

Use the -o parameter to specify optional output file basename:

sosicon -2shp -o ~/myfolder/arealdekke input.sos

Use the -2psql parameter to make a PostGIS import file (SQL script) from a SOSI file. The generated SQL file can be run against any PostgreSQL database with PostGIS installed. Use the psql command-line utility to import the file.

sosicon -2psql input.sos

This command will create a default SQL file named "postgis_dump.sql". When imported to PostgreSQL, the data tables will be put in the schema "sosicon" by default. There will be one table for each recognized geometry in the SOSI file. The tables will be named "object_point", "object_polygon" and "object_linestring".

The "-schema" and "-table" parameters can be used to customize the schema and table base name:

sosicon -2psql -schema topo -table arealdekke input.sos

When imported to PostgreSQL, the tables will be named "arealdekke_point", "arealdekke_polygon" and "arealdekke_linestring". The tables will be put in a schema named "topo".

By default, the SOSI geometries are converted to EPSG:4326 grid when imported to PostgreSQL. Use the "-srid" parameter to specify another target grid, for example Google mercator; SRID 900913:

sosicon -2psql -schema topo -table arealdekke -srid 900913 input.sos

PostGIS takes care of the actual grid conversion when the data is inserted into the table(s). The user must assert that the target srid exists in PostGIS' spatial_ref_sys table.

###Linux/OS X You need g++ to compile Sosicon. To build from source code, check out the git repository, enter the src directory and run make and then make install. There's no configure yet. On 32-bit Linux systems, the binaries will be output to bin/linux32. On 64-bit Linux systems, the binaries will be output to bin/linux64. On OS X, the binaries will be output in bin/osx.

If you run make install after building the source, the executable will be copied to $INSTALL_PATH, or default to /usr/local/bin/sosicon.

###Windows Project files for Visual Studio is included in the repository. Open src/sosicon.sln solution file in Visual Studio (Express) 2013 and build the project from there.

Sosicon is not ready for release, although SHP conversion works reasonably well with some SOSI features.

Documentation exists in html, rtf and pdf formats. See the doc directory within the repository or visit sosicon.espenandersen.no for an online version.

The source code documentation for sosicon is generated by the brilliant Doxygen code documentation tool written by Dimitri van Heesch.

The parser in sosicon is based on the Ragel state machine compiler. The ragel script is located in the src/ragel directory. Ragel binaries for OS X, Linux 32- and 64-bit and Win32 is precompiled and stored in /src/ragel/bin/. The makefile is set up to reference the correct binary when compiling on Linux or OS X.

Ragel was designed and written by Adrian Thurston and released under the GNU General Public License in 2002. Sosicon relies heavily on the excellent work of Thurston and his team of contributors.

Sosicon is written by Espen Andersen, and released under the GNU General Public License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Although the author has attempted to find and correct any bugs in the free software programs, the author is not responsible for any damage or losses of any kind caused by the use or misuse of the programs. The author is under no obligation to provide support, service, corrections, or upgrades to the free software programs.