| plot.map {sdam} | R Documentation |
Plot cartographical maps
Description
A function to plot cartographical maps of the Roman world and Mediterranean region.
Usage
## S3 method for class 'map'
plot(x = NULL, type = c("plain", "rp", "si", "tetra", "med"), settl, roads, shipr,
main, cap, date, name, fsize, fcol, fsize2, fcol2, xd, yd, new, ...)
Arguments
x |
acronym of ancient Roman province or Italian region (see " |
type |
Type of cartographical map:
|
settl |
display settlements? (optional and logical, for cartographical map) |
roads |
display terrestrial routes? (optional and logical, for cartographical map) |
shipr |
display shipping routes? (optional and logical, for cartographical map) |
main |
plot's main title (optional) |
cap |
display caption? (optional and logical, for provinces) |
date |
display date? (optional and logical, for provinces) |
name |
display map title name? (optional and logical, for provinces) |
fsize |
font size in main title (optional) |
fcol |
font color in main title (optional) |
fsize2 |
font size in date (optional) |
fcol2 |
font color in date (optional) |
xd |
x positioning for the date (optional) |
yd |
y positioning for the date (optional) |
new |
whether the plotted map has superimposed graphics (optional) |
... |
additional optional parameters |
Details
This plot function is for creating cartographical maps of ancient provinces and Italian regions of the Roman Empire around the year AD 117.
The input data x can be a character vector, but this is intended for a recording output.
By default, the argument's name and cap are set to TRUE while the date is set to FALSE;
however, the argument main prevails over name.
The type argument allows plotting cartographical maps related to the Roman Empire and the Mediterranean basin
as specified in rpmp and rpmcd datasets.
In the cartographical maps, settlements are displayed as circles while squares are for military forts, while terrestrial and maritime routes are given as solid paths with different colours.
Shapes of places and routes are specified in the retn dataset.
Dataset retn is a list of lists with specifications to plot different cartographical maps of the Roman Empire and
the Mediterranean with transport network including settlements, roads, and shipping routes.
This list of lists object has the shape data in different slots for 4 cartographical maps of the Roman Empire
with names rcoast for a plain map, rpcoast for a map with provinces, rpsi for a map
with senatorial and imperial provinces, and rptetra for a tetrarchy map.
These options for cartographical maps in the Mediterranean are for both the classical and the late antiquity periods.
Three components in retn dataset have coordinates for settlements nds, roads rds, and shipping
routes srs for these maps.
In addition, the dataset has a cartographical map of the Mediterranean in med where settlements
and transport network is yet to complete.
Dataset rpmp is a list with specifications to plot cartographical maps of ancient Roman provinces and Italian regions.
This list of lists object has 59 Roman provinces and Italian regions in year 117AD, and where names(rpmp) gives the
province acronyms according to rp dataset.
Each province in rpmp has a two-length list with the province name and the shape data for a cartographical map in
different slots.
Value
A plot of a cartographical map for the Roman world with a title name, and a caption with an approximate province establishment date.
Warning
rpmp and retn are built-in datasets in the development and legacy version of the package but,
because of its size, are not part of the CRAN distribution, which means that they are downloaded from another repository.
Note
Positions for caption and date are for a PDF output and the rendering may vary for browser displays.
Author(s)
Antonio Rivero Ostoic
References
https://github.com/sdam-au/sdam/tree/master/data
https://github.com/mplex/cedhar/tree/master/pkg/sdam/data
See Also
Examples
# Roman Empire transport network
plot.map(roads=TRUE, shipr=TRUE)
# Roman province of Aegyptus
plot.map(x="Aeg")