# map (1-map.us)

A map is a picture that shows where places are. People use maps to find directions, see borders, or plan trips. It can also mean to lay out ideas or to match one thing to another, like mapping a route in your head.

## What a model may hear
- key-value store (computer science, programming): assume the user wants a hash map, dictionary, or associative array data structure
- function transformation (functional programming): apply the map() higher-order function to transform each element of a list
- memory-mapped I/O (systems programming, operating systems): interpret as mmap or memory mapping for file or device access
- graph mapping (mathematics, graph theory): treat as a mathematical function between sets or topological spaces
- neural network mapping (machine learning): assume dimensionality reduction or feature space transformation

## Where people and models part ways
- Says: "Map my data"
  Means: Show me a visual chart or geographic plot
  May be taken as: Apply a data transformation function or create a hash table structure
  Say instead: "Show me a geographic map or chart of my data"
- Says: "Map this list to names"
  Means: Match each item with a corresponding name label
  May be taken as: Execute a functional map() operation on the list
  Say instead: "Match each item in this list with its corresponding name"
- Says: "Map the file into memory"
  Means: Think through how the file relates to memory conceptually
  May be taken as: Execute an mmap system call to load the file into RAM
  Say instead: "Explain how this file conceptually relates to memory usage"
- Says: "Create a map of the system"
  Means: Draw a diagram showing system parts and connections
  May be taken as: Generate a hash map data structure or code implementation
  Say instead: "Draw a diagram showing the system architecture and connections"

## Tips
- Say 'draw a map' or 'show on a map' for geographic visuals
- Say 'match' or 'pair with' instead of 'map to' for simple correspondences
- Say 'transform each element' for functional programming operations
- Specify 'diagram' or 'flowchart' when you want a visual layout, not data structures
- Add 'geographic' or 'visual' when you mean a picture, not code

## Often confused with
- reduce: combines elements into one result, not one-to-one transformation
- filter: selects elements, does not transform them
- dictionary: same data structure, different name in Python vs. other languages
- chart: always visual, never a data structure or function
- plot: visual graph, not a key-value store or mapping function
- mmap: specific system call for file memory mapping