Skip to contents

Provides Brunei GIS data in the form of a sf (simple features) object ready for plotting and analysis in R. The smallest (areal) unit of analysis is a “kampong” (although not all areas are actual kampongs), which in turn is contained within mukims and districts.

Installation

Install the released version of bruneimap from CRAN with:

install.packages("bruneimap")

Or, if preferred, you may install the development version from GitHub using:

# install.packages("pak")
pak::pkg_install("bruneiverse/bruneimap")

Features

There are three sf files contained in the package:

  1. dis_sf (District level boundaries)
  2. mkm_sf (Mukim level boundaries)
  3. kpg_sf (“Kampong” level boundaries)

Most likely you will want to use either the kampong level or mukim level data.

Data

# Load libraries
library(tidyverse)
theme_set(theme_bw())
library(bruneimap)
library(sf)

# What's in our data set?
glimpse(kpg_sf)
#> Rows: 438
#> Columns: 9
#> $ id        <dbl> 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 1…
#> $ kampong   <chr> "Kg. Biang", "Kg. Amo", "Kg. Sibut", "Kg. Sumbiling Baru", "…
#> $ mukim     <chr> "Mukim Amo", "Mukim Amo", "Mukim Amo", "Mukim Amo", "Mukim A…
#> $ district  <chr> "Temburong", "Temburong", "Temburong", "Temburong", "Temburo…
#> $ geometry  <POLYGON [°]> POLYGON ((115.1546 4.66665,..., POLYGON ((115.1626 4…
#> $ X         <dbl> 115.1244, 115.1512, 115.1080, 115.1071, 115.1600, 115.1247, …
#> $ Y         <dbl> 4.666180, 4.631506, 4.611763, 4.597677, 4.574173, 4.587969, …
#> $ perimeter [m] 21056.211 [m], 38683.611 [m], 16291.051 [m], 12994.328 [m], 33…
#> $ area      [m^2] 19281117.5 [m^2], 52037879.4 [m^2], 7597654.2 [m^2], 6652565…

Plots

ggplot(kpg_sf) +
  geom_sf(aes(fill = mukim), col = "gray50", alpha = 0.8) +
  geom_sf(data = mkm_sf, col = "black", lwd = 0.5, fill = NA) +
  geom_sf(data = dplyr::filter(kpg_sf, is.na(mukim)), fill = "gray70", col = "gray70") +
  ggrepel::geom_label_repel(
    data = mutate(mkm_sf, mukim = gsub("Mukim ", "", mukim)),    
    aes(label = mukim, geometry = geometry),
    size = 2,
    alpha = 0.9,
    stat = "sf_coordinates",
    box.padding = 0.3,
    max.overlaps = Inf,
    min.segment.length = 0,       
    segment.size = 0.3,           
    segment.curvature = 0.1,      
    force = 5                     
  ) +
  scale_fill_viridis_d(option = "mako") +
  labs(x = NULL, y = NULL, title = "Mukims in Brunei") +
  theme_bw() +
  theme(legend.position = "none") 

Citation

To cite package bruneimap in publications use:

Jamil, H (2024). bruneimap: Maps and Spatial Data of Brunei (R package version 0.3.1.9001). https://bruneiverse.github.io/bruneimap/.

A BibTeX entry for LaTeX users is:

@Manual{,
    title = {bruneimap: {M}aps and {S}patial {D}ata of {B}runei ({R} package version 0.3.1.9001)},
    author = {Haziq Jamil},
    year = {2024},
    url = {https://bruneiverse.github.io/bruneimap/},
  }

Data Sources

The GIS data included in this package is sourced sourced from Nadi.BN, licensed under CC BY 4.0. Earlier versions of this package used GIS data obtained from the Survey Department, Ministry of Development, Brunei Darussalam. While this data formed the initial basis of the package, it has since been replaced with data from Nadi.BN to align with current licensing and usage terms.

Special thanks to the creator of the thewheat/brunei_map GitHub repository for their contributions, as well as the neat web app that inspired this work.

License

The bruneimap package is licensed under the GPL-3.

bruneimap: Maps and Spatial Data of Brunei
Copyright (C) 2024- Haziq Jamil

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

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.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

By using this package, you agree to comply with both licenses: the GPL-3 license for the software and the CC BY 4.0 license for the data.

Disclaimer

The data included in this package is provided “as is” and for research and visualisation purposes only. The package author(s) make no guarantees regarding the accuracy, completeness, or reliability of the data. Users are advised to consult authoritative sources for up-to-date information. The author(s) of this package are not affiliated with Nadi.BN or any Brunei government entity.

Contributors

All contributions to this project are gratefully acknowledged using the {allcontributors} package following the all-contributors specification. Contributions of any kind are welcome!


haziqj

nrirdnbtrsy

alvinbjl

Angela-29

SyafYus

Dwaaz

HafeezulRaziq

ANajwa-20

nswaaan

MrJaZzi

Syfii