Faq

The BDC grids can be found in the DC-Explorer (https://data.inpe.br/bdc/explorer) via the layer component by using the “View Information” icon. In the layer information window, you can view the source and download the grids.

https://github.com/brazil-data-cube/code-gallery

The BDC data uses an Albers Equal-Area Conic projection following cartographic standards defined by the Brazilian Institute of Geography and Statistics (IBGE). The official horizontal datum for Brazil is SIRGAS-2000. The BDC grids use the 12° south parallel and the 54° meridian as the origin.

OGC WKT :
PROJCS["unknown",
    GEOGCS["unknown",
        DATUM["Unknown_based_on_GRS80_ellipsoid",
            SPHEROID["GRS 1980",6378137,298.2572221010042,
                AUTHORITY["EPSG","7019"]]],
        PRIMEM["Greenwich",0],
        UNIT["degree",0.0174532925199433]],
    PROJECTION["Albers_Conic_Equal_Area"],
    PARAMETER["standard_parallel_1",-2],
    PARAMETER["standard_parallel_2",-22],
    PARAMETER["latitude_of_center",-12],
    PARAMETER["longitude_of_center",-54],
    PARAMETER["false_easting",5000000],
    PARAMETER["false_northing",10000000],
    UNIT["metre",1,
        AUTHORITY["EPSG","9001"]]]
 
PROJ.4 : '+proj=aea +lat_1=-2 +lat_2=-22 +lat_0=-12 +lon_0=-54 +x_0=5000000 +y_0=10000000 +ellps=GRS80 +units=m +no_defs '

To access TerraCollect, click here: https://data.inpe.br/bdc/terracollect

Use the function: sits_list_collections(“BDC”).

SITS uses the BDC token to access images provided by the project through the data catalog.

Use the function:

Sys.setenv("BDC_ACCESS_KEY" = "TOKEN-BDC")

replacing the “TOKEN-BDC” part with your access token.

Additional step: To prevent the token from disappearing in each new R session, insert this function into a file named .Rprofile. To open this file, use the function usethis::edit_r_profile("user"), as illustrated below.

Note: You must have the usethis package installed to run the usethis::edit_r_profile("user") function. If you don’t have it, use the function install.packages("usethis") to install it.

Restart RStudio to save the changes, as shown in the figure below:

To add the new BDC cubes to the SITS package, follow the steps below:

Step 1: Create a new “Text File”

Step 2: Copy and paste the information from this link into the newly created file, as shown below.

Step 3: Save the file with the name config_sits.yaml in a directory of your choice.

Step 4: Use the function usethis::edit_r_profile(“user”) to open the .Rprofile file:

Step 5: If the function Sys.setenv(“BDC_ACCESS_KEY” = “TOKEN-BDC”) already exists in the .Rprofile file, as illustrated in the figure above, insert the following line:

Sys.setenv("BDC_ACCESS_KEY" = "TOKEN-BDC",

                       "SITS_CONFIG_USER_FILE" = "path/to/file/config_sits.yaml")

Replace the text “path/to/file/config_sits.yaml” with the directory path where the configuration file is saved.

If the .Rprofile file is empty, add the same command presented above:

Sys.setenv("BDC_ACCESS_KEY" = "TOKEN-BDC",

                       "SITS_CONFIG_USER_FILE" = "path/to/file/config_sits.yaml")

Replace the “TOKEN-BDC” part with your access token and the “path/to/file/config_sits.yaml” part with the path where the configuration file is located.

Step 6: To check if the configurations were successfully applied, restart the RStudio session:

and load the SITS package using the command library(“sits”).

If the following message appears: “Additional configurations found in path/to/file/config_sits.yaml“  the configuration was successfully applied.

You can now view the two added cubes using the function: sits_list_collections("BDC"):

Possible Errors:

Nonexistent Path: If the path specified in Step 5 does not exist, the following message will appear: “library: invalid configuration file informed in SITS_CONFIG_USER_FILE (file does not exist: …).” Verify that the path is correct and that the configuration file exists in that location.

Malformed Configuration File: If the following warning message appears: “Warning message: In readLines(con, warn = readLines.warn) : incomplete final line found on …” Add an extra blank line at the end of the configuration file to fix this issue, as shown in the figure below.

Images from data cubes can be downloaded using SITS with the function sits_copy().

To obtain an access token for the Brazil Data Cube, you need an account on the BDC Authentication system, the project’s authentication and authorization system (https://brazildatacube.dpi.inpe.br/auth-app/). Once logged in to the authentication and authorization system, navigate to the ‘Personal Access Token’ tab. There, you can view your tokens, as well as create new ones and delete existing ones.

Click here to learn more

Use the following article:

Ferreira, K.R.; Queiroz, G.R.; Vinhas, L.; Marujo, R.F.B.; Simoes, R.E.O.; Picoli, M.C.A.; Camara, G.; Cartaxo, R.; Gomes, V.C.F.; Santos, L.A.; Sanchez, A.H.; Arcanjo, J.S.; Fronza, J.G.; Noronha, C.A.; Costa, R.W.; Zaglia, M.C.; Zioti, F.; Korting, T.S.; Soares, A.R.; Chaves, M.E.D.; Fonseca, L.M.G. Earth Observation Data Cubes for Brazil: Requirements, Methodology and Products. Remote Sens. 2020, 12, 4033. https://doi.org/10.3390/rs12244033

In addition to the published articles, we also maintain a dynamic page containing information about the Brazil Data Cube and its products: https://brazil-data-cube.github.io/

https://discord.gg/TqaMJSBtUs