code: public static String mapToPtPath(final String aBasePath, final String aID, final String aEncapsulatedName) {
          final String ptPath;
  
          Objects.requireNonNull(aID);
  
          if (aEncapsulatedName == null) {
              ptPath = concat(aBasePath, mapToPtPath(aID));
          } else {
              ptPath = concat(aBasePath, mapToPtPath(aID), encodeID(aEncapsulatedName));
          }
  
          return ptPath;
      }
docs: Maps the supplied ID to a Pairtree path using the supplied base path.
  
  @param aID An ID to map to a Pairtree path
  @param aBasePath The base path to use in the mapping
  @param aEncapsulatedName The name of the encapsulating directory
  @return The Pairtree path for the supplied ID