algorithm.txt

# Copyright (c) 2017, Lawrence Livermore National Security, LLC.
# Produced at the Lawrence Livermore National Laboratory
# Written by Geoff Cleary <gcleary@llnl.gov>
# LLNL-CODE-734258
#
# All rights reserved.
# This file is part of STK Address Converter. For details, see
# https://github.com/LLNL/STKAddressConverter. Licensed under the
# Apache License, Version 2.0 (the “Licensee”); you may not use
# this file except in compliance with the License. You may
# obtain a copy of the License at:
# 
# http://www.apache.org/licenses/LICENSE-2.0
# 
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
# either express or implied. See the License for the specific
# language governing permissions and limitations under the license.

inputs:  library, rail, column, side, row


sanity checks:
     library >= 1
     1 <=  rail  <= 4
    -2 <= column <= 2 and column != 0
     side == 1
     1 <=  row   <= 4


calculate ACSLS LSM
    ( (4 * (library - 1)) + rail ) - 1


calculate ACSLS drive ID
2 dimensional array of ACSLS drive IDs:
    2  1 -1 -2
  +--+--+--+--+
0 |12| 8| 4| 0| 1
  +--+--+--+--+
1 |13| 9| 5| 1| 2
  +--+--+--+--+
2 |14|10| 6| 2| 3
  +--+--+--+--+
3 |15|11| 7| 3| 4
  +--+--+--+--+
    0  1  2  3

we'll use the column and row to index into the above array.

SL8500 row to array row is easy -> subtract 1

SL8500 column to array column:
    multiply by -1
	SL8500 column numbers:  -2 -1  1  2
     array column numbers:   0  1  2  3
    if negative, add 2
    if positive, add 1
	SL8500 column numbers:   0  1  2  3
	 arrau column numbers:   0  1  2  3

index into array using array row,column that we've calcuated to retrieve ACSLS drive ID


outputs:  LSM, drive ID, (return error)