DOC: DataFrame.get_value
State: closed

Basic examples for working with DataFrame's ``get_value`` method. I do not understand how the ``takeable`` option is supposed to work. If someone can explain it to me, I'd be happy to add an example for that as well.

Labels:
name: Docs

Comments:
# [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/15455?src=pr&el=h1) Report
> Merging [#15455](https://codecov.io/gh/pandas-dev/pandas/pull/15455?src=pr&el=desc) into [master](https://codecov.io/gh/pandas-dev/pandas/commit/be4a63fe791e27c2f8a9ae4f3a419ccc255c1b5b?src=pr&el=desc) will **decrease** coverage by `-0.01%`.
> The diff coverage is `n/a`.


```diff
@@            Coverage Diff             @@
##           master   #15455      +/-   ##
==========================================
- Coverage   90.37%   90.37%   -0.01%     
==========================================
  Files         135      135              
  Lines       49464    49473       +9     
==========================================
+ Hits        44702    44709       +7     
- Misses       4762     4764       +2
```


| [Impacted Files](https://codecov.io/gh/pandas-dev/pandas/pull/15455?src=pr&el=tree) | Coverage Δ | |
|---|---|---|
| [pandas/core/frame.py](https://codecov.io/gh/pandas-dev/pandas/compare/be4a63fe791e27c2f8a9ae4f3a419ccc255c1b5b...7161f68fb56a3b470cdca6fd6d3949833fe495cc?src=pr&el=tree#diff-cGFuZGFzL2NvcmUvZnJhbWUucHk=) | `97.82% <ø> (ø)` | :white_check_mark: |
| [pandas/indexes/multi.py](https://codecov.io/gh/pandas-dev/pandas/compare/be4a63fe791e27c2f8a9ae4f3a419ccc255c1b5b...7161f68fb56a3b470cdca6fd6d3949833fe495cc?src=pr&el=tree#diff-cGFuZGFzL2luZGV4ZXMvbXVsdGkucHk=) | `96.65% <ø> (-0.09%)` | :x: |
| [pandas/core/generic.py](https://codecov.io/gh/pandas-dev/pandas/compare/be4a63fe791e27c2f8a9ae4f3a419ccc255c1b5b...7161f68fb56a3b470cdca6fd6d3949833fe495cc?src=pr&el=tree#diff-cGFuZGFzL2NvcmUvZ2VuZXJpYy5weQ==) | `96.29% <ø> (-0.05%)` | :x: |
| [pandas/indexes/base.py](https://codecov.io/gh/pandas-dev/pandas/compare/be4a63fe791e27c2f8a9ae4f3a419ccc255c1b5b...7161f68fb56a3b470cdca6fd6d3949833fe495cc?src=pr&el=tree#diff-cGFuZGFzL2luZGV4ZXMvYmFzZS5weQ==) | `96.24% <ø> (ø)` | :white_check_mark: |
| [pandas/core/indexing.py](https://codecov.io/gh/pandas-dev/pandas/compare/be4a63fe791e27c2f8a9ae4f3a419ccc255c1b5b...7161f68fb56a3b470cdca6fd6d3949833fe495cc?src=pr&el=tree#diff-cGFuZGFzL2NvcmUvaW5kZXhpbmcucHk=) | `94.21% <ø> (+0.01%)` | :white_check_mark: |

------

[Continue to review full report at Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/15455?src=pr&el=continue).
> **Legend** - [Click here to learn more](https://docs.codecov.io/docs/codecov-delta)
> `Δ = absolute <relative> (impact)`, `ø = not affected`, `? = missing data`
> Powered by [Codecov](https://codecov.io/gh/pandas-dev/pandas/pull/15455?src=pr&el=footer). Last update [be4a63f...7161f68](https://codecov.io/gh/pandas-dev/pandas/compare/be4a63fe791e27c2f8a9ae4f3a419ccc255c1b5b...7161f68fb56a3b470cdca6fd6d3949833fe495cc?el=footer&src=pr&el=lastupdated). Read the [comment docs](https://docs.codecov.io/docs/pull-request-comments).
see #15269 ``takeable`` is an internal parameter (you can mark it this way). This method is slated for deprecation.
Thanks @jreback. I've just pushed an addition to the docstring that mirrors your language. Since it's an internal option that will be deprecated, I'm guessing we don't need an example that shows its use.

Let me know what else I can do to prepare this for a merge. 
@palewire maybe I wasn't clear. This entire function is to be deprecated. But at the moment its not, so simply label it as *internal*
Ah. Now I understand. What alternative method would you recommend as the best replacement? I could also refer readers there. 
@palewire this PR is about documentation, but NOT deprecation (that's the other issue).

``df.get_values(row, col)`` -> ``df.at[row, col]`` or ``df.iat[row, col]``

this is simply a functioal version of ``.at`` (or with the ``tableable``is ``.iat``


@jreback Alrighty. Thanks for clearing that up. I've just pushed some edits that clearly limit this as an internal method slated for deprecation. I've also appended a note that offers the recommended alternatives. 
can you update Series.get_value, set_value and DataFrame.set_value 
can you update
can you update
can you update
closing as stale