Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

Public Release
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation


mapsize

Standard View | TOC | Home

Compute size or scale of map

Description
Categories
Groups
Examples
History


Description

This application outputs the size of a map in inches given the scale (e.g., 1:1000000) or given the size in inches outputs the scale. Also, the size of an output cube, number of samples and lines, will be computed. This can be used prior to running programs such as map2map or cam2map to ensure the output image is not too large. The mapping parameters used to calculate the information above are also output.

Categories


Related Applications to Previous Versions of ISIS

This program replaces the following application existing in previous versions of ISIS:

Parameter Groups

Files

Name Description
MAP Label file containing a valid Mapping group
TO Text file output

Map Definition

Name Description
OPTIONDefine map size using scale or paper size
SCALE The scale of the map
WIDTH Width of the paper in inches
HEIGHT Height of the paper in inches

Files: MAP

Description

This file must contain a valid mapping group. It can come from the labels of a cube, a hand-generated mapping group, or from the program "mapinit".

Type filename
File Mode input
Filter *.map *.cub

Files: TO

Description

This file will contain the size and scale of the map in a standard label format.

Type filename
File Mode output
Internal Default None
Filter *.txt

Map Definition: OPTION

Description

This parameter is used to indicate if the user will define the map size with either the map scale or the size of the paper in inches.

Type string
Default SCALE
Option List:
Option Brief Description
SCALEDefine map scale and output paper size Use this option to indicate you will be defining the map scale and the program will compute the paper size.

Exclusions

  • WIDTH
  • HEIGHT

Inclusions

  • SCALE
PAPERDefine paper size and output map scale Use this option to indicate you will be defining the paper map size and the program will compute the map scale.

Exclusions

  • SCALE

Inclusions

  • WIDTH
  • HEIGHT

Map Definition: SCALE

Description

Map scales are a unitless representation of how many times the body was was reduced to fit on the piece of paper (map). Thus a 1:10000 implies that reduction was by 10000. It also implies that 1 inch on the map = 10000 inches on the body. Because the scale is unitless, 1 foot on the map would be 10000 feet on the body. When entering the value for scale only enter the portion after the colon as one is always assumed (i.e., SCALE=10000 implies 1:10000).

Type double

Map Definition: WIDTH

Description

This defines the maximum width of your map in inches. Note that the results of the computation will likely reduce one of width or height in order to preserve the aspect ratio of the map.

Type double

Map Definition: HEIGHT

Description

This defines the maximum height of your map in inches. Note that the results of the computation will likely reduce one of width or height in order to preserve the aspect ratio of the map.

Type double
Exclusions
  • SCALE
Inclusions
  • WIDTH

Examples


Example 1

Define scale, compute paper size

Description

In this example, the user selects the SCALE option, defining a 1:1000 map scale, and the application computes the corresponding paper size.

Command Line

mapsize from=I00824006RDR.lev2.cub option=scale scale=1000
Specify the scale option for emphasis even though it is the default

Data Files


            Input Cube Label
            
Object = IsisCube
  Object = Core
    StartByte   = 65537
    Format      = Tile
    TileSamples = 128
    TileLines   = 128

    Group = Dimensions
      Samples = 82
      Lines   = 362
      Bands   = 10
    End_Group

    Group = Pixels
      Type       = Real
      ByteOrder  = Lsb
      Base       = 0.0
      Multiplier = 1.0
    End_Group
  End_Object

  Group = Instrument
    SpacecraftName        = MARS_ODYSSEY
    InstrumentId          = THEMIS_IR
    TargetName            = MARS
    MissionPhaseName      = MAPPING
    StartTime             = 2002-02-20T11:00:50.525
    StopTime              = 2002-02-20T11:02:50.525
    SpacecraftClockCount  = 698670100.051
    GainNumber            = 16
    OffsetNumber          = 0
    MissingScanLines      = 0
    TimeDelayIntegration  = ENABLED
    SpacecraftClockOffset = 0.0 <seconds>
  End_Group

  Group = BandBin
    OriginalBand = (1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
    Center       = (6.78, 6.78, 7.93, 8.56, 9.35, 10.21, 11.04, 11.79, 12.57,
                    14.88)
    Width        = (1.01, 1.01, 1.09, 1.16, 1.20, 1.10, 1.19, 1.07, 0.81,
                    0.87)
    FilterNumber = (1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
  End_Group

  Group = Archive
    DataSetId               = ODY-M-THM-3-IRRDR-V1.0
    ProducerId              = ODY_THM_TEAM
    ProductId               = I00824006RDR
    ProductCreationTime     = 2003-03-12T12:56:59
    ProductVersionId        = 1.4
    ReleaseId               = 0002
    OrbitNumber             = 00824
    FlightSoftwareVersionId = 1.00
    CommandSequenceNumber   = 824
    Description             = "Sinus Meridiani (west side)"
  End_Group

  Group = Kernels
    NaifFrameCode       = -53031
    LeapSecond          = $base/kernels/lsk/naif0008.tls
    TargetAttitudeShape = $base/kernels/pck/pck00008.tpc
    TargetPosition      = $base/kernels/spk/de405.bsp
    SpacecraftPointing  = $Odyssey/kernels/ck/m01_sc_map1_v2.bc
    Instrument          = Null
    SpacecraftClock     = $odyssey/kernels/sclk/ORB1_SCLKSCET.00113.tsc
    SpacecraftPosition  = $odyssey/kernels/spk/m01_map1_v2.bsp
    Frame               = $odyssey/kernels/fk/m01_v26.tf
    InstrumentAddendum  = $odyssey/kernels/iak/themisAddendum001.ti
    ElevationModel      = $base/dems/molaMarsPlanetaryRadius0001.cub
  End_Group

  Group = Mapping
    ProjectionName         = Sinusoidal
    LatitudeType           = Planetocentric
    LongitudeDirection     = PositiveEast
    LongitudeDomain        = 360
    CenterLongitude        = 353.0
    TargetName             = MARS
    EquatorialRadius       = 3396190.0 <meters>
    PolarRadius            = 3376200.0 <meters>
    MinimumLatitude        = -4.8337546206235
    MaximumLatitude        = 1.254149686355
    MinimumLongitude       = 351.45064252629
    MaximumLongitude       = 352.82816449976
    PixelResolution        = 1000.0 <meters/pixel>
    Scale                  = 59.274697523306 <pixels/degree>
    TrueScaleLatitude      = 0.0
    UpperLeftCornerX       = -92000.0 <meters>
    UpperLeftCornerY       = 75000.0 <meters>
    LineProjectionOffset   = -74.5
    SampleProjectionOffset = -91.5
  End_Group

  Group = AlphaCube
    AlphaSamples        = 320
    AlphaLines          = 3600
    AlphaStartingSample = 0.5
    AlphaStartingLine   = 0.5
    AlphaEndingSample   = 320.5
    AlphaEndingLine     = 3600.5
    BetaSamples         = 320
    BetaLines           = 3600
  End_Group
End_Object

Object = Label
  Bytes = 65536
End_Object

Object = History
  Name      = IsisCube
  StartByte = 2031617
  Bytes     = 1105
End_Object
End
            
Output Label
Group = Results
  Map              = I00824006RDR.lev2.cub
  Scale            = 1000.0
  Width            = 3216.0732591105 <inches>
  Height           = 14207.006481481 <inches>
  Samples          = 82
  Lines            = 362
  RealSize         = 115.953125 <KB>
  SignedWordSize   = 57.9765625 <KB>
  UnsignedByteSize = 28.98828125 <KB>
End_Group

Group = Mapping
  ProjectionName         = Sinusoidal
  LatitudeType           = Planetocentric
  LongitudeDirection     = PositiveEast
  LongitudeDomain        = 360
  CenterLongitude        = 353.0
  TargetName             = MARS
  EquatorialRadius       = 3396190.0 <meters>
  PolarRadius            = 3376200.0 <meters>
  MinimumLatitude        = -4.8337546206235
  MaximumLatitude        = 1.254149686355
  MinimumLongitude       = 351.45064252629
  MaximumLongitude       = 352.82816449976
  PixelResolution        = 1000.0 <meters/pixel>
  Scale                  = 59.274697523306 <pixels/degree>
  TrueScaleLatitude      = 0.0
  UpperLeftCornerX       = -92000.0 <meters>
  UpperLeftCornerY       = 75000.0 <meters>
  LineProjectionOffset   = -74.5
  SampleProjectionOffset = -91.5
End_Group
            

Example 2

Define paper size, compute scale

Description

In this example, the user selects the PAPER option, defining a 38x100 paper size, and the application computes the corresponding scale. Notice that the resulting PVL is identical to that of the previous example with the exception of the Scale, Height, and Width keywords.

Command Line

mapsize from=I00824006RDR.lev2.cub option=paper width=38 height=100
Specify the paper option and provide the width and height

Data Files


            Input Cube Label
            
Object = IsisCube
  Object = Core
    StartByte   = 65537
    Format      = Tile
    TileSamples = 128
    TileLines   = 128

    Group = Dimensions
      Samples = 82
      Lines   = 362
      Bands   = 10
    End_Group

    Group = Pixels
      Type       = Real
      ByteOrder  = Lsb
      Base       = 0.0
      Multiplier = 1.0
    End_Group
  End_Object

  Group = Instrument
    SpacecraftName        = MARS_ODYSSEY
    InstrumentId          = THEMIS_IR
    TargetName            = MARS
    MissionPhaseName      = MAPPING
    StartTime             = 2002-02-20T11:00:50.525
    StopTime              = 2002-02-20T11:02:50.525
    SpacecraftClockCount  = 698670100.051
    GainNumber            = 16
    OffsetNumber          = 0
    MissingScanLines      = 0
    TimeDelayIntegration  = ENABLED
    SpacecraftClockOffset = 0.0 <seconds>
  End_Group

  Group = BandBin
    OriginalBand = (1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
    Center       = (6.78, 6.78, 7.93, 8.56, 9.35, 10.21, 11.04, 11.79, 12.57,
                    14.88)
    Width        = (1.01, 1.01, 1.09, 1.16, 1.20, 1.10, 1.19, 1.07, 0.81,
                    0.87)
    FilterNumber = (1, 2, 3, 4, 5, 6, 7, 8, 9, 10)
  End_Group

  Group = Archive
    DataSetId               = ODY-M-THM-3-IRRDR-V1.0
    ProducerId              = ODY_THM_TEAM
    ProductId               = I00824006RDR
    ProductCreationTime     = 2003-03-12T12:56:59
    ProductVersionId        = 1.4
    ReleaseId               = 0002
    OrbitNumber             = 00824
    FlightSoftwareVersionId = 1.00
    CommandSequenceNumber   = 824
    Description             = "Sinus Meridiani (west side)"
  End_Group

  Group = Kernels
    NaifFrameCode       = -53031
    LeapSecond          = $base/kernels/lsk/naif0008.tls
    TargetAttitudeShape = $base/kernels/pck/pck00008.tpc
    TargetPosition      = $base/kernels/spk/de405.bsp
    SpacecraftPointing  = $Odyssey/kernels/ck/m01_sc_map1_v2.bc
    Instrument          = Null
    SpacecraftClock     = $odyssey/kernels/sclk/ORB1_SCLKSCET.00113.tsc
    SpacecraftPosition  = $odyssey/kernels/spk/m01_map1_v2.bsp
    Frame               = $odyssey/kernels/fk/m01_v26.tf
    InstrumentAddendum  = $odyssey/kernels/iak/themisAddendum001.ti
    ElevationModel      = $base/dems/molaMarsPlanetaryRadius0001.cub
  End_Group

  Group = Mapping
    ProjectionName         = Sinusoidal
    LatitudeType           = Planetocentric
    LongitudeDirection     = PositiveEast
    LongitudeDomain        = 360
    CenterLongitude        = 353.0
    TargetName             = MARS
    EquatorialRadius       = 3396190.0 <meters>
    PolarRadius            = 3376200.0 <meters>
    MinimumLatitude        = -4.8337546206235
    MaximumLatitude        = 1.254149686355
    MinimumLongitude       = 351.45064252629
    MaximumLongitude       = 352.82816449976
    PixelResolution        = 1000.0 <meters/pixel>
    Scale                  = 59.274697523306 <pixels/degree>
    TrueScaleLatitude      = 0.0
    UpperLeftCornerX       = -92000.0 <meters>
    UpperLeftCornerY       = 75000.0 <meters>
    LineProjectionOffset   = -74.5
    SampleProjectionOffset = -91.5
  End_Group

  Group = AlphaCube
    AlphaSamples        = 320
    AlphaLines          = 3600
    AlphaStartingSample = 0.5
    AlphaStartingLine   = 0.5
    AlphaEndingSample   = 320.5
    AlphaEndingLine     = 3600.5
    BetaSamples         = 320
    BetaLines           = 3600
  End_Group
End_Object

Object = Label
  Bytes = 65536
End_Object

Object = History
  Name      = IsisCube
  StartByte = 2031617
  Bytes     = 1105
End_Object
End
            
Output Label
Group = Results
  Map              = I00824006RDR.lev2.cub
  Scale            = 142070.06481481
  Width            = 22.63723370087 <inches>
  Height           = 100.0 <inches>
  Samples          = 82
  Lines            = 362
  RealSize         = 115.953125 <KB>
  SignedWordSize   = 57.9765625 <KB>
  UnsignedByteSize = 28.98828125 <KB>
End_Group

Group = Mapping
  ProjectionName         = Sinusoidal
  LatitudeType           = Planetocentric
  LongitudeDirection     = PositiveEast
  LongitudeDomain        = 360
  CenterLongitude        = 353.0
  TargetName             = MARS
  EquatorialRadius       = 3396190.0 <meters>
  PolarRadius            = 3376200.0 <meters>
  MinimumLatitude        = -4.8337546206235
  MaximumLatitude        = 1.254149686355
  MinimumLongitude       = 351.45064252629
  MaximumLongitude       = 352.82816449976
  PixelResolution        = 1000.0 <meters/pixel>
  Scale                  = 59.274697523306 <pixels/degree>
  TrueScaleLatitude      = 0.0
  UpperLeftCornerX       = -92000.0 <meters>
  UpperLeftCornerY       = 75000.0 <meters>
  LineProjectionOffset   = -74.5
  SampleProjectionOffset = -91.5
End_Group
            

History

Kay Edwards1989-03-21 Original version
Jeff Anderson2003-02-20 Converted to Isis 3.0
Jeff Anderson2003-04-03 Fixed compiler warning
Kim Sides2003-05-13 Added application test
Stuart Sides2003-05-16 Modified schema location from astogeology... to isis.astrogeology..."
Jeff Anderson2003-06-02 Fixed problem with application test due to compiler optimization
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Jeff Anderson2003-08-27 Changed default extension handling mechanism
Stuart Sides2003-11-07 Modified to create Results as an object instead of group in the PVL output.
Jeff Anderson2003-11-25 Added units of inches to the output width and height
Brendan George2005-11-09 Added output of map size in Kilobytes
Brendan George2005-11-21 Added application test
Elizabeth Miller2006-05-18 Depricated CubeProjection and ProjectionManager to ProjectionFactory
Stuart Sides2006-09-25 Mofidied to output the mapping group used to calculate the results.
Steven Koechle2007-10-17 Casted file size calculations to a Isis::BigInt to fix an integer overflow problem