ls_instruments: List or Remove instrument objects
In R-Finance/FinancialInstrument: Financial Instrument Model Infrastructure for R

Description Usage Arguments Details Value Author(s) See Also Examples

display the names of or delete instruments, stocks, options, futures, currencies, bonds, funds, spreads, guaranteed_spreads, synthetics, derivatives, or non-derivatives.

  ls_instruments(pattern = NULL, match = TRUE,
    verbose = TRUE)

  ls_stocks(pattern = NULL, match = TRUE)

  ls_options(pattern = NULL, match = TRUE,
    include.series = TRUE)

  ls_option_series(pattern = NULL, match = TRUE)

  ls_futures(pattern = NULL, match = TRUE,
    include.series = TRUE)

  ls_future_series(pattern = NULL, match = TRUE)

  ls_currencies(pattern = NULL, match = TRUE,
    includeFX = FALSE)

  ls_non_currencies(pattern = NULL, match = TRUE,
    includeFX = TRUE)

  ls_exchange_rates(pattern = NULL, match = TRUE)

  ls_FX(pattern = NULL, match = TRUE)

  ls_bonds(pattern = NULL, match = TRUE)

  ls_funds(pattern = NULL, match = TRUE)

  ls_spreads(pattern = NULL, match = TRUE)

  ls_guaranteed_spreads(pattern = NULL, match = TRUE)

  ls_synthetics(pattern = NULL, match = TRUE)

  ls_ICS(pattern = NULL, match = TRUE)

  ls_ICS_roots(pattern = NULL, match = TRUE)

  ls_derivatives(pattern = NULL, match = TRUE)

  ls_non_derivatives(pattern = NULL, match = TRUE)

  ls_calls(pattern = NULL, match = TRUE)

  ls_puts(pattern = NULL, match = TRUE)

  rm_instruments(x, keep.currencies = TRUE)

  rm_stocks(x)

  rm_options(x)

  rm_option_series(x)

  rm_futures(x)

  rm_future_series(x)

  rm_currencies(x)

  rm_exchange_rates(x)

  rm_FX(x)

  rm_bonds(x)

  rm_funds(x)

  rm_spreads(x)

  rm_synthetics(x)

  rm_derivatives(x)

  rm_non_derivatives(x, keep.currencies = TRUE)

`pattern`	an optional regular expression. Only names matching ‘pattern’ are returned.
`match`	return only exact matches?
`verbose`	be verbose?
`include.series`	should future_series or option_series instruments be included.
`x`	what to remove. if not supplied all instruments of relevent class will be removed. For `ls_defined.by` x is the string describing how the instrument was defined.
`keep.currencies`	If TRUE, currencies will not be deleted.
`includeFX`	should exchange_rates be included in ls_non_currencies results

ls functions return the names of all the instruments of the class implied by the function name. rm functions remove the instruments of the class implied by the function name

rm_instruments and rm_non_derivatives will not delete currencies unless the keep.currencies argument is FALSE.

For the rm functions, x can be a vector of instrument names, or nothing. If x is missing, all instruments of the relevant type will be removed.

It can be useful to nest these functions to get things like futures denominated in USD.

ls functions return vector of character strings corresponding to instruments of requested type rm functions are called for side-effect

Garrett See

ls_instruments_by, ls_by_currency, ls_by_expiry, ls, rm, instrument, stock, future, option, currency, FinancialInstrument::sort_ids

## Not run: 
#rm_instruments(keep.currencies=FALSE) #remove everything from .instrument

# First, create some instruments
currency(c("USD", "EUR", "JPY"))
#stocks
stock(c("S", "SE", "SEE", "SPY"), 'USD')
synthetic("SPX", "USD", src=list(src='yahoo', name='^GSPC'))
#derivatives
option('.SPY', 'USD', multiplier=100, underlying_id='SPY')
option_series(root_id="SPY", expires='2011-06-18', callput='put', strike=130)
option_series(root_id="SPY", expires='2011-09-17', callput='put', strike=130)
option_series(root_id="SPY", expires='2011-06-18', callput='call', strike=130)
future('ES', 'USD', multiplier=50, expires='2011-09-16', underlying_id="SPX")
option('.ES','USD',multiplier=1, expires='2011-06',strike=1350, right='C', underlying_id='ES')

# Now, the examples
ls_instruments() #all instruments
ls_instruments("SE") #only the one stock
ls_instruments("S", match=FALSE) #anything with "S" in name

ls_currencies()
ls_stocks()
ls_options()
ls_futures()
ls_derivatives()
ls_puts()
ls_non_derivatives()
#ls_by_expiry('20110618',ls_puts()) #put options that expire on Jun 18th, 2011
#ls_puts(ls_by_expiry('20110618')) #same thing

rm_options('SPY_110618C130')
rm_futures()
ls_instruments()
#rm_instruments('EUR') #Incorrect
rm_instruments('EUR', keep.currencies=FALSE) #remove the currency
rm_currencies('JPY') #or remove currency like this
ls_currencies()
ls_instruments()

rm_instruments() #remove all but currencies
rm_currencies()

option_series.yahoo('DIA')
ls_instruments_by('underlying_id','DIA') #underlying_id must exactly match 'DIA'
ls_derivatives('DIA',match=FALSE) #primary_ids that contain 'DIA'
rm_instruments()

## End(Not run)